Comprendre les différents webhooks disponibles dans Klaviyo

Objectif de cet article

Découvrez les différences entre les solutions de webhook disponibles dans Klaviyo, et à quel moment vous devriez utiliser chacune d’elles.

Avant de commencer

Qu’est-ce qu’un webhook ?

Les webhooks permettent à Klaviyo de transmettre des informations ou « d’appeler » d’autres applications, outils et serveurs via des requêtes HTTP. Ils peuvent envoyer des données sur un événement qui s’est produit (par exemple, une commande passée, un nouvel abonné, etc.) ou informer vos systèmes externes que l’événement s’est produit.

Les webhooks se composent de quelques éléments clés :

• Sujet
  L’événement qui déclenche un webhook.
• Corps (ou « la charge utile »)
  Les données envoyées par le webhook.
• En-tête
  L’emplacement pour transmettre des informations supplémentaires (d’authentification, par exemple).

Webhooks de flux

Vous pouvez ajouter des webhook dans les flux en tant qu’action qui se produit lorsque le flux atteint une certaine étape. Une fois qu’un flux atteint l’action webhook, une requête POST est envoyée avec des données sur l’événement ou le destinataire qui a déclenché le flux, selon la manière dont vous construisez le payload.

Les webhook de flux ne peuvent envoyer que sur la base d’événements déclenchés par le flux (c.-à-d. des événements pouvant être utilisés comme déclencheur de flux). De plus, les webhook de flux ne prennent pas en charge les événements liés aux messages (p. ex., E-mail reçu, E-mail cliqué, E-mail marqué comme spam), car les flux se terminent généralement par la réception d’un message.

Exemples de cas d’utilisation pour les webhooks de flux

Voici quelques exemples de cas d’utilisation où les webhooks de flux seraient les plus efficaces :

• Envoyez un message ou une requête POST qui se déclenche lorsqu’un abonné est ajouté à un segment ou à une liste.
• Automatisez les suspensions lorsqu’un profil entre dans un segment non engagé.
• Envoyez un message de remerciement personnalisé via un service comme Whatsapp ou Facebook Messenger lorsque les clients achètent.

Webhooks dans Advanced Klaviyo Data Platform

Les webhook dans Advanced Klaviyo Data Platform vous permettent de notifier des systèmes externes en réponse à des événements, sans dépendre d’une série d’étapes menant à l’action webhook. Les webhook Advanced Klaviyo Data Platform ne nécessitent pas de construire manuellement ni de spécifier le corps de la requête webhook. Si vous souhaitez notifier vos systèmes externes qu’un événement s’est produit sans développement personnalisé, les webhook dans Advanced Klaviyo Data Platform sont les plus efficaces.

Les webhooks Advanced Klaviyo Data Platform prennent également en charge un plus large éventail de sujets pour déclencher la requête et vous permettent d’envoyer des informations en réponse à tout événement pouvant être interrogé via l’ API Get Events.

En voici quelques exemples :

• Événements liés aux e-mails (par exemple, courriel reçu, courriel cliqué, courriel marqué comme spam)
• Événements liés aux SMS (par exemple, SMS Envoyé, SMS Reçu)
• Événements liés aux notifications push (par exemple, Push Reçue, Rebond de Push)
• Événements provenant d’intégrations (c’est-à-dire les événements provenant d’intégrations first-party créées par Klaviyo)
• Événements d’API (par exemple, les événements synchronisés via les API de Klaviyo).

Cela inclut des événements liés aux messages, tels que se désabonner, E-mail reçu ou E-mail cliqué, qui ne sont pas pris en charge par les webhooks de flux.

De plus, les webhooks Advanced Klaviyo Data Platform vous permettent de vous abonner à plusieurs déclencheurs à la fois, contrairement aux webhooks de flux, qui dépendent de flux à déclencheur unique.

Exemples de cas d’utilisation des webhooks Advanced Klaviyo Data Platform

• Synchronisez les événements se désabonner des clients vers des systèmes externes.
• Signalez les événements liés aux e-mails reçus au logiciel du service d'assistance afin que les agents puissent consulter l'historique des e-mails et ainsi mieux servir les clients.
• Synchronisez tous les envois, ouvertures et clics d’e-mail dans un entrepôt de données qui n’est pas pris en charge par la synchronisation vers un entrepôt de données de Klaviyo.

Code

Code est une fonctionnalité incluse dans Klaviyo Advanced Klaviyo Data Platform. Advanced Klaviyo Data Platform n’est pas inclus dans l’application marketing standard de Klaviyo, et un abonnement Advanced Klaviyo Data Platform est nécessaire pour accéder aux fonctionnalités associées. Consultez notre guide de facturation pour en savoir plus sur l’ajout de cette fonctionnalité à votre abonnement ou notre guide de démarrage si vous êtes un nouveau client.

Le code exploite les webhooks pour permettre l’exécution de fonctions personnalisées en réponse au déclenchement d’un événement. Vous pouvez écrire du code directement dans l’éditeur de Klaviyo, et Klaviyo gère l’exécution du code, la surveillance et la journalisation.

Si vous souhaitez envoyer des requêtes à vos systèmes externes sans héberger un point de terminaison HTTP public, vous pouvez utiliser Code. De plus, si vous souhaitez exécuter des fonctions personnalisées en réponse à un événement, vous devez utiliser Code plutôt que les autres solutions de webhook disponibles dans Klaviyo.

Le code prend également en charge un niveau de granularité plus fin grâce aux déclencheurs d’événements via des webhook dans Advanced Klaviyo Data Platform. Vous pouvez sélectionner des indicateurs individuels à traiter comme sujet plutôt que tous les événements d’intégrations ou d’API.

Exemples de cas d’utilisation du code

• Importez des bibliothèques JSON Python pour analyser les charges utiles d’événements et extraire des informations.
• Définissez des propriétés de profil personnalisées en fonction des métadonnées d’événements à l’aide des API de Klaviyo.
• Importez des bibliothèques chatGPT et créez un message personnalisé pour chaque panier abandonné en fonction du profil et des articles dans le panier.

Ressources supplémentaires