/
Connecter Salesforce à Feedier

Connecter Salesforce à Feedier

Besoins :

  • Compte Salesforce avec accès à Setup App

  • Compte Feedier avec un rôle d'administrateur

  • Un attribut Feedier (sfid,sf_contact_id) qui contient un ID d'objet Salesforce (contact_id, case_id), car il est utilisé pour relier les données de Feedier à Salesforce.

Première étape pour toutes les connexions : Créer une application connectée dans Salesforce

Il est nécessaire de créer une application pour permettre à Feedier d'effectuer des appels API avec votre instance Salesforce en toute sécurité.

Ajouter une nouvelle application connectée

Salesforce's Setup App → Platform Tools → Apps → App Manager → New Connected App

Dans les champs de l'application connectée, définissez les éléments suivants :

Connected App Name

Feedier 

API Name

Feedier

Contact Email 

help@feedier.com (ou votre email)

API (Enable OAuth Settings)
Enable OAuth Settings

TICKED

— Callback URL

Pour Production :
https://dashboard.feedier.com/integration/callback/salesforceObject
https://dashboard.feedier.com/integration/callback/salesforce

https://connect.feedier.com/rest/oauth2-credential/callback

— Selected OAuth Scopes

(api)
(refresh_token,offline_access)
(full)
(lightning)

 

Configuration de l'application Feedier

Collecte de App Client ID et App Client Secret pour la connexion sur Feedier

Après avoir ajouté vos détails, sauvegardez et retournez à l'application, puis cliquez sur Manage Consumer Details pour collecter l'identifiant et le secret du client de l'application. Vous utiliserez ces informations lorsque vous vous connecterez à une action sur Feedier.

Décocher la case Exiger l'extension de la preuve de la clé pour l'échange de code (PKCE) pour les flux d'autorisation pris en charge

Remplacer Utilisateurs autorisés par « All users may self-authorize » et Assouplissement IP par « Relax IP restrictions ».

Flux de travail 1 : Enrichir les données de feedback avec les attributs d'un ou plusieurs objets Salesforce

Étapes de l'intégration

Ajouter un Segment

Tout d'abord, nous devons créer un segment sur Feedier. Les segments sont des recherches sauvegardées qui vous permettent de créer des automatisations basées sur vos feedbacks sélectionnés.

  • Créez un segment qui identifiera tous les feedbacks qui ont besoin d'être enrichis par des données Salesforce. Si vous avez besoin de tous les feedbacks, il vous suffit de définir un filtre avec la période de temps est supérieure au début de l'année.

Connecter le segment à une automatisation

  • Sélectionnez le segment que vous venez de créer.

  • Sélectionnez Salesforce Fields Sync dans la liste déroulante.

App Client ID

Reportez-vous à l'étape 1, vous obtenez ceci à partir du Connected App dans Salesforce.

App Client Secret

Reportez-vous à l'étape 1, vous obtenez ceci à partir du Connected App dans Salesforce.

Salesforce SOQL

Voir la section suivante

Attribute Name

Le nom de l'attribut que nous recevons en retour (par exemple, « sf_id ») est utilisé pour faire correspondre les enregistrements Salesforce. Il peut s'agir d'un ID de compte, d'un ID personnalisé ou d'un ID de contact. Par exemple, si le lien de retour d'information ressemble à ceci :

feedback.feedier.com/survey-url?sf_id=123 nous utiliserons « sf_id » comme nom d'attribut et sa valeur, 123, dans la requête Salesforce pour trouver le bon enregistrement.

En bref, cet attribut (« sf_id ») sera utilisé dans la partie « WHERE » de la requête Salesforce (SOQL)

Pour interroger efficacement les données dans Salesforce à l'aide de SOQL (Salesforce Object Query Language), vous pouvez suivre les étapes ci-dessous. SOQL vous permet d'extraire des données d'objets Salesforce tels que le Contact et Account. Dans cette section, nous vous expliquons comment accéder à la Salesforce Developer Console et créer vos propres requêtes SOQL. Vous pouvez également vous référer à la documentation Salesforce pour la structure : Salesforce Developers

