Passer au contenu principal

Connecter Salesforce à Feedier

Julien Chil avatar
Écrit par Julien Chil
Mis à jour cette semaine


1) Déclencher des emails en temps réel et automatisés via le message Salesforce Outbound.

Ce workflow est conçu pour envoyer un email de feedback depuis Feedier immédiatement après qu'un certain déclencheur ait été atteint sur un enregistrement Salesforce.


a) Configurer une campagne d'email sur Feedier comme modèle pour l'envoi d'emails

Feedier → Enquête → Partager → Campagne d'email.

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

Tout ce que vous devez savoir sur les campagnes d'emailing dans Feedier est disponible ici.


b) Configurer le message sortant

Application de configuration de Salesforce → Messages sortants → Nouveau message sortant

Configurez le formulaire comme suit :




Si vous utilisez un objet personnalisé, vous devez créer un champ d'e-mail personnalisé pour pouvoir joindre l'e-mail au message sortant.


Ajoutez l'ID de campagne Feedier du modèle que vous venez de créer.


Nous pouvons trouver l'ID de la campagne dans Enquêtes → Partage → Campagne d'email → Info


=> suivre la capture d'écran ci-dessous ( Exemple : ID de campagne = 823 )



Vous pouvez trouver les détails de votre API sur Feedier via :
Profil → Paramètres avancés

  • Utilisateur à envoyer en tant que : Choisissez ce que vous voulez, cela n'a aucun rapport avec 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


Remarque importante :

Vous pouvez décider d'attacher et de pousser tous les attributs que vous voulez avoir sur le retour d'information dès le début du message sortant, vous recevrez alors le retour d'information sur Feedier avec tous les attributs (métadonnées) que vous avez attachés au message sortant et vous n'aurez pas besoin de l'enrichir. (Sélectionnez vos métadonnées dans la case Champs de cas à envoyer)


c) Créer la règle de flux de travail

Automatisation des processus Salesforce → Règles de flux de travail

  • Vous devez maintenant déclencher le message sortant.

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

  • Joignez le message sortant que vous avez créé


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

Vous pouvez également créer la règle dans le générateur de flux




d) Attachez le message sortant à la règle de flux de travail

Application de configuration de Salesforce → Règles 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 précédemment.

  • 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.


Si vous décidez de faire de l'enrichissement et de ne pas envoyer les métadonnées dans le message sortant, vous devriez voir un push créé sur la page Pushes de Feedier

Allons plus loin pour connecter Feedier à Salesforce.


2) Installer l'application Feedier Salesforce

Un administrateur Salesforce doit installer l'application Feedier en utilisant ce lien : Installer l'application Feedier
Lors de l'installation, l'administrateur peut sélectionner "Tous les utilisateurs" ou n'accorder l'accès qu'à des utilisateurs spécifiques.
Dans votre cas, vous devez accorder l'accès aux comptes utilisés par Feedier dans les environnements UAT et de production.


Si l'erreur suivante apparaît :




Cela signifie que l'utilisateur qui tente d'installer le package n'est pas un administrateur dans Salesforce



2 - Créer une connexion Salesforce dans Feedier



a) Scénario 1 - Déploiement du package automatique Salesforce

Recommandé pour une première installation de Salesforce



→ Suivez les étapes ici pour créer vos premiers workflows


b) Scénario 2 - Package Salesforce manuel



3) Enrichir les données de feedback avec les attributs d'un ou plusieurs objets Salesforce


Ce flux de travail est conçu pour mettre à jour les commentaires sur Feedier avec des attributs clés de l'enregistrement Salesforce du répondant.


Avant de déclencher l'intégration





Après le déclenchement de l'intégration




a) Étapes pour établir l'intégration

Créer une automatisation Autopilot

Feedier → Autopilote → Automatisation


Choisissez le segment de feedbacks que vous souhaitez enrichir à partir de l'objet Salesforce



Connectez le segment à une connexion d'objet Salesforce Sync


→ Sélectionnez la connexion Salesforce que vous venez de créer

SOQL Salesforce

Nom de l'attribut

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 feedback 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 l'enregistrement correct.


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


b) Comment créer votre SOQL

Pour interroger efficacement les données dans Salesforce à l'aide du SOQL (Salesforce Object Query Language), vous pouvez suivre les étapes ci-dessous. SOQL vous permet de récupérer des données à partir d'objets Salesforce tels que les contacts et les comptes. 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 Object Query Language (SOQL) | Référence SOQL et SOSL | Développeurs Salesforce


