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) | TICKED |
— Callback URL | Pour Sandbox: https://dashboard.feedier.pre-prod.alkalab.com/integration/callback/salesforceObject https://dashboard.feedier.pre-prod.alkalab.com/integration/callback/salesforce |
— Selected OAuth Scopes | (api) |
Collecte de App Client ID et App Client Secret pour la connexion sur Feedier
Apps → App Manager → Feedier → View → Manage Consumer details
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.
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.
Avant de déclencher l'intégration
Après avoir déclenché l'intégration
Étapes de l'intégration
Ajouter un Segment
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
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.
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) |
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
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:
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 :
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 :
SELECT Id, FirstName, LastName, Email, Phone, AccountId FROM Contact WHERE Id = 'sf_id'
Il s'agit de la configuration finale :
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.
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
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 |
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 »
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 |
Tout champ erroné ou manquant entraînera un blocage du processus et le feedback ne sera pas envoyé à Salesforce.
5. Ajouter un Segment
Feedier → Feedbacks -> Segments → Nouveau 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
Feedier → Menu profil → Automations → Ajouter Segment
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
Salesforce Record → 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.
Workflow 3 : Déclenchement d'e-mails push en temps réel et automatisés sur la base des messages Salesforce Outbound
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
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
Salesforce's Setup App → Outbound Messages → New Outbound message
Configurez la page comme suit :
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.
Vous pouvez trouver les détails de votre API dans le menu déroulant dans Feedier :
Profil → Intégrations
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
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)
Joignez le message sortant que vous avez créé et vous êtes prêt.
Attacher le message sortant à la règle de flux de travail
Salesforce Setup App → Workflow Rules
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.
Add Comment