To start writing SOQL queries, you need to access the Salesforce Developer Console. Once open, navigate to the Query Editor to begin writing SOQL queries.

Pour commencer à écrire des requêtes SOQL, vous devez accéder à la Salesforce Developer Console. Une fois ouverte, accédez au Query Editor pour commencer à écrire des requêtes SOQL.

Exemple 1 : Récupération des données de contact

Once in the Query Editor, you can run the following query to retrieve data related to a specific contact:

SELECT Id, FirstName, LastName, Email, Phone, AccountId FROM Contact WHERE Id = 'contact_id'

Cette requête permet de récupérer l'identifiant, le prénom, le nom, l'adresse électronique, le numéro de téléphone et l'identifiant du compte associé au contact. Vous trouverez ci-dessous un exemple de la requête et de ses résultats dans la Developer Console :

 

Exemple 2 : Récupération des données d'un compte

Pour récupérer les détails relatifs à un compte spécifique, utilisez la requête suivante :

SELECT Id, Name, Industry, BillingCity, BillingState, BillingCountry FROM Account WHERE Id = 'Account_id'

Cette requête permet de récupérer l'identifiant, le nom, le secteur d'activité et l'adresse de facturation (ville, état et pays) du compte. Vous trouverez ci-dessous un exemple de cette requête et de son résultat :

Exemple 3 : Récupération des données d'un contact et d'un compte sur la base de l'identifiant du contact

Enfin, vous pouvez interroger les données duContact etAccount associé à l'aide de la requête SOQL suivante :

SELECT Id, FirstName, LastName, Email, Phone, Account.Name, Account.Website FROM Contact WHERE Id = 'contact_id'

Cette requête permet de récupérer les coordonnées du contact ainsi que le nom et le site web du compte associé. Vous trouverez ci-dessous un exemple de cette requête et de son résultat :

Dernière étape : Configuration dynamique des requêtes SOQL

Dans la dernière étape de l'intégration de vos requêtes SOQL dans l'environnement dynamique, vous remplacerez les valeurs d'ID codées en dur utilisées pour les tests dans l'éditeur de requêtes par une configuration dynamique. Cela permet à la requête SOQL de prendre un paramètre à partir du nom d'attribut que vous avez défini dans le champ d'intégration, en veillant à ce qu'il corresponde à l'ID d'objet Salesforce correct.

Par exemple, la requête statique testée dans l'éditeur :

SELECT Id, FirstName, LastName, Email, Phone, AccountId FROM Contact WHERE Id = '001J7000007VpctIAC'

doit être remplacé dans le champ SOQL par :

Dans cette requête dynamique, l'espace réservé {attribute_value} sera automatiquement remplacé par la valeur du nom de l'attribut que vous avez défini dans l'intégration.

Si vous définissez sf_id dans le champ Nom de l'attribut, la requête exécutée deviendra :

Si vous définissez sf_id dans le champ Nom de l'attribut, la requête exécutée deviendra :

Il s'agit de la configuration finale :

Comment tester l'intégration ?

Pour tester l'intégration, vous devez aller dans les enquêtes, choisir une enquête qui correspond au segment que vous avez créé et simuler la réception du feedback avec un ID Salesforce.

Prenez le lien et ajoutez manuellement l'attribut (le nom de l'attribut que vous passez dans l'URL doit correspondre à celui que vous avez mis dans le champ du nom de l'attribut dans votre intégration). Ainsi, si l'URL est : https://feedback.feedier.pre-prod.alkalab.com/123abc

entrer dans votre navigateur :

https://feedback.feedier.pre-prod.alkalab.com/123abc?sf_id=001J7000007VpctIAC

Répondez à l'enquête et vous devriez recevoir un retour d'information avec un attribut, qui est sf_id.

