Connecter Salesforce à Feedier

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

Ajouter une nouvelle application connectée

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

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.

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

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 :

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 :

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 :

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

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 :

• Nom / Nom unique : Choisissez ce que vous voulez, cela n'a pas d'impact sur le connecteur.

• Endpoint URL :
  
  PROD: https://connector.feedier.com/salesforce/push?push_campaign_id={Feedier Campaign ID}&api_key={Private API Key Feedier}
  Sandbox: https://connector-preprod.feedier.com/salesforce/push?push_campaign_id={Feedier Campaign ID}&api_key={Private API Key PreProd 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

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)

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

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.