Intégration Salesforce

• Connexion OAuth avec PKCE
• Synchronisation des contacts de Salesforce vers demeterrr
• Déclenchement manuel via la file d'attente pour les contacts synchronisés
• Déclenchement automatique sur les événements webhook Closed Won
• Mapping de renvoi des scores (NPS, CSAT, date du dernier sondage)

1. Allez dans Paramètres > Intégrations.
2. Cliquez sur Connecter Salesforce.
3. Complétez l'authentification OAuth dans Salesforce.
4. Revenez dans demeterrr et confirmez le statut Connecté.

Après la connexion, ouvrez Configurer sur la carte Salesforce pour ajuster le comportement.

Dans /settings/integrations/salesforce, définissez :

• manual : déclenchement uniquement depuis la file d'attente manuelle
• auto : déclenchement depuis les événements webhook Closed Won
• both : activation des déclenchements automatiques et de la file d'attente manuelle

Lorsque auto ou both est activé, choisissez la séquence à exécuter.

La file d'attente liste les contacts liés à Salesforce qui n'ont pas encore été déclenchés.

1. Sélectionnez un ou plusieurs contacts.
2. Sélectionnez une séquence.
3. Cliquez sur Déclencher.

Le système crée les envois et les distribue via le moteur de séquences.

Vous pouvez permettre aux utilisateurs Salesforce de déclencher des sondages demeterrr directement depuis Salesforce avec un bouton et un flux.

1. Dans demeterrr, créez une clé API avec la portée sequences:execute.
2. Dans Salesforce, créez un Named Credential (par exemple Demeterrr_API) pointant vers l'URL de votre application demeterrr.
3. Stockez la clé API dans l'en-tête d'authentification du Named Credential (Authorization: Bearer dem_...).
4. Ajoutez une action Apex invocable qui appelle :

POST /api/v1/sequences/:id/execute

1. Construisez un flux qui transmet les champs du contact (courriel requis) à cette action Apex.
2. Ajoutez un bouton d'action rapide à votre mise en page (Opportunité/Contact/etc.).

Cela permet aux utilisateurs d'envoyer des sondages sans ouvrir le tableau de bord demeterrr.

Vous pouvez associer :

• Le champ du score NPS (par défaut NPS_Score__c)
• Le champ du score CSAT (par défaut CSAT_Score__c)
• Le champ de date du dernier sondage (par défaut Last_Survey_Date__c)

Utilisez Tester les champs avant d'enregistrer pour confirmer que les champs personnalisés existent dans votre organisation Salesforce.

Pour le mode de déclenchement automatique, l'authentification webhook supporte :

• Un secret webhook spécifique à l'organisation stocké dans la configuration Salesforce
• Le repli vers la variable d'environnement globale SALESFORCE_WEBHOOK_SECRET

Envoyez le secret comme :

• En-tête : x-salesforce-webhook-secret (ou x-webhook-secret)
• Paramètre de requête : token (ou secret)

Depuis la carte Salesforce dans les Intégrations :

• Synchroniser maintenant déclenche la synchronisation des contacts
• Déconnecter arrête la synchronisation et le comportement de déclenchement

Vérifiez ces variables d'environnement :

• SALESFORCE_CLIENT_ID
• SALESFORCE_CLIENT_SECRET

Si vous êtes redirigé avec une erreur d'état Salesforce, reconnectez-vous avec une session fraîche et évitez les onglets périmés.

Vérifiez :

• Le mode de déclenchement est auto ou both
• Une séquence est sélectionnée dans la configuration Salesforce
• Le secret webhook est correctement configuré et transmis

• Créer votre première séquence
• Intégration HubSpot
• Intégration QuickBooks