Attendez 5 minutes, et l'intégration devrait être déclenchée, et vous devriez voir tous les attributs que vous avez inclus dans votre SOQL.

  1. Feedier ne lira que le premier enregistrement de la requête. Vous pouvez donc passer commande si plusieurs enregistrements sont susceptibles de correspondre.

  2. La requête doit contenir « {attribute_value} » car cette valeur d'attribut changera toujours et sera remplacée automatiquement. Il peut s'agir d'un identifiant ou d'une valeur pour une requête/appariement LIKE.

Flux de travail 2 : Connexion à Salesforce pour mettre à jour un "Salesforce Object" après le feedback

1. Créer un Custom Object

  • Créez un Custom object appelé FeedierFeedback

Ajoutez l'étiquette FeedierFeedback, le nom de l'objet devrait s'afficher automatiquement.

2.Ajouter le champs et relations à l'objet FeedierFeedback


Allez maintenant dans champs et relations pour l'objet FeedierFeedback et commencez à ajouter les champs personnalisés suivants. Vous devez ajouter tous les éléments suivants :

Nom du champ sur Salesforce

Type de données

Explication

CreatedById

Référence(Utilisateur)

Champ obligatoire dans Salesforce, affiche l'utilisateur qui a configuré le connecteur.

FeedierFeedbackId

texte(80)

Feedback ID sur Feedier

FeedierCreatedAt

Date

Date de création du feedback

FeedierFeedbackName



texte(80)

Nom de l'objet

FeedierSurveyName



texte (100)

Nom de l'enquête dans Feedier

FeedierFeedbackLink

texte (255)

Le lien vers les réponses aux feedback sur Feedier

FeedierNPSScore

Number(18, 0)

La valeur de la réponse à la question du NPS

FeedierSatisfactionRatio

Number(18, 0)

Satisfaction Ratio du feedback

FeedierPushCreatedAt

Date

