Travailler avec les contacts et les audiences
Les nœuds de contact et d'audience permettent à un workflow de lire les informations client et de modifier des enregistrements ou des appartenances. Ils opèrent sur les ressources de l'espace de travail de l'automatisation.
Automations is in Early access. Your workspace permissions determine which actions you can perform.
Rechercher et utiliser un contact
- Ajoutez Get contact lorsque vous disposez d'un identifiant de contact, ou List contacts lorsque vous devez effectuer une recherche par filtres pris en charge.
- Mappez l'identifiant ou la valeur de recherche depuis votre déclencheur.
- Pour une liste, ajoutez un Branch afin de distinguer un résultat vide d'un contact trouvé.
- Mappez les champs du contact sélectionné dans l'étape suivante.
Une recherche réussie mais vide est un résultat à traiter. Elle ne suit pas le chemin d'échec de l'action. Utilisez ce chemin pour une lecture rejetée ou échouée.
Les nœuds de liste renvoient une seule page. Un curseur de page suivante indique que d'autres enregistrements peuvent exister. Ni List contacts ni List audience contacts ne parcourent automatiquement les pages suivantes et n'exécutent une action ultérieure pour chaque contact.
Créer ou mettre à jour des enregistrements
Utilisez Create contact pour un nouvel enregistrement et Update contact pour un enregistrement connu. Une recherche suivie d'une création n'est pas une opération atomique : un autre processus peut créer un contact correspondant entre ces étapes. Traitez un conflit de création au lieu de supposer que le nouveau contact existe.
Create or update contacts accepte un lot préparé. Inspectez le résultat de chaque entrée : une entrée peut échouer tandis que d'autres sont créées ou mises à jour. Un nœud réussi ne signifie pas que chaque entrée du lot a réussi, et les modifications réussies ne sont pas annulées lorsqu'une autre entrée échoue.
Des entrées et résultats volumineux peuvent dépasser les limites de données de l'automatisation même si le produit Contacts accepte un lot plus grand. Utilisez un lot préparé plus petit si la validation ou l'exécution signale une valeur surdimensionnée.
Gérer les appartenances aux audiences statiques
- Sélectionnez une audience existante, ou ajoutez Create audience pour en créer une dans le cadre du workflow.
- Utilisez Add contacts to audience, Remove contact from audience ou Remove contacts from audience avec des identifiants de contact explicites.
- Inspectez le résultat de l'action et traitez les échecs avant de continuer.
La suppression d'une appartenance conserve le contact. L'ajout à une audience et la suppression d'une autre sont des opérations distinctes : un échec entre les deux peut laisser le contact dans les deux audiences. Prévoyez le chemin d'échec pour l'état qui nécessite une attention.
Utilisez Get audience et Update audience pour lire ou modifier l'audience elle-même. Ces nœuds ne créent pas un instantané de ses membres et ne transforment pas le workflow en diffusion.
Supprimer un contact délibérément
Utilisez Delete contact pour supprimer définitivement le contact et ses appartenances aux audiences.
Les enregistrements de préférence et de suppression associés à l'adresse de canal de la personne peuvent subsister. Supprimer puis recréer un contact ne supprime pas un désabonnement ou un blocage de livraison.
Étapes suivantes
- Utiliser les préférences et les recherches.
- Utiliser les données des étapes précédentes.
- Prévisualiser et vérifier un workflow.
- Parcourir les guides Automations.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.