Comprendre les webhooks dans les flux

Objectif de cet article

Découvrez les webhooks dans les flux et comment ils envoient des informations de Klaviyo vers vos outils et applications tiers. Il est important de noter que la configuration des webhooks peut être complexe. Il est conseillé de disposer de connaissances en développement ou de ressources de développement pour terminer correctement cette configuration. Si vous recherchez ces consignes de développement, découvrez comment ajouter une action webhook à un flux.

Qu’est-ce qu’un webhook ?

En bref, les webhooks constituent un moyen complet pour permettre à tous vos outils marketing et de données de communiquer entre eux. À titre d’exemple, imaginons comment fonctionnent les services bancaires en ligne et la protection contre la fraude sur votre carte de crédit. Si quelqu’un utilise frauduleusement votre carte, cette transaction est enregistrée chez le détaillant, puis transmise à votre banque, qui l’analyse ensuite et vous alerte par téléphone ou par e-mail lorsqu’il y a un problème avec votre carte. Cet achat a déclenché une série de communications entre systèmes, le transfert de ces données et, au final, une alerte. Ces systèmes utilisent très probablement des webhooks pour transmettre ces données. webhook:

• Permettez à votre application de transmettre des informations ou « d’appeler » d’autres applications, outils et serveurs via une requête HTTP.
• Envoyer des informations sur un événement qui s’est produit (par exemple, une commande passée, un nouveau client abonné, etc.).
• Peut indiquer à votre système qu’un événement s’est produit ou vous notifier de cet événement.

Ces informations sur l’événement seront ensuite transmises selon la méthode et à l’emplacement de votre choix. En d’autres termes, les webhooks offrent des moyens précieux de partager des données et des informations depuis Klaviyo vers vos autres outils marketing, de la manière qui vous convient.

Composants clés des webhooks

Les webhooks se composent de quelques éléments :

• Déclencheur
  L’événement qui déclenche un webhook
• Message (ou « la charge utile »)
  Ce que le webhook envoie, comme des informations clés sur l’événement déclencheur, l’URL où le message est envoyé ou l’URL du système qui reçoit le message
• En-tête
  L’emplacement pour transmettre des informations supplémentaires (d’authentification, par exemple).

Webhooks dans les flux

Les webhooks ne sont actuellement disponibles que dans les flux et envoient des données lorsqu’un flux atteint un certain stade ou une certaine étape. Le webhook envoie ensuite une requête POST avec des données sur l’événement ou le destinataire qui a déclenché le flux.

Il est important de noter qu’un seul événement peut déclencher l’envoi du webhook. Lorsqu’un abonné répond aux critères de déclenchement, le webhook se déclenchera et enverra le message à l’URL désignée. De plus, vous ne pouvez envoyer des webhooks qu’à partir d’événements déclencheurs de flux, c’est-à-dire des événements qui peuvent être utilisés comme déclencheur de flux. Par exemple, vous ne pouvez pas envoyer un webhook à partir de la modification d’une propriété de profil, car un flux ne peut pas se déclencher directement à partir de modifications de profil.
Exemples d’événements dans Klaviyo :

• Commande passée
• Début de commande
• Abonnement à une liste

Cas d’utilisation des webhooks

Il est essentiel de comprendre les déclencheurs de flux qui peuvent générer des webhooks, ainsi que quelques cas d’usage pratiques sur la façon de les implémenter avec vos autres applications.

Voici quelques exemples :

• Envoi d’un message pour réengager les clients inactifs.
• Envoyer un message le jour de l’anniversaire de vos clients et leur offrir un cadeau sous forme de points de fidélité.
• Envoi du webhook chaque fois qu’un nouvel abonné rejoint vos listes. Vous pouvez envoyer les données de son profil vers une autre plateforme.
• Envoyer à un client une enquête NPS afin d’en savoir plus sur vos abonnés.
• Envoi d’un message ou d’une requête POST qui se déclenche lorsqu’un abonné est ajouté à un segment ou à une liste. Cependant, notez que nous ne prenons pas en charge l’événement « Received Email" » comme déclencheur de flux.

Exemple concret

Vous décidez de connecter Klaviyo à votre outil de publipostage afin de pouvoir communiquer avec les clients en ligne et par courrier. Votre nouveau client Shah s’est rendu sur votre site web et a acheté quelques articles dans votre boutique e-commerce. Vous souhaitez envoyer à Shah un catalogue imprimé de l’intégralité de votre collection à l’avenir.

C’est là que le webhook peut relier ces expériences entre elles. Vous auriez déjà intégré votre boutique e-commerce à Klaviyo. Dans Klaviyo, vous configurez un flux pour qu’il se déclenche en fonction de l’événement Placed Order. Vous nous fourniriez ensuite le webhook de l’outil de publipostage par courrier et incluriez dans le message des informations telles que le nom et l’adresse du client, ainsi que ce qu’il a commandé (c’est-à-dire la charge utile).