L'heure de création d'envoi (s'il y en a une)

FeedierPushStatus__c

texte (255)

L'état d’envoi

LastModifiedById

Référence(User)

Champ obligatoire dans Salesforce

OwnerId

Référence(User,Group)

Champ obligatoire dans Salesforce

eg. Case

eg. Référence(Case)

Référence : L'attribut de Feedier qui se connecte à Salesforce

3. Ajouter un Référence « lookup relationship value »

 

4. Ajouter un objet FeedierItem

Comme aux étapes 1 et 2, créez un nouvel objet Salesforce FeedierItem__c et ajoutez les champs suivants :

Nom du champ sur Salesforce

Type de données

Explication

CreatedById

Référence(Utilisateur)

Champ obligatoire dans Salesforce, affiche l'utilisateur qui a configuré le connecteur.

Name

texte (80)

Champ obligatoire dans Salesforce

FeedierItemFullName

texte (255)

Le nom de la question

FeedierItemFeedbackObjectId

Lookup(FeedierFeedback)

Le FeedierFeedback associé qui a été créé dans l'intégration.

FeedierItemFeedbackId

 

texte(80)

Feedback ID dans Feedier

FeedierItemSurveyName

 

texte (255)

Nom de l'enquête dans Feedier

FeedierItemType

texte (255)

Le type de réponse ; dans la plupart des cas d'utilisation, il s'agit d'une "question".

FeedierItemValue

Zone de texte long(131072)

La valeur de la réponse

FeedierItemCreatedAt

Date

La réponse temps de création

LastModifiedById

Référence(Utilisateur)

Champ obligatoire dans Salesforce

OwnerId

Référence(Utilisateur,Groupe)

Champ obligatoire dans Salesforce

5. Ajouter un Segment

Ensuite, nous devons configurer un segment sur Feedier. Les segments sont des recherches sauvegardées qui vous permettent de créer des automatismes basés sur les commentaires sélectionnés.

Créez un segment qui identifiera tous les feedbacks qui doivent être ajoutés à l'enregistrement Salesforce.
Si vous avez besoin de tous les feedbacks, il vous suffit de définir un filtre avec une période supérieure au début de l'année.

 

6. Connecter le segment à une automatisation

  • Sélectionnez le segment que vous venez de créer.

  • Sélectionnez Créer un objet Salesforce dans la liste déroulante

ID Client de l’App

Reportez-vous à l'étape 1, vous l'obtenez à partir de l'application connectée dans Salesforce.

Secret Client de l’App

Reportez-vous à l'étape 1, vous l'obtenez à partir de l'application connectée dans Salesforce.

Champ de Relation d’Objets Salesforce

Il s'agit de la Référence qui lie la relation à l'objet FeedierFeedback que vous avez créé. (Gestionnaire d'objet → FeedierFeedback → Champs et relations). Copiez exactement le "nom du champ" dont vous avez besoin. Par exemple, si vous avez ajouté la relation à un cas Salesforce, vous devez sélectionner Case_id__c.

Nom attribut

Il s'agit du nom de l'attribut Feedier (et non de l'étiquette) qui contient l'ID de l'objet Salesforce utilisé pour la mise en correspondance. Vous pouvez nommer cet attribut de la façon dont vous voulez le voir sur le tableau de bord de Feedier, par exemple Account ID, CustomID, Contact_id, etc.

Par exemple: feedback.feedier.com/survey-url?sf_id=123

7. See your feedback answers in Salesforce

Lorsque vous commencez à recueillir des commentaires, si votre relation est liée, par exemple case_id ou contact_id, vous pourrez la voir attachée à historique de Salesforce.

Une fois que vous avez choisi l'enquête sous FeedierFeedback, vous pouvez cliquer sur l'onglet associé et afficher les réponses sous l'objet FeedierItems.

 

Workflow 3 : Déclenchement d'e-mails push en temps réel et automatisés sur la base des messages Salesforce Outbound

Configurer une campagne de e-mail en tant que modèle pour l'envoi d'e-mails

Tout d'abord, vous devez mettre en place une campagne d'envoi d'e-mails. Celle-ci servira de modèle à chaque fois que des e-mails seront déclenchés. Il vous suffit d'ajouter votre page d'email et de compléter la campagne.

  • Sélectionnez information da la colonne paramètres dans le menu déroulant de la page de la campagne.

Configurer le message sortant

Configurez la page comme suit :

 

  • Utilisateur à envoyer en tant que : Choisissez ce que vous voulez, cela n'a pas d'impact sur le connecteur.

  • Champs de cas à envoyer : Choisissez toutes les données que vous souhaitez joindre au feedback dans Feedier. ContactEmail est obligatoire.

  • Cliquez sur Enregistrer

Déclencher le message sortant

  • Vous devez maintenant déclencher le message sortant.

  • Créez un déclencheur avec vos propres règles (statut du dossier = clôturé par exemple).

  • Joignez le message sortant que vous avez créé

  • Créer un déclencheur avec vos propres règles (statut du cas = escaladé par exemple)

Attacher le message sortant à la règle de flux de travail

  • Vous devez maintenant joindre le message sortant à la règle de flux de travail afin que, lorsque la règle est validée, un message sortant soit envoyé à l'URL d'extrémité que nous avons configurée plus tôt.

  • Attachez le message sortant que vous avez créé et vous êtes prêt.

Tester le message sortant

Déclenchez la règle de workflow créée et vous devriez voir un push créé sur la page Pushes de Feedier.

Related content

Connect Salesforce to Feedier
Connect Salesforce to Feedier
More like this
Configurer une connexion SSO (Single Sign-On)
Configurer une connexion SSO (Single Sign-On)
More like this
Importing your Google Reviews
Importing your Google Reviews
Read with this
Setup an SSO connection
Setup an SSO connection
More like this
Version 2.0.7 - 19th December 2023
Version 2.0.7 - 19th December 2023
More like this