...
Connected App Name | Feedier | ||
API Name | Feedier | ||
Contact Email | help@feedier.com (ou votre email) | ||
API (Enable OAuth Settings) | TICKED | ||
— Callback URL | For SandboxPour Production : https://dashboardconnect.feedier.com/integrationrest/oauth2-credential/callback/salesforceObject | — Selected OAuth Scopes | |
— Selected OAuth Scopes | (api) |
...
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.
...
...
Ce workflow est conçu pour mettre à jour les feedbacks sur Feedier avec les attributs clés de l'enregistrement Salesforce du répondant.
Add a Segment
| Info |
|---|
Feedier → Actions → Segments → New 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
| Info |
|---|
Feedier → Actions → Automations → Add Segment |
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
Feedier prend en charge le SOQL personnalisé afin d'être aussi performant que possible. Ainsi, tant qu'il y a un ID et une relation, vous pouvez obtenir n'importe quel type de champ Salesforce à l'aide de SOQL. Veuillez vous référer à la documentation de Salesforce pour la structure : https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm
Remarques importantes
...
Feedier attachera comme attributs tous les champs sélectionnés au feedback.
...
Feedier ne lira que le premier enregistrement de la requête. Vous pouvez donc commander si plusieurs enregistrements peuvent correspondre.
...
| Note |
|---|
NB : Lors des tests, si vous rencontrez des problèmes de connexion, vérifiez les points suivants : |
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
Ce workflow est conçu pour mettre à jour les feedbacks sur Feedier avec les attributs clés de l'enregistrement Salesforce du répondant.
| Note |
|---|
Avant de déclencher l'intégration |
...
| Tip |
|---|
Après avoir déclenché l'intégration |
...
Étapes de l'intégration
Ajouter un Segment
| Info |
|---|
Feedier → Feedbacks → Segments → New 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
| Info |
|---|
Feedier → Nom de Profil → Automations → Add Segment |
Sélectionnez le segment que vous venez de créer.
Sélectionnez Salesforce Fields Sync dans la liste déroulante.
...
| Note |
|---|
Tout champ erroné ou manquant entraînera un blocage du processus et le feedback ne sera pas envoyé à Salesforce. |
3. Ajouter un Référence
| Info |
|---|
FeedierFeedback → Champs et Relations → Créer→ Réference → [sélectionner le champ personnalisé à lier] |
Vous devrez ajouter un Référence dans la table afin de lier ce nouvel objet FeedierFeedback à un champ personnalisé existant de Salesforce, par exemple contact_id ou case_id. Ceci est nécessaire pour que le connecteur sache quel enregistrement mettre à jour.
4. Adjouter 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
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 identifiantID de compte, d'un ID personnalisé ou d' une valeur pour une requête/appariement LIKE.Voici deux exemples, Query 1: SELECT Contact_P__r.Id, Ticket_Type_Number__c, St__c, Produit__c, SourceSystem__c, Type__c, EffectiveDate__c, Category__c FROM TransactionDetail__c WHERE Contact_P__r.Id = '{attribute_value}' ORDER BY EffectiveDate__c DESC Query 2: SELECT Name FROM Account WHERE http://Account.Id = '{attribute_value}' |
Attribute Name | 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. Il peut s'agir d'un ID de compte, d'un ID personnalisé, d'un ID de contact, etc. Par exemple, feedback.feedier.com/survey-url?sf_id=123 créera un attribut sf_id avec la valeur 123. Dans cette option, définissez sf_id. N'hésitez pas à contacter votre gestionnaire de compte Feedier pour obtenir de l'aide. |
...
Flux de travail 2 : Connexion à Salesforce pour mettre à jour un "Salesforce Object" après le feedback
Ce flux de travail est conçu pour mettre à jour un enregistrement dans Salesforce avec les réponses aux questions du feedback du répondant dans Feedier.
1. Créer un Custom Object
| Info |
|---|
Salesforce Setup App → Gestionnaire d’objet→ Créer→ Objet |
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
...
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
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) |
| Info |
|---|
Comment créer votre 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 : https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm
| Info |
|---|
Tous les attributs récupérés seront ajoutés en tant que métadonnées au retour d'information reçu, chaque colonne renvoyée par la requête SOQL étant jointe en tant qu'attribut. |
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:
| Code Block |
|---|
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 :
| Code Block |
|---|
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 :
| Code Block | ||
|---|---|---|
| ||
SELECT Id, FirstName, LastName, Email, Phone, AccountId
FROM Contact
WHERE Id = '001J7000007VpctIAC' |
doit être remplacé dans le champ SOQL par :
| Code Block | ||
|---|---|---|
| ||
SELECT Id, FirstName, LastName, Email, Phone, AccountId
FROM Contact
WHERE Id = '{attribute_value}' |
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 :
| Code Block | ||
|---|---|---|
| ||
SELECT Id, FirstName, LastName, Email, Phone, AccountId
FROM Contact
WHERE Id = 'sf_id' |
Il s'agit de la configuration finale :
...
| Info |
|---|
Now you just need to click save and authenticate with your Salesforce account |
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.
| Note |
|---|
Remarques importantes |
Feedier ne lira que le premier enregistrement de la requête. Vous pouvez donc passer commande si plusieurs enregistrements sont susceptibles de correspondre.
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
Ce flux de travail est conçu pour mettre à jour un enregistrement dans Salesforce avec les réponses aux questions du feedback du répondant dans Feedier.
1. Créer un Custom Object
| Info |
|---|
Salesforce Setup App → Gestionnaire d’objet→ Créer→ Objet |
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 |
| Référence(Utilisateur) | Champ obligatoire dans Salesforce, affiche l'utilisateur qui a configuré le connecteur. |
| texte(80) | Feedback ID sur Feedier |
| Date | Date de création du feedback |
| texte(80) | Nom de l'objet |
| texte (100) | Nom de l'enquête dans Feedier |
| texte (255) | Le lien vers les réponses aux feedback sur Feedier |
| Number(18, 0) | La valeur de la réponse à la question du NPS |
| Number(18, 0) | Satisfaction Ratio du feedback |
| Date | L'heure de création d'envoi (s'il y en a une) |
| 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. | eg. Référence(Case) | Référence : L'attribut de Feedier qui se connecte à Salesforce |
...
| Note |
|---|
Tout champ erroné ou manquant entraînera un blocage du processus et le feedback ne sera pas envoyé à Salesforce. |
3. Ajouter un Référence « lookup relationship value »
| Info |
|---|
FeedierFeedback → Champs et Relations → Créer→ Réference → [sélectionner le champ personnalisé à lier] |
Vous devrez ajouter un Référence « lookup relationship »dans la table afin de lier ce nouvel objet FeedierFeedback à un champ personnalisé existant de Salesforce, par exemple contact_id ou case_id. Ceci est nécessaire pour que le connecteur sache quel enregistrement mettre à jour.
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 |
| Référence(Utilisateur) | Champ obligatoire dans Salesforce, affiche l'utilisateur qui a configuré le connecteur. |
| texte (80) | Champ obligatoire dans Salesforce |
| texte (255) | Le nom de la question |
| Lookup(FeedierFeedback) | ⚠️Le FeedierFeedback associé qui a été créé dans l'intégration. |
| texte(80) | Feedback ID dans Feedier |
| texte (255) | Nom de l'enquête dans Feedier |
| texte (255) | Le type de réponse ; dans la plupart des cas d'utilisation, il s'agit d'une "question". |
| Zone de texte long(131072) | La valeur de la réponse |
| 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 |
...
| Note |
|---|
Tout champ erroné ou manquant entraînera un blocage du processus et le feedback ne sera pas envoyé à Salesforce. |
5.
...
Ajouter un Segment
| Info |
|---|
Feedier → Feedbacks -> Segments → NewNouveau 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 commentairesfeedbacks, 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
| Info |
|---|
Feedier → Actions Menu profil → Automations → Adjouter Ajouter Segment |
Sélectionnez le segment que vous venez de créer.
Sélectionnez Créer un objet Salesforce dans la liste déroulante
...
7. See your feedback answers in Salesforce
| Info |
|---|
Historique Salesforce Record → Associé → Related→ FeedierFeedback → Détails |
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.
...
Si aucun feedback n'a été donné pour une enquête particulière, celle-ci sera nommée Feedier Push dans la colonne FeedierFeedback Name.
...
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.
Feedier remplira automatiquement les champs pour chaque nouvelle réponse.
...
Ce flux de travail est conçu pour envoyer un e-mail de feedback depuis Feedier immédiatement après qu'un certain déclencheur a été atteint sur un historique Salesforce.
Configurer une campagne de e-mail en tant que modèle pour l'envoi d'e-mails
| Info |
|---|
Feedier → Enquête→ Partager→ Campagne e-mail |
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
| Info |
|---|
Salesforce's Setup App → Messages sortants → Nouveau message sortant |
Configurez la page comme suit :
...
une campagne de e-mail en tant que modèle pour l'envoi d'e-mails
| Info |
|---|
Feedier → Enquête→ Partager→ Campagne e-mail |
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
| Info |
|---|
Salesforce's Setup App → Outbound Messages → New Outbound message |
Configurez la page comme suit :
...
| Note |
|---|
Si vous utilisez un objet personnalisé, vous devez créer un champ email personnalisé afin de pouvoir attacher l'email au message sortant. |
Nom / Nom unique : Choisissez ce que vous voulez, cela n'a pas d'impact sur le connecteur.
Endpoint URL :
https://connector.feedier.com/salesforce/push?push_campaign_id={Feedier Campaign ID}&api_key={Private API Key Feedier}
Ajoutez l'ID de la campagne Feedier du modèle que vous venez de créer.
...
| Info |
|---|
Vous pouvez trouver les détails de votre API dans le menu déroulant dans Feedier : |
...
Utilisateur à envoyer en tant que : Choisissez ce que vous voulez, cela n'a pas d'impact sur le connecteur.
Endpoint URL : https://connector.feedier.com/salesforce/push?push_campaign_id={Feedier Campaign ID}&api_key={Private API Key Feedier}
Ajoutez l'ID de la campagne Feedier du modèle que vous venez de créer.
...
| Info |
|---|
Vous pouvez trouver les détails de votre API dans le menu déroulant dans Feedier : |
...
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
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
| Info |
|---|
Salesforce Process Automation → Workflow Rules |
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)
| Note |
|---|
 |
Attacher le message sortant à la règle de flux de travail
| Info |
|---|
Salesforce Setup App → Règles de flux de travailWorkflow Rules |
Vous devez maintenant déclencher joindre le message sortant .
Créez un déclencheur avec vos propres règles (statut du dossier = clôturé par exemple).
Joignez à 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.
Workflow 4: Si vous souhaitez obtenir le statut "push" dans Salesforce, consultez ce guide.
...
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.