Désormais, chaque fois qu’une personne (comme Shah) passe une commande, un évènement pourrait déclencher l’envoi d’un catalogue imprimé à son adresse. L’événement d’achat webhook invitera à envoyer des informations à votre outil de publipostage en quasi temps réel directement depuis Klaviyo (c’est-à-dire le message ou la charge utile).

Que ne peuvent pas faire les webhooks Klaviyo ?

Les webhooks ne sont pas conçus pour permettre une synchronisation bidirectionnelle des données. Cela signifie que, bien que vous puissiez connecter d'autres plateformes à Klaviyo pour leur envoyer des données, vous ne pouvez pas renvoyer de données à Klaviyo. L'information circulera de Klaviyo vers les systèmes ou applications désignés auxquels vous vous êtes connecté, mais ne pourra pas circuler dans l'autre sens. Les webhooks, contrairement aux API, ne fonctionnent que dans une seule direction.

Il est également important de prendre en compte les événements que vous choisissez de déclencher, la fréquence à laquelle ils se produisent et la destination finale des données dans votre système. Klaviyo fournira le cadre nécessaire pour connecter les données de vos flux à une plateforme, mais la valeur finale dépend de la destination de ces informations une fois qu'elles ont quitté Klaviyo, et de ce qu'elles peuvent potentiellement susciter. Par conséquent, Klaviyo peut uniquement contrôler si le webhook fonctionne, mais pas où vont les données ni ce qu'elles font une fois qu'elles ont quitté notre système.

Enfin, il est important de considérer les données que Klaviyo peut et ne peut pas envoyer via un webhook. Klaviyo ne peut pas envoyer certains points de données par le biais d'un webhook en raison de la manière dont nos déclencheurs de flux fonctionnent. Par exemple, nous ne pouvons pas envoyer de données sur l'engagement d'ouverture d'un courriel à chaque fois qu'un abonné ouvre un courriel, car vous ne pouvez pas déclencher un flux sur la base des ouvertures.

De même, si vous pouvez utiliser des variables dynamiques basées sur des événements dans la charge utile de votre webhook dans un flux déclenché par un événement, les variables disponibles sont liées à l’événement original qui a déclenché le flux (c.-à-d. tout comme pour les e-mails de flux). Par exemple, si vous avez un flux de panier abandonné déclenché par l’événement Started Checkout, vous pouvez utiliser les variables dynamiques de cet événement dans la charge utile des webhooks. Mais si, dans le même flux, vous utilisez également un filtre de flux ou un fractionnement utilisant un indicateur Added to Cart, vous ne pouvez pas inclure ces données supplémentaires dans la charge utile du webhook.

Par conséquent, lorsque vous configurez vos webhooks, il est important de tenir compte des flux que vous pouvez prendre en charge pour les points de données et de ce que vous cherchez à réaliser dans votre configuration de webhook.

Actuellement, les codes de réduction, les flux web et les flux de produits ne sont pas pris en charge dans les webhooks de flux.

Qui doit configurer des webhooks ?

Comme indiqué ci-dessus, les systèmes que vous connectez à Klaviyo, la manière dont les informations ou les données sont regroupées, ainsi que les données ou informations que vous choisissez de récupérer, relèvent entièrement de votre choix.

Dans cette optique, nous recommandons vivement de recourir à une ressource de développement pour configurer des webhook afin de vous assurer que les bons événements sont envoyés depuis Klaviyo et sont correctement publiés dans votre application. Klaviyo vous fournira également des erreurs si un webhook échoue. Cependant, il se peut que nous ne soyons pas en mesure de diagnostiquer des problèmes plus profonds liés à la configuration du webhook, ni la façon dont les données sont finalement publiées dans votre application.

Conditions requises et informations importantes

En plus de vous assurer de disposer d’une ressource de développement pour configurer correctement votre webhook et le tester sur votre système associé, Klaviyo a certaines exigences clés pour utiliser cette fonctionnalité :

• Seuls les rôles utilisateur qui ont accès à la création de flux peuvent configurer des webhooks dans Klaviyo. Cela inclut les rôles de gestionnaire, d’administrateur et de propriétaire.
• Pour plus de sécurité, l’authentification en deux étapes doit être activée dans votre compte afin d’utiliser des webhooks ou d’ajouter de nouvelles actions webhook dans un flux existant.

Prêt à configurer ?

Les webhooks fournissent des mécanismes puissants pour communiquer des données de Klaviyo vers vos autres systèmes ou applications externes. Si vous êtes prêt à configurer vos webhooks, vous pouvez consulter notre guide de documentation pour les développeurs sur Comment ajouter une action webhook à un flux.