Vous apprendrez
Découvrez les webhooks dans les flux et comment ils envoient des informations de Klaviyo à vos outils et applications tiers. Il est important de noter que la mise en place de webhooks peut être complexe. Il est conseillé d'avoir des connaissances ou des ressources en matière de développement pour effectuer correctement cette configuration. Si vous êtes à la recherche de ces orientations de développement, apprenez à ajouter une action webhook à un flux.
Que sont les webhooks ?Que sont les webhooks ?
En d'autres termes, les webhooks permettent à tous vos outils de marketing et de données de communiquer entre eux. A titre d'exemple, imaginons le fonctionnement des services bancaires en ligne et de la protection contre la fraude de votre carte de crédit. Si quelqu'un utilise frauduleusement votre carte, la transaction est enregistrée chez le détaillant, puis envoyée à votre banque, qui l'analyse et vous alerte par téléphone ou par courrier électronique en cas de problème avec votre carte. Cet achat a incité une série de systèmes à communiquer, à déplacer ces données et, finalement, à vous alerter. Ces systèmes utilisent très probablement des webhooks pour transmettre ces données.
Les webhooks permettent à votre application de transmettre des informations ou d'"appeler" d'autres applications, outils et serveurs via une requête HTTP. Les webhooks envoient des informations sur un événement qui s'est produit (par exemple, une commande passée, un nouveau client abonné, etc.) Les webhooks peuvent indiquer à votre système qu'un événement s'est produit ou vous avertir de cet événement.
Ces informations sur l'événement vous seront ensuite communiquées de la manière et à l'endroit de votre choix. En d'autres termes, les webhooks offrent de précieux moyens de partager des données et des informations à partir de Klaviyo, vers vos autres outils de marketing, de la manière qui vous convient le mieux.
Vous ne devez pas utiliser les webhooks pour abonner des profils à de nouvelles listes.
Principaux éléments des webhooks
Les webhooks sont constitués de plusieurs éléments :
-
Déclencheur
l'événement qui provoque le déclenchement d'un webhook -
Message (ou "charge utile")
ce que le webhook envoie, par exemple 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
un endroit pour transmettre des informations supplémentaires (telles que l'authentification)
Les webhooks dans les flux
Les webhooks ne sont actuellement disponibles qu'au sein des flux, et sont envoyés lorsqu'un flux atteint une certaine étape. Le webhook envoie alors une requête POST contenant 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éclenche et envoie le message à l'URL désignée. En outre, vous ne pouvez envoyer des webhooks qu'à partir d'événements déclenchés par un flux, c'est-à-dire des événements qui peuvent être utilisés comme déclencheurs de flux. Par exemple, vous ne pouvez pas envoyer un webhook à la suite d'un changement de propriété d'un profil, car un flux ne peut pas être déclenché directement par des changements de profil.
Voici quelques exemples d'événements organisés à Klaviyo :
- Commande passée
- Début de l'encaissement
- Abonné à la 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 certains cas d'utilisation pratiques sur la façon de les mettre en œuvre avec vos autres applications.
En voici quelques exemples :
- Envoi d'un message pour relancer les clients qui n'ont plus d'ancienneté
- Envoyer un message à l'occasion de l'anniversaire de vos clients et leur offrir un cadeau sous forme de points de fidélité.
- Envoyer le webhook chaque fois qu'un nouvel abonné rejoint vos listes. Vous pouvez envoyer les données de leur profil à votre CDP ou CRM, de sorte que vous disposiez toujours d'un enregistrement complet des abonnés de votre compte.
- Envoyer à un client une enquête NPS pour 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 (par exemple, un client qui passe une commande). Notez toutefois que nous ne prenons pas en charge l'événement "Received Email" " en tant que déclencheur de flux.
Exemple concret
Vous décidez de connecter Klaviyo à votre outil de publipostage afin de pouvoir communiquer avec vos 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 de commerce électronique. Vous souhaitez envoyer à Shah un catalogue imprimé de votre collection complète à l'avenir.
C'est ici que le webhook peut relier ces expériences. Votre boutique de commerce électronique est déjà intégrée à Klaviyo. Dans Klaviyo, vous configurez un flux qui se déclenche en fonction de l'événement Commande passée. Vous nous fournirez alors le webhook de l'outil de publipostage et inclurez 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 du webhook va déclencher l'envoi d'informations à votre outil de publipostage en temps réel potentiel directement depuis Klaviyo (c'est-à-dire le message ou la charge utile).
Qu'est-ce que les webhooks de Klaviyo ne peuvent pas faire ?
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 votre charge utile de 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. comme pour les e-mails de flux). Par exemple, si vous avez un flux Abandoned Cart déclenché par l'événement Started Checkout, vous pouvez utiliser des 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 une division utilisant une mesure 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 coupon, les flux web et les flux de produits ne sont pas pris en charge dans les webhooks de flux.
Qui doit mettre en place des webhooks ?
Comme indiqué ci-dessus, les systèmes que vous connectez à Klaviyo, la manière dont les informations ou les données sont présentées, et les données ou informations que vous choisissez de saisir, sont entièrement à votre discrétion.
Dans cette optique, nous recommandons vivement à une ressource de développement de mettre en place des webhooks afin de s'assurer que les bons événements sont envoyés par Klaviyo et qu'ils s'affichent correctement 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 ou à la manière dont les données sont finalement envoyées à votre application. Nous vous conseillons de consulter notre guide Comment ajouter une action Webhook à un flux pour vous assurer que vous avez correctement configuré l'action.
Exigences et considérations relatives aux Webhooks de Klaviyo
Outre le fait que vous devez vous assurer que vous disposez d'un développeur pour configurer correctement votre webhook et le tester sur votre système d'accompagnement, Klaviyo a quelques exigences clés pour l'utilisation de cette fonctionnalité.
- Seuls les rôles d'utilisateur qui ont accès à la création de flux peuvent configurer des webhooks dans Klaviyo. Cela inclut les rôles de Manager, Admin et Owner.
- Pour plus de sécurité, l 'authentification en deux étapes doit être activée dans votre compte afin d'utiliser les webhooks ou d'ajouter de nouvelles actions webhook dans un flux existant.
Vous êtes prêt à vous installer ?
Les Webooks fournissent des mécanismes puissants pour communiquer des données de Klaviyo à vos autres systèmes ou applications marketing externes. Si vous êtes prêt à configurer vos webhooks, vous pouvez lire notre guide de documentation pour les développeurs sur Comment ajouter une action Webhook à un flux.
Ressources complémentaires