Tous les attributs récupérés seront ajoutés en tant que métadonnées au feedback reçu, chaque colonne renvoyée par la requête SOQL étant jointe en tant qu'attribut.


Pour commencer à écrire des requêtes SOQL, vous devez accéder à la console Salesforce Developer. Une fois ouverte, accédez à l'éditeur de requêtes pour commencer à écrire des requêtes SOQL.


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

Une fois dans l'éditeur de requêtes, vous pouvez exécuter la requête suivante pour récupérer les données relatives à un contact spécifique :


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


Cette requête récupère 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 relatives aux contacts et aux comptes qui leur sont associés à 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 détails 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 :




c) 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'identification 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 = '{valeur_attribut}'


Dans cette requête dynamique, le caractère générique {valeur_attribut} 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 :


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


Ceci devrait être votre configuration finale :



Il ne vous reste plus qu'à cliquer sur Enregistrer et à vous authentifier avec votre compte Salesforce.



c) 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 d'un 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/DXoT9Z, vous devez saisir dans votre navigateur : https://feedback.feedier.pre-prod.alkalab.com/DXoT9Z?sf_id=001J7000007VpctIAC.


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


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


Remarques importantes :

  1. Feedier ne lira que le premier enregistrement de la requête. Vous pouvez donc commander si plusieurs enregistrements peuvent correspondre.

  2. La requête doit contenir "{valeur_attribut}" 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.


4) Se connecter à Salesforce pour mettre à jour un "objet Salesforce" à partir des données de retour d'information

Ce flux de travail est conçu pour mettre à jour un enregistrement sur Salesforce avec les réponses aux questions provenant du feedback du répondant dans Feedier.


a) Créer un objet personnalisé

Application de configuration de Salesforce → Gestionnaire d'objets → Créer → Objet personnalisé


  • Créez un objet personnalisé appelé FeedierFeedback




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




Remarque : le nom de l'objet doit être FeedierFeedback (l'API appellera FeedierFeedback__c).



b) Ajouter le champ et les 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 :

Étiquette Salesforce

Type de données

Type de données Explication

Créé par

Recherche (utilisateur)

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

FeedierFeedbackId

Texte(80)

ID du feedback dans Feedier

FeedierCreatedAt

Date

Date de création du feedback

FeedierFeedbackName


Texte(80)

Le nom de l'objet

FeedierSurveyName


Texte (100)

Nom de l'enquête dans Feedier

FeedierFeedbackLink

Texte (255)

Le lien vers les réponses au feedback sur Feedier

FeedierNPSScore

Nombre(18, 0)

La valeur de la réponse à la question NPS

FeedierSatisfactionRatio

Nombre(18, 0)

Taux de satisfaction du feedback

FeedierPushCreatedAt

Date

L'heure de création du programme de push (s'il y en a un)

FeedierPushStatus__c

Texte (255)

Le statut du push

LastModifiedById

Recherche(Utilisateur)

Champ obligatoire dans Salesforce

OwnerId

Recherche(User,Group)

Champ obligatoire dans Salesforce

ex. Cas

ex. Recherche(Affaire)

Recherche de relation :
l'attribut de Feedier qui se connecte à Salesforce




Tout champ erroné ou manquant entraînera un blocage du processus et le retour d'information ne sera pas envoyé à Salesforce.



c) Ajouter une valeur de relation de consultation

FeedierFeedback → Champ et relations → Nouveau → Relation de consultation → [sélectionner le champ personnalisé à lier]


Vous devrez ajouter une relation de consultation 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.


d) Ajouter un objet FeedierItem

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

Étiquette Salesforce

Type de données

Type de données Explication

CreatedById

Lookup(User)

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

Nom

Texte (80)

Champ obligatoire dans Salesforce

FeedierItemFullName

Texte (255)

Nom de la question

FeedierItemFeedbackObjectId

Lookup(FeedierFeedback)

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

FeedierItemFeedbackId


Texte(80)

ID du feedback 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, il s'agira d'une "question"

FeedierItemValue

Texte long Zone (131072)

La valeur de la réponse

FeedierItemCreatedAt

Date/Heure

Heure de création de la réponse

LastModifiedById

Recherche (utilisateur)

Champ obligatoire dans Salesforce

OwnerId

Recherche(User,Group)

Champ obligatoire dans Salesforce




Exemple d'affichage dans Salesforce


Tout champ erroné ou manquant entraînera un blocage du processus et le retour d'information ne sera pas envoyé à Salesforce.

Avez-vous trouvé la réponse à votre question ?