Procédure d’intégration avec Salesforce CRM

Objectif de cet article

Découvrez comment intégrer Salesforce CRM à Klaviyo. Cette intégration facilite la connexion de votre compte Salesforce, le choix des objets à synchroniser et le mappage des champs, le tout via un flux de configuration guidé dans l’application.

Grâce à cette intégration, Klaviyo peut synchroniser automatiquement les données Salesforce (telles que les prospects ou les contacts) dans les profils Klaviyo, ce qui vous permet de personnaliser les messages et de segmenter les clients à l’aide des données CRM.

Avant de commencer

Avant de commencer, assurez-vous que :

• Vous êtes connecté à votre compte Salesforce.
• Si votre entreprise dispose de plusieurs organisations Salesforce, assurez-vous d’être connecté à la bonne organisation.
• Vous disposez d’un accès administrateur à votre compte Salesforce.

Connecter Salesforce à Klaviyo

1. Connectez-vous à Klaviyo. Ensuite, sélectionnez l’onglet Intégrations.
2. Cliquez sur Explorer les applications pour ouvrir le Klaviyo App Marketplace. Recherchez la Salesforce app listing et ouvrez-la. Ensuite, cliquez sur Installer.
3. Vous serez redirigé vers le flux de configuration de l’intégration Salesforce. Pour l’étape 1, sélectionnez si vous vous connectez à une organisation Salesforce de production ou sandbox, puis cliquez sur Installer l’application Klaviyo Client.
   

4. Dans Salesforce, suivez l’assistant d’installation pour reconnaître et installer le package « Klaviyo Salesforce OAuth Connector » dans l’organisation Salesforce que vous connectez à Klaviyo.
   

5. Une fois l’installation terminée, retournez à la page de configuration de l’intégration Salesforce dans Klaviyo. Suivez ensuite l’étape 2 et cliquez sur Connecter à Salesforce.
   

6. Cliquez sur Autoriser pour terminer le flux OAuth et finaliser la connexion entre Klaviyo et Salesforce.
   

Choisir un objet Salesforce à synchroniser

Après la connexion, vous serez invité à sélectionner les objets Salesforce que vous souhaitez synchroniser dans Klaviyo. Cliquez sur Suivant pour continuer.

Vous pouvez désormais choisir jusqu’à 3 objets à synchroniser dans Klaviyo. Les options disponibles incluent :

• Piste - Clients potentiels qui ont manifesté de l’intérêt pour vos produits ou services Salesforce
• Contact - Personnes associées à des comptes dans votre organisation Salesforce
• Compte - Organisations ou personnes impliquées dans votre entreprise (telles que les clients, les concurrents et les partenaires)
• Opportunité - Offres ou soldes potentielles
• Autre (la disponibilité dépend de votre configuration Salesforce)

Les objets synchronisés depuis Salesforce seront créés ou mis à jour en tant que profils Klaviyo. Lors de la synchronisation de plusieurs objets :

• Les enregistrements de tous les objets sélectionnés se synchroniseront avec Klaviyo.
• Si l’adresse e-mail d’un enregistrement correspond à un profil Klaviyo existant, ce profil sera mis à jour.
• Si l’adresse e-mail d’un enregistrement n’existe pas dans Klaviyo, un nouveau profil sera créé.
• Si la même personne existe dans plusieurs objets synchronisés avec la même adresse e-mail, Klaviyo les regroupera en un profil unique sur la base de l’adresse e-mail. (Les mappages de champs sont configurés par objet à l’étape suivante.)

Mappez les champs Salesforce aux propriétés Klaviyo

Ensuite, vous mapperez les champs Salesforce sur les propriétés de profil Klaviyo. Notez que certains mappages de base, tels que l’e-mail, le numéro de téléphone, le prénom et le nom, sont déjà mappés. Le mappage de l’adresse e-mail Salesforce est obligatoire.

Lorsque vous avez sélectionné plusieurs objets Salesforce à synchroniser, vous configurerez les correspondances de champs séparément pour chaque objet. Cela vous permet de contrôler quels champs de chaque objet deviennent des propriétés de profil Klaviyo.

Ajouter ou modifier des mappages

• Utilisez Ajouter un mappage pour mapper des champs Salesforce supplémentaires pour l’objet actuellement sélectionné.
• Sélectionner un champ Salesforce à gauche et la propriété Klaviyo correspondante à droite.
• Supprimez les mappages à l’aide de l’ icône de corbeille si nécessaire.
• Répétez ce processus pour chaque objet synchronisé.
  

Si la même propriété de profil Klaviyo (par exemple, Numéro de téléphone ou Ville) est mappée à partir de plusieurs objets Salesforce, Klaviyo synchronisera dans le profil la valeur la plus récemment mise à jour depuis Salesforce.

Importer des correspondances via CSV (facultatif)

Gestion du désabonnement (facultatif)

