Utilisation des actions Iterable dans les workflows d’actions

Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.

Mon édition

Suite, toutes les versions

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support

Team, Professional ou Enterprise

Résumé ◀▼

Vous pouvez connecter des workflows d’actions à Iterable en utilisant une clé API côté serveur pour automatiser la gestion des profils utilisateur, le suivi des événements, les commentaires et les campagnes par e-mail. Les actions incluent la création, la mise à jour et la recherche d’utilisateurs, l’envoi d’e-mails déclenchés et la gestion des campagnes. Utilisez un compte de service dédié pour l’intégration et spécifiez le bon centre de données pour garantir une authentification correcte et une automatisation fluide des workflows sur toutes les plateformes.

En connectant le créateur d’actions à des systèmes externes, comme Iterable, les administrateurs peuvent intégrer Zendesk à des systèmes externes dans des workflows automatisés, ce qui améliore la collaboration et permet d’assurer une expérience fluide et cohérente sur plusieurs plateformes.

Remarque – Les étapes associées aux systèmes externes dans des workflows d’actions sont appelées collectivement des actions externes.

Cet article aborde les sujets suivants :

• Connexion d’Iterable au créateur d’actions
• Utilisation des actions Iterable dans les workflows d’actions

Connexion d’Iterable au créateur d’actions

Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.

Lorsque vous vous connectez à des systèmes externes pour les utiliser dans des workflows d’actions, nous vous conseillons de suivre ces meilleures pratiques :

• Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.
• Toutes les intégrations nécessitent des portées obligatoires. Cependant, il est important d’examiner et de valider les portées avant de valider l’accès au système externe.
• Si vous gérez les identifiants pour les outils basés sur des clés API, comme OpenAI, nous vous conseillons de stocker les clés dans un gestionnaire d’identifiants ou un coffre-fort sécurisé.

Pour créer une clé API

La connexion Iterable nécessite une clé API côté serveur de votre projet Iterable. Les clés API en lecture seule ne fonctionneront pas. Assurez-vous de créer une clé API côté serveur avec les permissions d’écriture appropriées.

1. Connectez-vous à votre compte Iterable.
2. Allez à Integrations > API Keys.
3. Créez une nouvelle clé API côté serveur.
4. Enregistrez la clé ou laissez la fenêtre ouverte pour pouvoir la copier et la coller dans Zendesk.

   Vous en aurez besoin pour connecter Iterable au créateur d’actions.

Pour connecter le créateur d’actions à Iterable

1. Dans le Centre d’administration, cliquez sur Applications et intégrations () dans la barre latérale, puis sélectionnez Actions > Workflows d’actions.
2. Créez ou modifiez un workflow d’actions.
3. Ouvrez la barre latérale.
4. Sous Actions externes, cliquez sur Iterable.
5. Cliquez sur Connexion.
6. Suivez les prompts d’Iterable pour vous authentifier et terminer la connexion.
   • Saisissez votre clé API côté serveur Iterable.
   • Spécifiez la région de votre centre de données (États-Unis ou UE). Si votre compte Iterable est hébergé dans le centre de données de l’Union européenne, vous devez spécifier « EU » comme centre de données. Si vous laissez ce champ vide, la connexion utilise le centre de données américain (api.iterable.com) par défaut. L’utilisation du mauvais centre de données provoquera des échecs d’authentification.
   Remarque – Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.

Une fois que vous vous êtes connecté au système, vous verrez un indicateur de connexion et des détails sur l’instance à laquelle vous êtes connecté, ainsi que les actions disponibles pour Iterable.

Utilisation des actions Iterable dans les workflows d’actions

Les actions Iterable suivantes sont disponibles :

• Créer un utilisateur
• Mettre à jour l’utilisateur
• Rechercher un utilisateur
• Créer un événement
• Ajouter un commentaire
• Envoyer un e-mail à un utilisateur
• Rechercher une campagne
• Répertorier les campagnes

Création d’un utilisateur

Utilisez l’action Créer un utilisateur pour créer un nouveau profil utilisateur dans Iterable. Si l’utilisateur existe déjà, son profil sera mis à jour avec les informations fournies (comportement upsert, c.-à-d. mise à jour/insertion).

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoire : Email Facultatives : User ID, Data fields, Prefer user ID, Create new fields, Merge nested objects
Sortie	Statut de réussite, message, e-mail et identifiant utilisateur.

Mise à jour d’un utilisateur

Utilisez l’action Mettre à jour l’utilisateur pour mettre à jour un profil d’utilisateur existant dans Iterable. Si l’utilisateur n’existe pas, un nouveau profil sera créé avec les informations fournies (comportement upsert, c.-à-d. mise à jour/insertion).

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoire : Email Facultatives : User ID, Data fields, Prefer user ID, Create new fields, Merge nested objects
Sortie	Statut de réussite, message, e-mail et identifiant utilisateur.

Recherche d’un utilisateur

Utilisez l’action Rechercher un utilisateur pour récupérer un profil d’utilisateur par adresse e-mail ou identifiant utilisateur.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Identifier type, Identifier value
Sortie	Détails du profil utilisateur, notamment l’adresse e-mail, l’identifiant utilisateur, la date d’inscription, la date de mise à jour du profil et les champs de données personnalisés.

Création d’un événement

Utilisez l’action Créer un événement pour suivre un événement personnalisé pour un utilisateur dans Iterable. Les événements peuvent être utilisés pour la segmentation, les déclencheurs de campagne et les analyses.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Email, Event name Facultatives : User ID, Data fields, Event ID, Campaign, Template, Create new fields
Sortie	Statut de réussite, message, nom de l’événement, e-mail, identifiant utilisateur et ID de l’événement.

Ajout d’un commentaire

Utilisez l’action Ajouter un commentaire pour ajouter un commentaire ou une note à un profil d’utilisateur. Le commentaire est stocké sous la forme d’un champ personnalisé dans les champs de données de l’utilisateur.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Email, Comment Facultatives : User ID, Field name
Sortie	Statut de réussite, message, e-mail, identifiant utilisateur et nom du champ où le commentaire a été stocké.

Envoi d’un e-mail à un utilisateur

Utilisez l’action Envoyer un e-mail à l’utilisateur pour envoyer un e-mail déclenché à un utilisateur en utilisant une campagne Iterable. La campagne doit avoir un statut déclenchable.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Campaign, Recipient email Facultatives : Data fields, Send at
Sortie	Statut de réussite, message, identifiant de la campagne, e-mail du destinataire et heure d’envoi planifiée.

Recherche d’une campagne

Utilisez l’action Rechercher une campagne pour récupérer les détails de la campagne, notamment le nom, le statut, le type et les informations de modèle.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoire : Campaign
Sortie	Détails de la campagne, notamment l’identifiant, le nom, le statut, le type, l’identifiant du modèle, les identifiants des listes, l’heure d’envoi, la date de création et la date de mise à jour.

Répertorier les campagnes

Utilisez l’action Répertorier les campagnes pour récupérer toutes les campagnes de votre projet Iterable.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Aucune
Sortie	Tableau des objets de campagne contenant l’identifiant, le nom, le statut et le type, plus le nombre total.