Les webhooks vous permettent d'étendre les capacités d'automatisation d'Omnisend en connectant des systèmes et services externes. Ils vous permettent de déclencher des événements dans d'autres plateformes ou d'envoyer des données en temps réel, améliorant la fonctionnalité de vos flux de travail d'automatisation.
Dans ce guide, nous vous expliquerons comment configurer et utiliser les webhooks dans les automatisations Omnisend, avec des exemples et des cas d'utilisation.
⚠️ Disponibilité du forfait : Les webhooks dans les automatisations sont disponibles uniquement avec les forfaits payants. Pour utiliser cette fonctionnalité, mettez à niveau votre forfait sous Paramètres de la Boutique → Facturation.
⚠️ Important : La mise en œuvre des webhooks demande un effort considérable de votre part et nécessite souvent l'implication d'un développeur. Vous devrez peut-être préparer des points de terminaison d'API dédiés, gérer les charges utiles et assurer une Intégration appropriée entre Omnisend et les systèmes externes.
Que sont les Webhooks ?
Les webhooks sont des rappels HTTP qui envoient des données en temps réel d'Omnisend à d'autres services lorsque des événements d'automatisation spécifiques se produisent. Cela vous permet de :
Informer les systèmes tiers des événements d'automatisation.
Envoyez des messages personnalisés via des plateformes comme WhatsApp.
Déclenchez des flux de travail personnalisés dans les CRM, les outils de gestion de projet ou les plateformes de communication comme Slack.
Analogie 💡 Un système de bipeur de restaurant
Imaginez que vous êtes dans un restaurant et qu'on vous donne un bipeur pour vous avertir lorsque votre table est prête. Ce téléavertisseur est comme un webhook, vous alertant d'événements spécifiques sans que vous ayez à vérifier manuellement.
Comprendre la structure et les composants d'un Webhook
Lors de la configuration des webhooks dans Omnisend, il est essentiel de comprendre les composants clés impliqués dans la configuration d'une requête webhook.
Cette section détaille la structure et les composants que vous rencontrerez lors de la modification d'un Webhook dans Omnisend :
Composant 1. URL du Webhook
L'URL est le point de terminaison de destination où vos données de webhook seront envoyées. Il s'agit généralement d'un système ou d'un service externe qui gérera et traitera les données envoyées par Omnisend.
Important ⚠️ Assurez-vous que cette URL est correcte et accessible. Si le service de réception nécessite une communication sécurisée, assurez-vous que l'URL commence par https:// for encrypted transmission.
Composant 2. En-têtes
Les Webhooks vous permettent d'inclure des en-têtes supplémentaires avec votre requête. Les en-têtes sont des paires clé-valeur qui contiennent des métadonnées sur la requête du Webhook ou servent d'authentification pour le système de réception.
Clé. Le nom de l'en-tête (par ex.,
Authorization,Content-Type).Valeur. La valeur associée à la clé d'en-tête (par exemple,
Bearer your_access_token,application/json).Exemple d'en-têtes :
Authorization: Bearer your_access_tokenContent-Type: application/json
Cas d'utilisation courant. Si votre service de réception nécessite une authentification, telle qu'une clé API ou un jeton, vous la transmettriez dans les en-têtes.
Conseil 💡 Vérifiez toujours que les en-têtes nécessaires sont correctement configurés afin d'éviter les requêtes non autorisées ou ayant échoué.
Composant 3. Corps
Le Corps C'est là que les données proprement dites (charge utile) sont envoyées. Il contient les informations pertinentes que vous souhaitez transmettre au système externe, telles que les détails du client, les informations de commande ou des déclencheurs d'événements spécifiques.
Format. Le corps du message est généralement structuré au format JSON, ce qui permet à la plupart des services de le gérer et de le lire facilement.
Exemple de corps (Charge utile JSON) :
{ "customer_name": "[[contact.first_name]]", "email": "[[contact.email]]", "order_value": "[[event.raw._total_price]]", "purchase_time": "[[event.raw.created_at]]" }Personnalisation du corps. Vous pouvez adapter la charge utile pour n'inclure que les données spécifiques dont le service de réception a besoin. Omnisend fournit des variables (par ex.,
[[contact.email]]) qui insère dynamiquement des données de votre automatisation dans la charge utile. Plus de détails sur les données disponibles se trouventici
⚠️ Important ! Assurez-vous que la structure du corps correspond à ce que le point de terminaison de réception attend. Cela inclut le format approprié (JSON, XML, etc.) et les noms de champs.
Test du Webhook
Après avoir configuré l'URL, les en-têtes et le corps, il est essentiel de tester le webhook pour vérifier que les données sont envoyées correctement. Assurez-vous toujours que la réponse du système de réception est conforme aux attentes et qu'il n'y a pas d'erreurs de transmission.
Comment configurer les Webhooks dans les automatisations Omnisend
Étape 1. Créez un Workflow d'automatisation
Commencez par créer une nouvelle automatisation ou modifier une automatisation existante dans Omnisend.
Étape 2. Ajouter une action Webhook
Dans votre flux d'automatisation, glissez-déposez un bloc 'Webhook' à l'endroit où vous souhaitez que l'événement externe se déclenche.
Étape 3. Configurer l'URL du Webhook et les En-têtes
Saisissez l'URL du Webhook du système externe, qui recevra les données. Il peut s'agir d'un CRM, d'un outil de communication ou d'un service API comme l'API WhatsApp Business. Les en-têtes sont des paires clé-valeur qui contiennent des métadonnées sur la requête du Webhook ou servent d'authentification pour le système de réception.
Étape 4. Mapper la charge utile
Personnalisez la charge utile des données que vous souhaitez envoyer avec le webhook. Omnisend vous permet de transmettre les détails du client, les informations de commande ou d'autres données pertinentes.
Étape 5. Tester le Webhook
Après l'avoir configuré, testez le webhook pour vous assurer que le système externe envoie et reçoit correctement les données.
Vérifier :
Le système externe reçoit les données.
Le code de réponse est
200 OK.Aucune erreur n'apparaît dans Omnisend ou les journaux externes.
Mettre sur liste blanche les adresses IP statiques du Webhook
Pour renforcer la sécurité de vos intégrations de Webhook, Omnisend utilise un ensemble dédié d'adresses IP statiques pour toutes les requêtes de Webhook sortantes. Vous pouvez mettre ces adresses IP sur liste blanche dans votre pare-feu, votre passerelle API ou votre configuration de point de terminaison pour vous assurer que seules les requêtes d'Omnisend sont acceptées.
Pourquoi mettre sur liste blanche les IP de Webhook ?
L'ajout à la liste blanche des adresses IP statiques d'Omnisend fournit une couche de sécurité supplémentaire en :
Prévenant les requêtes non autorisées – Seul le trafic provenant des adresses IP d'Omnisend peut atteindre votre point de terminaison de webhook.
Réduction des risques d'usurpation d'identité – Bloque les acteurs malveillants tentant d'imiter les appels de Webhook Omnisend.
Répondre aux exigences de conformité – Prend en charge les politiques de sécurité d'entreprise qui nécessitent un contrôle d'accès basé sur l'IP.
Omnisend Webhook Liste d'IP Statiques
Ajoutez les adresses IP suivantes à votre configuration de liste blanche :
34.170.162.11
34.56.62.59
34.56.108.215
34.133.59.36
34.58.66.146
35.184.130.5
35.232.14.89
Important ⚠️ Ces adresses IP sont utilisées exclusivement par Omnisend pour les requêtes de webhook envoyées depuis les flux de travail d'automatisation. Assurez-vous que votre pare-feu ou votre configuration API autorise le trafic entrant depuis ces adresses.
Note: Si vous ne savez pas comment configurer la liste blanche d'adresses IP, consultez votre équipe de développement ou votre administrateur système.
Envoyer un message via Slack en utilisant les Webhooks
Slack peut être intégré à Omnisend pour envoyer des notifications à des canaux spécifiques lorsqu'un événement d'automatisation se produit.
Étape 1. Créez un Webhook entrant dans Slack.
Allez à Slack API et configurez un webhook entrant.
Choisissez un canal où les messages seront envoyés.
Copiez l'URL du Webhook fournie par Slack.
Étape 2. Ajoutez le Webhook à l'Automatisation Omnisend.
Dans votre workflow Omnisend, insérez le bloc webhook au point souhaité de votre automatisation.
Saisissez l'URL du Webhook Slack.
Personnaliser la charge utile. Définissez le format de message que vous souhaitez envoyer. Pour Slack, la charge utile pourrait ressembler à ceci :
{ "text": "A new subscriber has joined! 🎉", "attachments": [ { "title": "Subscriber Details", "text": "Name: [[contact.first_name]] \n Email: [[contact.email]]" } ] }Testez l'Intégration. Activez l'automatisation et vérifiez le canal Slack pour confirmer que le message est envoyé avec succès.
Envoi de contacts vers Postscript depuis Omnisend via les webhooks d'automatisation
Étape 1. Obtention de votre clé API Postscript
Accédez à votre compte Postscript.
Cliquez sur votre nom dans le coin supérieur droit, et choisissez API.
Si vous n'avez pas encore créé de paire de clés API, cliquez sur Créer une paire de clés de sécurité pour en générer une.
Copiez la Clé privée et enregistrez-la en lieu sûr, car vous en aurez besoin plus tard.
Étape 2. Créer un mot-clé dans Postscript
Dans Postscript, cliquez sur Keywords dans le panneau de gauche.
Cliquez sur Create Keyword dans le coin supérieur droit.
Nommez votre mot-clé et décidez si vous souhaitez inclure un coupon dans la réponse.
Pour modifier la réponse :
Cliquez sur la case violette Reply ou créez une réponse automatique en cliquant sur Add Action, puis personnalisez le message de réponse.
Cette réponse de mot-clé sera envoyée immédiatement lorsqu'un utilisateur s'abonne via votre mot-clé.
Étape 3. Obtenir l'ID du mot-clé
Consultez la documentation API de Postscript : Postscript Get Keywords.
Entrez votreClé privée dans l'en-tête et cliquez Essayez-le pour trouver le Identifiant du mot clé que vous souhaitez utiliser pour les contacts provenant d'Omnisend.
Étape 4. Configuration de l'automatisation dans Omnisend
Déclencheur d'automatisation. Utilisez le déclencheur "Contact Enters Segment" pour transférer les contacts vers Postscript.
Bloc Webhook.
Ajoutez un bloc Webhook à votre flux d'automatisation.
PourURL, utiliser:
https://api.postscript.io/api/v2/subscribers.Pour En-têtes, ajouter:
Authorization: Beareraccept: application/json
Corps. Transmettez les informations suivantes dans le corps de la requête :
{ "origin": "other", "properties": { "VIP": true }, "phone_number": "[[contact.phone_number]]", "email": "[[contact.email]]", "keyword_id": "<keywordID obtained previously>", "tags": [ "source:omnisend" ] }Remplacez par votre ID de mot-clé réel.
Vous pouvez utiliser
"origin": "website","social", ou"other".
Étape 5. Activation de l'automatisation
Activez l'automatisation et testez-la en ajoutant un contact test avec un numéro de téléphone à votre segment.
Vérifiez si les contacts du flux sont correctement transmis à Postscript.
En suivant ces étapes, vous pourrez envoyer des contacts d'Omnisend à Postscript via les webhooks d'automatisation.
Envoi de messages WhatsApp à l'aide de Webhooks
L'intégration WhatsApp nécessite l'utilisation de l'API WhatsApp Business ou d'un service tiers. Vous trouverez ci-dessous les étapes pour intégrer la messagerie WhatsApp à l'aide de webhooks.
Étape 1. Configurez l'API WhatsApp Business.
Inscrivez-vous à l'API WhatsApp Business via Facebook.
Suivez le processus de configuration, qui inclut l'hébergement de l'API sur votre serveur ou l'utilisation d'un service tiers.
Obtenez les identifiants API requis.
Étape 2. Configurer les Webhooks dans Omnisend.
Ajoutez un bloc webhook dans votre workflow d'automatisation Omnisend.
Saisissez l'URL du point de terminaison de l'API WhatsApp Business en tant que Webhook.
Construisez la requête HTTP. Pour envoyer des messages via WhatsApp, construisez une requête HTTP POST avec la charge utile nécessaire. Exemple utilisant cURL :
curl -X POST https://graph.facebook.com/v14.0/YOUR_PHONE_NUMBER_ID/messages \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "messaging_product": "whatsapp", "to": "RECIPIENT_PHONE_NUMBER", "type": "text", "text": { "body": "Hello, this is a test message from the WhatsApp Business API." } }'Étape 3. Testez l'Intégration. Exécutez votre automatisation pour vous assurer que le message WhatsApp est envoyé avec succès.
Envoi de données à un point de terminaison API personnalisé
Dans certains cas, vous pourriez vouloir envoyer des données d'événement à un point de terminaison d'API personnalisé, tel que votre propre système CRM ou une plateforme de gestion des commandes.
Étape 1. Créer un point de terminaison API personnalisé. Travaillez avec votre équipe de développement pour créer un point de terminaison API qui peut recevoir les données de webhook d'Omnisend.
Étape 2. Ajoutez le Webhook dans Omnisend. Insérez le bloc Webhook dans l'automatisation souhaitée et saisissez l'URL du point de terminaison API personnalisé.
Personnalisez la charge utile. La charge utile peut inclure toutes les données disponibles de l'automatisation, telles que les détails du client, les informations de commande ou les données de campagne. Exemple :
{ "customer_name": "[[contact.first_name]]", "email": "[[contact.email]]", "order_value": "[[event.raw._total_price]]", "purchase_time": "[[event.raw.created_at]]" }Étape 3. Tester et activer. Testez le webhook pour vous assurer que les données sont envoyées correctement à votre point de terminaison API personnalisé.
Utiliser les Webhooks pour les notifications d'action
Ces instructions vous aideront à configurer les webhooks pour recevoir des notifications pour diverses actions, telles que lorsqu'un client achète un produit spécifique, demande un remboursement ou clique sur un lien particulier dans un email. Les Webhooks peuvent vous permettre de créer des événements personnalisés basés sur les actions effectuées par vos contacts. Voici comment cela fonctionne généralement :
Un contact effectue une action : Un contact déclenche un événement en cliquant, par exemple, sur un lien dans un e-mail.
Entrée dans l'automatisation : Le contact entre dans un workflow d'automatisation. Cela peut commencer lorsqu'il entre dans un segment spécifique.
Webhook envoie un Custom event : Un webhook envoie un custom event concernant l'action effectuée par le premier contact à une adresse email interne spécifiée.
Deuxième automatisation déclenchée : Le contact spécifié entre dans une deuxième automatisation, dans laquelle vous recevez des notifications concernant l'action effectuée par le premier contact.
Exemple
Dans notre exemple, nous nous enverrons une notification par e-mail chaque fois que quelqu'un clique sur un lien spécifique dans un e-mail.
Étape 1. Configuration de la première automatisation
Définir l'action:
Configurez votre Déclencheur pour l'Automatisation. Cela peut inclure toute action, telle que rejoindre un segment ou cliquer sur un bouton promotionnel.
Dans notre exemple, nous voulons savoir quand quelqu'un clique sur un bouton spécifique lors d'une action marketing.
Ajouter un bloc Webhook:
Dans votre flux d'automatisation, ajoutez un bloc Webhook pour envoyer un custom event au contact spécifié.
Configuration du Webhook
En-têtes :
Clé :
x-api-keyValeur : (à remplacer par votre véritable clé API)
Corps :
{
"eventName": "Click notification",
"origin": "api",
"contact": {
"email": "[email protected]"
},
"properties": {
"clicker_email":"[[contact.email]]",
"clicker_fname":"[[contact.first_name]]",
"clicker_lname":"[[contact.last_name]]"
}}Note importante concernant la configuration du corps :
eventName: Vous pouvez nommer cet événement comme vous le souhaitez. Il sera utilisé pour déclencher la deuxième automatisation.
origine: Doit être réglé sur
"api".Contact (e) →email : Ceci indique le contact qui recevra le Custom event et la notification concernant l'action effectuée par le premier contact.
properties: Il s'agit d'une liste facultative de détails que vous pouvez inclure concernant le premier Contact (e). Dans ce cas, nous recueillons leur adresse Email, leur prénom et leur nom de famille.
Étape 2. Configuration de la deuxième automatisation
Sélectionnez le Déclencheur:
Choisissez le
eventNamede l'étape précédente comme déclencheur de l'automatisation.
Ajouter des détails de notification:
Dans cette automatisation, vous pouvez configurer une notification par Email ou SMS en utilisant les détails recueillis de la première automatisation, tels que l'Email et le nom du contact.
Cette configuration de webhook vous permet de notifier un seul contact concernant des actions spécifiques effectuées par tout autre contact au sein d'Omnisend. Si vous avez d'autres questions ou besoin d'aide, veuillez contacter notre équipe d'assistance.
Les webhooks offrent la flexibilité nécessaire pour étendre vos automatisations Omnisend, permettant ainsi une communication en temps réel avec des plateformes externes. Que vous envoyiez des messages via Slack, WhatsApp ou des plateformes SMS comme Postscript, le processus est similaire : configurer une URL de webhook, définir un payload et tester l'Intégration. Cependant, gardez à l'esprit que l'intégration de webhooks nécessite souvent des ressources de développement, en particulier pour les configurations API personnalisées.
À retenir 💡 L'intégration de webhooks nécessite souvent des ressources de développement, en particulier pour les configurations API personnalisées, alors assurez-vous d'avoir le soutien nécessaire.
Foire aux questions
Quand dois-je utiliser les webhooks plutôt que les intégrations natives ?
Utilisez les webhooks pour les plateformes sans intégration Omnisend directe ou lorsque vous avez besoin d'un mappage de données personnalisé.
Puis-je tester les webhooks avant d'activer l'automatisation ?
Oui – Tester le Webhookou des outils comme Postman pour envoyer des requêtes de test.
Existe-t-il des limites de débit ?
Les limites dépendent du service externe – consultez leur documentation API.
Puis-je mettre sur liste blanche les adresses IP des Webhook d'Omnisend pour la sécurité ?
Oui. Omnisend utilise un ensemble dédié d'adresses IP statiques pour toutes les requêtes Webhook envoyées depuis les flux de travail d'Automatisation. L'ajout de ces adresses IP à la liste blanche ajoute une couche de sécurité supplémentaire en garantissant que seul Omnisend peut atteindre votre point de terminaison. Consultez la liste complète des adresses IP
Quelles données puis-je utiliser dans les charges utiles de webhook ?
Vous pouvez utiliser n'importe quel attribut de contact ou les données d'un événement qui déclenche l'automatisation. Pour plus d'informations, consultezici
Quel forfait dois-je utiliser pour les webhooks dans les automatisations ?
Les webhooks sont disponibles sur tous lesforfaits payants. Si vous utilisez le forfait gratuit et souhaitez utiliser les webhooks, vous devez d'abord effectuer une mise à niveau. Allez dans Paramètres de la Boutique → Facturation pour gérer votre forfait.
Si vous avez besoin d'aide pour configurer vos webhooks, n'hésitez pas à contacter notre équipe de Support Client primée. Vous pouvez nous trouver via le chat intégré à l'application ou à[email protected].