Vous pouvez activer l’option permettant de synchroniser l’objet Salesforce comme étant désabonné lorsque l’option Email Opt Out est définie sur true sur l’objet Salesforce. Cela marquera le profil comme désabonné des e-mails dans Klaviyo.

Terminer la configuration

Une fois vos mappages terminés, cliquez sur Terminer la configuration. Klaviyo finalisera l’intégration (cela prend généralement quelques secondes). Vous verrez un message de confirmation une fois que votre compte Salesforce sera correctement connecté et en cours de synchronisation.

Surveillez la synchronisation Salesforce et vérifiez les données

L’intégration Salesforce se synchronise avec Klaviyo toutes les heures.

Pour vérifier votre intégration :

1. Cliquez sur le menu déroulant Analyse dans Klaviyo et sélectionnez Indicateurs. Filtrez par Salesforce, puis trouvez l’indicateur Devenu un lead et cliquez sur son icône Flux d’activité.
2. Si votre intégration a commencé à synchroniser des données, vous verrez des événements Devenu lead, avec l’icône Salesforce, ajoutés à ce flux d’activité.
3. Klaviyo importe tous vos prospects Salesforce. Pour le vérifier, comparez le nombre de prospects ajoutés à Klaviyo un jour donné au nombre de prospects ajoutés à Salesforce et confirmez que les chiffres correspondent.
4. Survolez le point de données d’hier (dans le flux d’activité pour Became Lead, que vous pouvez trouver en cliquant sur l’indicateur) ou consultez le tableau de données sous le graphique pour voir combien de paiements ont eu lieu hier et le comparer au magasin de données dans Salesforce.
5. Si les données ne correspondent pas, le problème vient très probablement du fait que le fuseau horaire de votre compte Klaviyo ne correspond pas à celui de votre compte Salesforce. Pour vérifier le paramètre de fuseau horaire dans Klaviyo :
   • Cliquez sur le nom de votre compte dans la partie inférieure gauche.
   • Sélectionnez, puis cliquez sur Paramètres > Organisation.
   • Descendez jusqu’à Timezone.

Indicateurs Salesforce dans Klaviyo

Actuellement, Klaviyo synchronise un indicateur avec Salesforce CRM : Devenu prospect.

Cet indicateur est suivi lorsqu’un nouveau prospect est créé dans Salesforce. L’événement en lui-même n’inclut aucune donnée de Salesforce, mais lorsque cet événement est enregistré, Klaviyo synchronise les propriétés personnalisées suivantes pour chaque prospect et les associe au profil Klaviyo du prospect :

• Identifiant
• Prénom
• Nom de famille
• Title
• Entreprise
• Rue
• City
• État
• Code postal
• Pays
• Latitude
• Longitude
• Numéro de téléphone
• E-mail
• Site web
• LeadSource
• Statut
• Secteur d’activité
• NumberOfEmployees
• HasOptedOutOfEmail
• E-mail du propriétaire

Vous pouvez ensuite utiliser ces propriétés dans des segments, dans des flux, et pour renseigner dynamiquement les propriétés client dans vos modèles de message.

Résolution de problèmes

Problèmes d’installation et d’authentification

Migrer de l’authentification de base vers OAuth

Si vous avez configuré l’intégration Salesforce avant la prise en charge d’OAuth, il se peut que votre application Salesforce soit connectée à Klaviyo via l’authentification de base.

Les connexions d’authentification de base existantes continueront de fonctionner jusqu’à l’expiration de leurs identifiants. Cependant, une fois ces identifiants expirés, ils ne peuvent pas être réinitialisés ni renouvelés. Pour que votre intégration Salesforce reste connectée à Klaviyo, vous devrez migrer vers OAuth.

1. Connectez-vous à l’organisation Salesforce connectée à Klaviyo.
2. Dans le portail Klaviyo, accédez à votre page des paramètres d’intégration Salesforce. Une bannière en haut de la page devrait indiquer : « l’authentification OAuth est maintenant requise ». Dans la description de la bannière, cliquez sur l’hyperlien « application Klaviyo externe » pour installer le package « Klaviyo Salesforce OAuth Connector » dans votre organisation Salesforce.

3. Une fois l’installation terminée, revenez à la page Paramètres d’intégrations Salesforce et cliquez sur Mettre à jour. Ensuite, terminez le flux OAuth.

Pour plus d’informations, consultez la section « Connecter Salesforce à Klaviyo » en haut de ce guide.

Erreur « L’application Klaviyo externe n’est pas installée. Installez-la, puis réessayez »

Cette erreur indique que l’organisation Salesforce avec laquelle vous essayez de vous authentifier (ou de vous réauthentifier) n’a pas le package « Klaviyo Salesforce OAuth Connector » installé.

Veuillez vous assurer que :

