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 vos workflows d’actions à Klaviyo à l’aide d’une clé API pour automatiser la gestion des profils client, le suivi des événements, les abonnements aux listes et la création de campagnes. Cette intégration prend en charge la création, la mise à jour et la recherche de profils, la gestion des listes et des mesures, ainsi que le traitement des campagnes. Utilisez un compte de service dédié pout sécuriser les connexions et vérifiez les permissions avec soin pour garder le contrôle des données et des actions effectuées par le biais de l’intégration.

En connectant le créateur d’actions à des systèmes externes, comme Klaviyo, les administrateurs peuvent intégrer Zendesk à des systèmes externes au sein de 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 de Klaviyo au créateur d’actions
  • Utilisation des actions Klaviyo dans les workflows d’actions

Connexion de Klaviyo 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 Klaviyo nécessite une clé API pour l’authentification. Pour en savoir plus, consultez la documentation sur les identifiants API Klaviyo.
Important : stockez votre API de manière sécurisée et ne la partagez pas. La clé vous permet d’accéder à votre compte Klaviyo et permet aux workflows d’actions de réaliser des opérations pour votre compte.
  1. Connectez-vous à votre compte Klaviyo.
  2. Allez à Settings > API Keys.
  3. Copiez la clé au format : Klaviyo-API-Key {votre_clé}
  4. Enregistrez la clé API ou laissez la fenêtre ouverte pour pouvoir la copier et la coller dans Zendesk.

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

Pour connecter le créateur d’actions à Klaviyo
  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 Klaviyo.
  5. Cliquez sur Connexion.
  6. Suivez les invites pour saisir votre clé API Klaviyo et finaliser la connexion. Collez la totalité de la clé, préfixe inclus.

    Quand vous autorisez la connexion, vous êtes redirigé vers Klaviyo pour accorder les permissions pour votre compte Zendesk.

    La connexion Klaviyo utilise OAuth 2.0 avec le type d’octroi Code d’autorisation. Vérifiez les permissions avec soin avant d’autoriser la connexion. Ces permissions permettent aux workflows d’actions de créer et de modifier des pages, d’ajouter des commentaires, de gérer les éléments de la base de données et de mettre le contenu à jour dans votre espace de travail Klaviyo pour votre compte.

    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 Klaviyo.

Utilisation des actions Klaviyo dans les workflows d’actions

Les actions Klaviyo suivantes sont disponibles :
  • Créer un profil
  • Mettre à jour le profil
  • Rechercher un profil
  • Créer un événement
  • Abonner le profil à la liste
  • Supprimer le profil de la liste
  • Rechercher une liste
  • Répertorier les listes
  • Créer une liste
  • Rechercher une mesure
  • Répertorier les mesures
  • Créer une campagne
  • Rechercher une campagne
  • Répertorier les campagnes

Création d’un profil

Utilisez l’action Créer un profil pour créer un nouveau profil client dans Klaviyo, avec des coordonnées et des attributs.

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

  Variables
Entrées Facultatives : Adresse e-mail, Numéro de téléphone, Prénom, Nom, Organisation, Titre, URL de l'image, Adresse (ligne 1), Adresse (ligne 2), Ville, Région/État, Pays, Code postal

Les numéros de téléphone doivent utiliser le format E.164 avec un signe +, un indicatif de pays et le numéro de l’abonné sans espaces ni caractères spéciaux (par ex. +15551234567).
Sortie Renvoie un objet contenant l’identifiant du profil, l’adresse e-mail, le numéro de téléphone, le prénom, le nom, l’organisation, le titre, l’image, les horodatages de création et de mise à jour, et l’objet d’emplacement géographique (avec adresse [ligne 1], adresse [ligne 2], ville, région, pays, code postal).

Mise à jour d’un profil

Utilisez l’action Mettre à jour le profil pour mettre à jour un profil existant dans Klaviyo avec de nouvelles informations.

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

  Variables
Entrées Obligatoire : Identifiant du profil

Facultatives : Adresse e-mail, Numéro de téléphone, Prénom, Nom, Organisation, Titre, URL de l'image, Adresse (ligne 1), Adresse (ligne 2), Ville, Région/État, Pays, Code postal

Les numéros de téléphone doivent utiliser le format E.164 avec un signe +, un indicatif de pays et le numéro de l’abonné sans espaces ni caractères spéciaux (par ex. +15551234567).
Sortie Renvoie un objet contenant l’identifiant du profil, l’adresse e-mail, le numéro de téléphone, le prénom, le nom, l’organisation, le titre, l’image, les horodatages de création et de mise à jour, et l’objet d’emplacement géographique (avec adresse [ligne 1], adresse [ligne 2], ville, région, pays, code postal).

Recherche d’un profil

Utilisez l’action Rechercher un profil pour récupérer un profil client unique par identifiant, adresse e-mail ou numéro de téléphone.

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

  Variables
Entrées Obligatoires : Identifier le profil par, Identifiant du profil

Vous pouvez identifier les profils par identifiant, adresse e-mail ou numéro de téléphone. Le champ Identifiant du profil devient visible une fois la méthode d’identification sélectionnée.
Sortie Renvoie un objet contenant l’identifiant du profil, l’adresse e-mail, le numéro de téléphone, le prénom, le nom, l’organisation, le titre, l’image, les horodatages de création et de mise à jour, et l’objet d’emplacement géographique (avec adresse [ligne 1], adresse [ligne 2], ville, région, pays, code postal).

Création d’un événement

Utilisez l’action Créer un événement dans Klaviyo pour déclencher des workflows et mesurer l’engagement.

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

  Variables
Entrées Obligatoires : Nom de la mesure, Identifiant du profil

Facultatives : Propriétés, Horodatage

