Action Obtenir des contacts et des pistes à partir d'adresses e-mail
Cette action mappe les adresses e-mail avec les enregistrements de contact et de piste associés aux enregistrements utilisateur actifs. À utiliser dans les Activités : Mapper l’e-mail avec des enregistrements. Nécessite que Synchroniser l'e-mail en tant qu'activité Salesforce soit activé dans la Capture d'activité Einstein.
Éditions requises
| Disponible avec : Lightning Experience |
| Disponible avec Capture d'activité Einstein Standard dans Sales Cloud avec les éditions Starter, Professionnal et Enterprise |
| Disponible avec Unlimited Edition et Einstein 1 Sales Edition |
| Disponible avec Einstein pour Sales, qui est inclus dans Einstein 1 Sales Edition, et disponible moyennant un coût supplémentaire dans les éditions Enterprise et Unlimited Edition. |
| Disponible avec Sales Engagement dans Sales Cloud, qui est inclus avec les éditions Performance et Unlimited, et disponible moyennant un coût supplémentaire avec les éditions Professional et Enterprise |
| Disponible avec Intelligence du revenu, qui est disponible moyennant un coût supplémentaire dans les éditions Enterprise et Unlimited. |
Dans Flow Builder, ajoutez un élément Action vers votre flux. Dans la fenêtre Nouvelle action, recherchez Correspondance des activités, puis sélectionnez Obtenir des contacts et des pistes à partir des adresses e-mail.
Définition des valeurs d'entrée
Utilisez les valeurs antérieures du flux pour définir les entrées de l'action.
| Champ | Description |
|---|---|
| Champ Compte | Le nom du champ que vous utilisez pour identifier les comptes partenaires. Facultatif si Comptes partenaires est false. Cette entrée est capturée dans la section Utilise des comptes partenaires des propriétés d'action dans Flow Builder. |
| ID d'activité | Facultatif. L'ID de l'e-mail à associer aux enregistrements spécifiés. |
| Opérateur de comparaison | L'opérateur de comparaison pour déterminer un compte partenaire. Les valeurs valides sont Égal à, N'est pas égal à, Supérieur à, Inférieur à, Supérieur à ou Égal à, Inférieur à ou Égal à, Est nul et Est vide. Facultatif si Comptes partenaires est false. Cette entrée est capturée dans la section Utilise des comptes partenaires des propriétés d'action dans Flow Builder. |
| Adresses e-mail | Obligatoire. Une collection d'adresses e-mail sans enregistrement utilisateur actif correspondant. |
| Comptes partenaires | Une valeur booléenne qui indique si l'entreprise a des comptes partenaires. La valeur par défaut estfalse : Cette entrée est capturée dans la section Utilise des comptes partenaires des propriétés d'action dans Flow Builder. |
| Utilisateurs | Obligatoire. Une collection d'enregistrements utilisateur actifs pour aider à déterminer les enregistrements de contact et de piste associés auxquels mapper les e-mails. Ces enregistrements utilisateur contiennent une adresse e-mail dans le champ De, À ou Cc de l'e-mail. |
| Valeur | La valeur du champ Compte pour identifier un compte partenaire. Facultatif si Comptes partenaires est false. Cette entrée est capturée dans la section Utilise des comptes partenaires des propriétés d'action dans Flow Builder. |
Stockage des valeurs de sortie
| Champ | Description |
|---|---|
| Champ Compte | Le nom du champ que vous utilisez pour identifier les comptes partenaires. |
| Opérateur de comparaison | L'opérateur de comparaison pour déterminer un compte partenaire. Les valeurs valides sont Égal à, N'est pas égal à, Supérieur à, Inférieur à, Supérieur à ou Égal à, Inférieur à ou Égal à, Est nul et Est vide. |
| Contacts | Une collection d'enregistrements de contact correspondant aux adresses e-mail des contacts. |
| Pistes | Une collection d'enregistrements de piste qui correspondent aux adresses e-mail des pistes. |
| Comptes partenaires | Une valeur booléenne qui indique si l'entreprise a des comptes partenaires. La valeur par défaut est false. |
| Adresses e-mail non concordantes | Une collection d'adresses e-mail qui ne correspondent pas à un enregistrement de contact ou de piste. |
| Valeur | La valeur du champ Compte pour identifier un compte partenaire. |
Conditions d'erreur
| Condition d'erreur | Description |
|---|---|
| Aucun champ de compte | Si Comptes partenaires est Code d'erreur : REQUIRED_FIELD_MISSING |
| Aucun opérateur de comparaison | Si Comptes partenaires est Code d'erreur : REQUIRED_FIELD_MISSING |
| Aucune valeur | Si Comptes partenaires est Code d'erreur : REQUIRED_FIELD_MISSING |
Utilisation
Pour utiliser cette action, vous devez activer Synchroniser les e-mails en tant qu'activité Salesforce. L'action est principalement conçue pour être utilisée dans le cadre des activités suivantes: Mapper l’e-mail avec des enregistrements.
Fonctionnement
Cette action utilise en entrée l'ID d'e-mail, les adresses e-mail qui ne correspondent pas à un enregistrement utilisateur et les enregistrements utilisateur qui correspondent à une adresse e-mail dans De, À ou Cc du message. Si vous utilisez des partenaires dans votre processus commercial, les champs Comptes partenaires, Champ de compte, Opérateur de comparaison et Valeur capturent les critères que vous utilisez pour indiquer les comptes partenaires. Définissez les valeurs de ces champs dans la section Utilise des comptes partenaires des propriétés d'action de Flow Builder.
L'action interroge le champ E-mail dans les enregistrements Contact pour rechercher les enregistrements qui correspondent aux adresses e-mail dans l'entrée d'action. La liste des enregistrements utilisateur est utilisée pour aider à briser l'égalité lorsque plusieurs contacts sont trouvés.
Après avoir trouvé des enregistrements de contact, l'action interroge le champ E-mail dans les enregistrements Piste pour mapper les adresses e-mail restantes avec une piste. Les adresses e-mail qui ne correspondent pas à un contact ou à une piste sont stockées dans Adresses e-mail non concordantes en sortie.
Contact Tiebreakers
Si plusieurs contacts correspondent à une adresse e-mail, l'action suit cette logique.
Pour commencer, l'action vérifie le champ RecordTypeId dans chaque compte du contact. L'action interroge le champ Name dans l'objet RecordType. Si le Nom n'est pas un partenaire pour tous les enregistrements de contact correspondants, l'action considère qu'il s'agit d'un compte non partenaire. De la même façon, si le Nom est un partenaire pour tous les enregistrements de contact correspondants, l'action considère qu'il s'agit d'un compte partenaire. Pour déterminer le contact, l'action évalue ces règles dans l'ordre.
- Si la même adresse e-mail contient plus de 10 contacts, l'action sélectionne le contact dont la LastActivityDate est la plus récente. L'action ajoute ce contact aux Contacts dans la sortie de l'action.
- Si le propriétaire du compte d'un contact correspond à un enregistrement utilisateur dans Utilisateurs en entrée d'action, l'action sélectionne ce contact et l'ajoute à Contacts en sortie d'action.
- Si le propriétaire d'un contact correspond à un enregistrement utilisateur dans Utilisateurs en entrée d'action, l'action sélectionne ce contact et l'ajoute à Contacts en sortie d'action.
- Si les règles précédentes n'ont pas entraîné l'ajout d'un contact à la sortie, l'action sélectionne le contact qui a été récemment modifié. L'action ajoute ce contact aux Contacts dans la sortie de l'action.
Deuxièmement, si les enregistrements de contact correspondants ont une combinaison de valeurs de partenaire et de non-partenaire pour le champ Name dans l'objet RecordType, l'action évalue ces règles dans l'ordre.
- Si un autre contact correspond à une adresse e-mail différente dans l'e-mail et que ce contact appartient à un compte non partenaire, l'action ignore les contacts non partenaires. Pour déterminer le contact, l'action utilise les contacts partenaires et les évalue en fonction des règles de bris d'égalité des contacts. L'action ajoute le résultat à Contacts dans la sortie de l'action.
- Si la règle précédente n'a pas entraîné l'ajout d'un contact à la sortie, l'action utilise les contacts non partenaires et les évalue en fonction des règles de bris d'égalité des contacts. L'action ajoute le résultat à Contacts dans la sortie de l'action.
Bris d'égalité des pistes
Si une adresse e-mail ne correspond à aucun contact, l'action tente de la mapper avec une piste. Si plusieurs pistes correspondent à une adresse e-mail, l'action suit cette logique.
- Si le propriétaire d'une piste correspond à un enregistrement utilisateur dans l'entrée Utilisateurs, l'action sélectionne cette piste et l'ajoute à la sortie Pistes dans l'action.
- Si la règle précédente n'a pas entraîné l'ajout d'une piste à la sortie, l'action sélectionne la piste qui a été récemment modifiée. L'action ajoute cette piste à la sortie Pistes dans l'action.
Limites
Cette action est limitée à l'utilisation dans un flux. Il ne peut pas être invoqué via d'autres méthodes telles que Apex, l'API REST, Copilot, Prompt Studio ou les Robots Einstein. Bien que les actions puissent généralement être invoquées via diverses infrastructures telles que InvocableActionService, cette action spécifique est limitée uniquement à Flux.
Si le champ activityId est vide lors du débogage de cette action, utilisez la Developer Console pour interroger StagedEmail sur une valeur.