1. Vous êtes connecté à Salesforce
2. Vous êtes connecté à l’organisation Salesforce intégrée à Klaviyo. Si votre entreprise dispose de plusieurs organisations Salesforce, il se peut que vous soyez connecté à la mauvaise organisation.
3. Si vous êtes connecté à la bonne organisation Salesforce et que vous obtenez toujours cette erreur, recherchez vos packages installés dans Salesforce pour vérifier si le package « Klaviyo Salesforce OAuth Connector » est installé. S’il n’est pas installé, répétez l’étape 1 dans le flux de configuration de l’intégration pour installer le package (voir la section « Connecter Salesforce à Klaviyo » en haut de ce guide). Ou, si vous aviez une intégration existante et que vous migrez vers OAuth, cliquez sur le texte « external Klaviyo App » (avec lien hypertexte) pour installer le package (voir la section « Migrer vers OAuth » ci-dessus).

Si le problème persiste, veuillez contacter l’assistance.

Message d’erreur de non-correspondance du compte

Si votre entreprise dispose de plusieurs organisations Salesforce, assurez-vous d’être connecté à l’organisation Salesforce actuellement connectée à Klaviyo lorsque vous réauthentifiez l’intégration

Si vous êtes connecté à une autre organisation Salesforce, vous verrez une erreur « Account Mismatch » :

Pour résoudre l’erreur, effectuez l’une des actions suivantes :

1. Reconnecter l’organisation Salesforce existante : Fermez la fenêtre, déconnectez-vous de Salesforce, puis connectez-vous à l’organisation Salesforce actuellement connectée à Klaviyo et réessayez.
2. Connecter une autre organisation Salesforce : Désinstallez l’intégration Salesforce dans Klaviyo, réinstallez-la, puis terminez le flux de configuration de l’intégration Salesforce en utilisant la nouvelle organisation Salesforce.

Avertissements et erreurs de mappage des champs

Klaviyo valide en continu vos mappages de champs Salesforce pour garantir que les données peuvent se synchroniser de manière fiable. Si un champ Salesforce mappé devient indisponible (par exemple, s’il est supprimé, renommé ou si les autorisations changent), vous pouvez voir un avertissement ou une erreur dans vos paramètres d’intégration.

Lorsqu’un champ non requis n’est pas disponible

Si un champ Salesforce mappé n’est plus disponible et qu’il n’est pas obligatoire, Klaviyo va :

• Affichez un avertissement indiquant quel champ manque.
• Continuer à synchroniser tous les autres champs disponibles.
• Excluez le champ indisponible des synchronisations futures jusqu’à ce qu’il soit mis à jour ou supprimé.

Pour résoudre ce problème,

1. Accédez à votre intégration Salesforce dans Klaviyo.
2. Ouvrez l’objet concerné.
3. Mettez à jour ou supprimez le mappage de champ non valide.
4. Enregistrez vos modifications.

Une fois mis à jour, la synchronisation reprendra comme prévu.

Lorsqu’un champ requis (E-mail) n’est pas disponible

Si le champ Salesforce Email n’est plus disponible pour un objet (par exemple, en raison de modifications du schéma ou d’autorisations), Klaviyo :

• Affichez une erreur indiquant que le champ Email est manquant.
• Arrêtez la synchronisation des données pour l’objet concerné.
• Vous invite à mettre à jour vos mappages de champs pour rétablir la synchronisation.

Pour résoudre ce problème,

1. Accédez à votre intégration Salesforce dans Klaviyo.
2. Ouvrez l’objet concerné.
3. Assurez-vous qu’un champ Salesforce Email valide est mappé à la propriété Email de Klaviyo.
4. Enregistrez vos modifications.

Une fois que le champ E-mail est de nouveau mappé correctement, la synchronisation des données reprendra automatiquement.

Profils manquants dans Klaviyo

Si les enregistrements Salesforce n’apparaissent pas comme des profils dans Klaviyo, vérifiez d’abord qu’un champ d’e-mail valide est mappé pour chaque objet que vous synchronisez. Klaviyo utilise l’adresse e-mail comme identifiant obligatoire pour créer ou mettre à jour des profils ; les enregistrements sans champ d’e-mail mappé ou sans valeurs d’e-mail valides ne seront pas synchronisés en tant que profils. Assurez-vous que :

• Un champ d’ e-mail Salesforce est associé à la propriété e-mail de Klaviyo pour chaque objet sélectionné.
• Le champ d’e-mail mappé contient des valeurs d’e-mail réelles dans Salesforce : les e-mails vides ou non valides peuvent empêcher la synchronisation des enregistrements en tant que profils.

Une fois qu’un champ d’e-mail valide est mappé et que les enregistrements incluent des adresses e-mail, Klaviyo créera ou mettra à jour ces profils lors de la prochaine synchronisation.

Résultat

Vous avez maintenant intégré votre compte Klaviyo à Salesforce CRM et vérifié vos données synchronisées.