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 pager 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 parhttps:// 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 : Validez toujours que les en-têtes nécessaires sont correctement configurés pour éviter les demandes non autorisées ou échouées.
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.Trouvez plus de détails sur les données disponibles
⚠️ 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.
Tester le 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 dans la transmission.
Comment configurer des Webhooks dans les automatisations Omnisend
Étape 1. Créer un Workflow d'Automatisation
Commencez par créer une nouvelle automatisation ou en modifier une existante dans Omnisend.
Étape 2. Ajouter une Action Webhook
Dans votre flux d'automatisation, faites glisser et déposez un bloc 'Webhook' à l'endroit où vous souhaitez que l'événement externe déclenche.
Étape 3. Configurer l'URL et les En-têtes du Webhook
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 webhook ou servent d'authentification pour le système récepteur.
É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 des données correctement.
Vérifiez :
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 IP sur liste blanche dans votre pare-feu, votre passerelle API ou la configuration de votre point de terminaison pour vous assurer que seules les demandes provenant d'Omnisend sont acceptées.
Pourquoi mettre en liste blanche les IPs de Webhook ?
L'ajout des IPs statiques d'Omnisend fournit une couche de sécurité supplémentaire en :
Prévenant les demandes non autorisées Seul le trafic provenant des IPs d'Omnisend peut atteindre votre point de terminaison webhook.
Réduction des risques de spoofing Bloque les acteurs malveillants tentant de mimer les appels webhook d'Omnisend.
Respect des exigences de conformité – Soutient les politiques de sécurité d'entreprise qui nécessitent un contrôle d'accès basé sur l'IP.
Liste des adresses IP statiques du Webhook Omnisend
Ajoutez les IPs 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
f6a0e0f Important: Ces adresses IP sont utilisées exclusivement par Omnisend pour les requêtes 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 des 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éer un Webhook entrant dans Slack.
Allez sur l'API Slack 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.
Personnalisez 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]]" } ] }Tester l'Intégration. Activez l'automatisation et vérifiez le canal Slack pour confirmer que le message a été envoyé avec succès.
Envoyer des contacts à Postscript depuis Omnisend via des 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, puis 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 sauvegardez-la quelque part en sécurité, car vous en aurez besoin plus tard.
Étape 2. Créer un Mot-Clé dans Postscript
Dans Postscript, cliquez sur Mots-Clés sur le côté gauche.
Cliquez sur Créer un Mot-Clé 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 boîte Répondre violette ou créez une réponse automatique en cliquant sur Ajouter 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é
Visitez la documentation de l'API Postscript : Postscript Obtenir des mots-clés.
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. Passez 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 (e) test avec un numéro de téléphone à votre segment.
Vérifiez si les contacts dans le flux sont correctement transmis à Postscript.
En suivant ces étapes, vous pourrez envoyer des contacts d'Omnisend à Postscript via des webhooks d'automatisation.
Envoyer des messages WhatsApp à l'aide de webhooks
L'intégration WhatsApp nécessite l'utilisation de l'API WhatsApp Business ou d'un service tiers. Voici les étapes pour intégrer la messagerie WhatsApp à l'aide de webhooks.
Étape 1. Configurer 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.
Entrez l'URL du point de terminaison de l'API WhatsApp Business comme le webhook.
Construire 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 souhaiterez peut-être envoyer des données d'événements à un point de terminaison API personnalisé, tel que votre propre système CRM ou 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 capable de recevoir les données du webhook Omnisend.
Étape 2. Ajoutez le Webhook dans Omnisend. Insérez le bloc webhook dans l'automatisation souhaitée et saisissez l'URL de point de terminaison API personnalisée.
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 des 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 (e) effectue une action : Un Contact (e) déclenche un événement en cliquant, par exemple, sur un lien dans un Email.
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 (e) à 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 Email chaque fois que quelqu'un clique sur un lien spécifique dans un Email.
Étape 1. Configuration de la première automatisation
Définir l'action:
Configurez votre Déclencheur pour l'Automatisation. Cela peut inclure toute action, comme entrer dans 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 (e) spécifié.
Configuration du Webhook
En-têtes :
Clé :
x-api-keyValeur : (remplacez 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]]"
}}Remarque Importante sur 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: Cela spécifie le contact qui recevra l'événement personnalisé et la notification concernant l'action effectuée par le premier contact.
propriétés: Il s'agit d'une liste optionnelle de détails que vous pouvez inclure sur le premier contact. Dans ce cas, nous collectons leur adresse Email, prénom et 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 lors 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 (e) concernant des actions spécifiques effectuées par tout autre Contact (e) 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 des webhooks nécessite souvent des ressources de développement, en particulier pour les configurations API personnalisées.
4a1 0À garder à l'esprit : L'intégration des 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.
FAQ
Quand dois-je utiliser les webhooks plutôt que les intégrations natives ?
Utilisez des webhooks pour les plateformes sans intégration directe avec Omnisend ou lorsque vous avez besoin d'une cartographie de données personnalisée.
Puis-je tester les webhooks avant d'activer l'automatisation ?
Yes – ou 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 en liste blanche les IPs de webhook d'Omnisend pour des raisons de sécurité ?
Yes. Omnisend uses a dedicated set of static IP addresses for all webhook requests sent from Automation workflows. Whitelisting these IPs adds an extra security layer by ensuring only Omnisend can reach your endpoint.
Quelles données puis-je utiliser dans les charges utiles du webhook ?
You can use any contact attributes or data from an event that triggers the automation. For more information, see
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 dans l'application ou à [email protected].