Comprendre les webhooks dans les flux

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 ?

En d'autres termes, les webhooks permettent à tous vos outils de marketing et de données de communiquer entre eux. Imaginons par exemple 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. Webhooks

• Les webhooks permettent à Klaviyo de transmettre des informations ou « d’appeler » d’autres applications, outils et serveurs via des requêtes HTTP.
• Envoyer des informations sur un événement qui s'est produit (par exemple, une commande passée, un nouveau client qui s'abonne, etc.)
• Peut 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 et de la manière que vous jugez la plus appropriée.

Principaux éléments des webhooks

Les webhooks sont constitués de plusieurs éléments :

• Sujet
  L’événement qui déclenche un webhook.
• Message (ou "charge utile")
  Ce que le webhook envoie, comme des détails 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).

Les webhooks dans les flux

Les webhooks ne sont actuellement disponibles qu'au sein de Flux, et sont envoyés lorsqu'un flux communique auprès d'une certaine étape. Le site webhook envoie alors une requête POST contenant les données relatives à l'événement ou aux destinataires qui ont 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 le 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 à partir d'un changement de propriétés de profil, car un flux ne peut pas se déclencher directement à partir d'un changement 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 de webhook

Il est essentiel de comprendre les déclencheurs de flux qui peuvent générer des webhooks, ainsi que quelques cas d'utilisation pratiques sur la façon de les mettre en œuvre avec vos autres applications.

Voici quelques exemples :

• Envoyer un message pour re-développer l'engagement lapsed client.
• Envoyer un message à l'occasion de l'anniversaire de votre client et lui offrir un cadeau sous forme de points de fidélité.
• Envoi du site webhook chaque fois qu'un nouvel abonné s'ajoute à votre liste. Vous pouvez envoyer leurs données de profil vers une autre plateforme.
• Envoyer à un client une enquête NPS pour en savoir plus sur votre abonné.
• Envoi d'un message ou d'une requête POST qui se déclenche lorsqu'un abonné est ajouté à un segment ou à une liste. Notez toutefois que nous n'assistons pas 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 est allé 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. Vous avez déjà intégré votre boutique de commerce électronique dans Klaviyo. Dans Klaviyo, vous configurez un flux qui se déclenche en fonction de l'événement Commande passée. Vous nous fournirez alors l'adresse webhook de l'outil de publipostage par courrier et vous indiquerez le nom du client, son adresse et ce qu'il a commandé dans le message (c.-à-d. 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. 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 personne chargée du développement de mettre en place un webhook afin de s'assurer que les bons événements sont envoyés depuis Klaviyo et qu'ils sont correctement affiché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 ou à la manière dont les données sont finalement envoyées à votre application. 

Conditions requises et informations importantes

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 externes. Si vous êtes prêt à configurer votre webhook, vous pouvez consulter notre guide de documentation pour les développeurs sur la façon d'ajouter une action webhook à un flux.

Ressources supplémentaires

• Comprendre les déclencheurs et les filtres de flux
• Comment prévisualiser la configuration d'un déclencheur de flux
• Comment ajouter une action webhook à un flux ?