Vous devez fournir les propriétés sous la forme de paires clé-valeur au format JSON. L’horodatage doit utiliser le format ISO 8601 (2025-01-15T14:30:00Z, par exemple). S’il n’est pas spécifié, il utilise l’heure actuelle par défaut.
Sortie Renvoie un objet contenant le nom de la mesure, l’identifiant du profil et l’objet de propriétés.

Abonnement d’un profil à une liste

Utilisez l’action Abonner le profil à la liste pour ajouter un profil à une liste, avec des paramètres de consentement facultatifs pour les SMS et les e-mails.

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

  Variables
Entrées Obligatoire : Liste

Facultatives : Adresse e-mail, Numéro de téléphone, Identifiant du profil, Consentement pour les e-mails, Consentement pour les SMS

Les numéros de téléphone doivent être au format E.164. Les options de consentement pour les e-mails et les SMS incluent Oui - S’abonner aux e-mails/SMS (ABONNÉ) ou Non - Ne pas s’abonner aux e-mails/SMS (AUCUN).
Sortie Renvoie un objet contenant le statut de réussite (booléen) et un message.

Suppression d’un profil d’une liste

Utilisez l’action Supprimer le profil de la liste pour supprimer un profil d’une liste spécifique dans Klaviyo.

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

  Variables
Entrées Obligatoires : Liste, Identifiant du profil
Sortie Renvoie un objet contenant le statut de réussite (booléen) et un message.

Recherche d’une liste

Utilisez l’action Rechercher une liste pour récupérer les détails d’une liste spécifique par identifiant ou par nom.

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

  Variables
Entrées Obligatoires : Identifier la liste par, Identifiant de liste

Vous pouvez identifier les listes par identifiant ou par nom. Le champ Identifiant de liste devient visible une fois la méthode d’identification sélectionnée.
Sortie Renvoie un objet contenant l’identifiant de la liste, son nom, les horodatages de création et de mise à jour et le processus d’acceptation.

Répertorier les listes

Utilisez l’action Répertorier les listes pour récupérer toutes les listes dans Klaviyo avec filtrage des noms et pagination facultatifs.

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

  Variables
Entrées

Facultatives : Nom, Curseur de page
Sortie Renvoie un objet contenant un tableau de listes (chacune avec identifiant, nom, horodatages de création et de mise à jour, et processus d’acceptation) et le curseur de page suivante pour la pagination.

Création d’une liste

Utilisez l’action Créer une liste pour créer une nouvelle liste dans Klaviyo pour organiser les profils.

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

  Variables
Entrées

Obligatoire : Nom
Sortie Renvoie un objet contenant l’identifiant de la liste, son nom, les horodatages de création et de mise à jour et le processus d’acceptation.

Recherche d’une mesure

Utilisez l’action Rechercher une mesure pour récupérer les détails d’une mesure spécifique par identifiant.

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

  Variables
Entrées

Obligatoire : Identifiant de la mesure
Sortie Renvoie un objet contenant l’identifiant de la mesure, le nom, les horodatages de création et de mise à jour et l’objet de l’intégration (avec identifiant, nom et catégorie).

Répertorier les mesures

Utilisez l’action Répertorier les mesures pour récupérer toutes les mesures dans Klaviyo avec filtrage et pagination facultatifs. Utilisez cette action pour découvrir les mesures d’événement disponibles pour suivre le comportement des clients.

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

  Variables
Entrées

Facultatives : Nom de l'intégration, Catégorie de l'intégration, Curseur de page
Sortie Renvoie un objet contenant un tableau de mesures (chacune avec identifiant, nom, horodatages de création et de mise à jour, et objet de l’intégration avec identifiant, nom et catégorie) et le curseur de page suivante pour la pagination.

Création d’une campagne

Utilisez l’action Créer une campagne pour créer une nouvelle campagne marketing dans Klaviyo avec le canal d’e-mail ou de SMS.

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

  Variables
Entrées

Obligatoires : Nom, Liste, Canal, Stratégie d'envoi

Facultatives : Sujet, Aperçu du texte, Adresse e-mail de l’expéditeur, Nom de l’expéditeur, Adresse e-mail de réponse

Les options de canaux sont E-mail et SMS.

Les options de stratégie d’envoi incluent Immédiat, Planifié (statique), Accéléré et Heure d’envoi intelligente. La ligne de sujet est obligatoire pour les campagnes par e-mail.
Sortie Renvoie un objet contenant l’identifiant de la campagne, son nom, son statut, le canal, les horodatages de création et de mise à jour et l’heure d’envoi.

Recherche d’une campagne

Utilisez l’action Rechercher une campagne pour récupérer les détails d’une campagne spécifique par identifiant ou par nom.

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

  Variables
Entrées

Obligatoires : Identifier la campagne par, Identifiant de campagne

Si vous effectuez une recherche par nom (contient), la recherche renvoie la première correspondance.

Le champ Identifiant de campagne devient visible une fois la méthode d’identification sélectionnée.
Sortie Renvoie un objet contenant l’identifiant de la campagne, son nom, son statut, le canal, les horodatages de création et de mise à jour, l’heure d’envoi et le statut d’archivage (booléen).

Répertorier les campagnes

Utilisez l’action Répertorier les campagnes pour récupérer les campagnes dans Klaviyo avec filtrage et pagination facultatifs.

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

  Variables
Entrées

Obligatoire : Canal

Facultatives : Nom, Statut, Archivé, Curseur de page

Les options de statut incluent Brouillon, Planifié, Envoyé et Annulé.

Le filtre Archivé accepte Oui ou Non.
Sortie Renvoie un objet contenant un tableau de campagnes (chacune avec identifiant, nom, statut, horodatages de création et de mise à jour, heure d’envoi et statut d’archivage) et le curseur de page suivante pour la pagination.
Réalisé par Zendesk