L’intégration Custom Webhook et IA relie Custom Webhook à MessageMind : un agent IA peut ainsi lire le contexte en temps réel et répondre sur tous les canaux qu’utilisent vos clients. Le déclencheur Custom Webhook lance une campagne chaque fois qu’un autre de vos outils envoie les coordonnées d’un contact à une URL fournie par MessageMind. Vous ne le trouverez pas sur la page Integrations : vous le choisissez comme déclencheur en créant une campagne dans la section Campaigns du Workspace.

Qu’est-ce que l’intégration Custom Webhook et IA ?

Le déclencheur Custom Webhook lance une campagne chaque fois qu’un autre de vos outils envoie les coordonnées d’un contact à une URL fournie par MessageMind. Vous ne le trouverez pas sur la page Integrations : vous le choisissez comme déclencheur en créant une campagne dans la section Campaigns du Workspace. À chaque requête, MessageMind retrouve le contact grâce à son numéro de téléphone ou à son e-mail (ou le crée) et lance la campagne pour cette personne. Un objectif Custom Webhook a sa propre URL et fait passer une personne déjà dans la campagne à l’étape qui suit l’objectif.

Toutes les intégrations disponibles figurent sur la page des intégrations MessageMind, et les détails techniques de celle-ci se trouvent dans la documentation MessageMind sur Custom Webhook. Si vous préférez d’abord la voir en action, réservez une démo : nous vous montrons son fonctionnement en direct.

Ce que permet l’intégration Custom Webhook

L’intégration Custom Webhook et IA propose d’emblée ces fonctionnalités :

  • Lancer une campagne depuis n’importe quel outil capable d’envoyer une requête à une URL avec l’en-tête de votre choix, par exemple Zapier, Make ou votre propre code.
  • Retrouver le contact grâce à son numéro de téléphone ou à son e-mail, ou créer un nouveau contact s’il n’existe pas encore.
  • Renseigner le champ entreprise du contact avec companyName si sa fiche ne l’indique pas encore.
  • Enregistrer les valeurs supplémentaires que vous envoyez comme champs personnalisés du contact. Vous pouvez les utiliser comme variables, par exemple {{order_id}}, dans les messages et les conditions.
  • Faire passer une personne déjà dans la campagne directement à l’étape qui suit un objectif Custom Webhook, quand votre outil appelle l’URL de cet objectif.
  • Réutiliser les valeurs d’une requête d’objectif, comme un numéro de commande, dans les étapes suivantes.

Données lues et écrites

L’intégration Custom Webhook et IA n’utilise qu’un nombre limité de champs. Voici exactement ce qui circule entre les deux systèmes :

SensContenu
Lecturename, phone, email et companyName de chaque requête envoyée à l’URL du déclencheur.
LectureLes valeurs des champs personnalisés que votre outil envoie dans customFields.
LecturePour l’URL d’un objectif, le téléphone ou l’e-mail qui identifie le contact, plus les champs que vous indiquez dans « Variables from this webhook ». Tout le reste d’une requête d’objectif est ignoré.

Comment configurer l’intégration Custom Webhook et IA

La configuration prend quelques minutes si votre compte est déjà actif. Les étapes :

  • Cliquez sur Workspace dans la barre du haut, puis sur Campaigns dans la colonne de gauche.
  • Cliquez sur « Create campaign », saisissez un nom dans « Campaign name », laissez « Create an Automation » sélectionné et cliquez sur Create. La nouvelle campagne s’ouvre dans l’éditeur.
  • Cliquez sur « Add a Trigger ». Dans la fenêtre « Choose a trigger », cliquez sur « Custom Webhook » sous Webhook. La fenêtre « Configure trigger » s’ouvre.
  • Cliquez sur Copy à côté de « Webhook URL » et collez l’URL dans votre autre outil comme adresse d’envoi.
  • Paramétrez votre outil pour qu’il envoie une requête POST avec le type de contenu application/json.
  • De retour dans MessageMind, cliquez sur Copy à côté de « Secret token ».

Le guide pas à pas, avec chaque bouton et chaque champ, se trouve dans la documentation MessageMind sur Custom Webhook.

Limites à connaître

Le périmètre de l’intégration Custom Webhook est volontairement limité. Voici ce qu’il faut savoir avant de compter dessus :

  • L’URL n’accepte des requêtes que lorsque la campagne est en Published : vous ne pouvez donc pas la tester depuis votre outil sur une campagne en Draft. Pour le premier test, utilisez vos propres coordonnées.
  • Une requête est refusée si elle n’a pas de nom, ou si elle n’a ni numéro de téléphone ni adresse e-mail. Pour une requête d’objectif, le téléphone ou l’e-mail suffit.
  • Les numéros de téléphone doivent être valides. Envoyez-les avec le + et l’indicatif du pays, comme dans l’exemple. Un numéro sans indicatif est considéré comme un numéro du pays de votre compte.
  • Les données ne circulent que dans un sens. Votre outil reçoit une courte réponse qui indique si la requête a été acceptée, et MessageMind ne lui renvoie rien d’autre.
  • L’URL d’un objectif ne fonctionne que dans les campagnes qui commencent par le déclencheur Custom Webhook.

Tarifs et offres concernées

L’intégration Custom Webhook et IA est disponible dans les offres payantes de MessageMind. La page des tarifs MessageMind indique l’offre nécessaire et le contenu de chaque formule. Il n’y a pas de frais supplémentaires par intégration : la connexion fait partie de votre compte.

Questions fréquentes

Qu’est-ce que l’intégration Custom Webhook et IA ?

C’est la connexion native entre Custom Webhook et MessageMind. Une fois la connexion établie, l’agent IA peut lire le contexte Custom Webhook en temps réel pendant une conversation et s’en servir (par exemple pour répondre à une question sur le stock, prendre un rendez-vous ou mettre à jour un contact) sur WhatsApp, Instagram, SMS, e-mail et chat web.

Comment relier Custom Webhook à MessageMind ?

Ouvrez la page de l’intégration Custom Webhook dans votre tableau de bord MessageMind et suivez les étapes de connexion. Le guide complet pas à pas, avec le nom de chaque champ et des captures d’écran, se trouve dans la documentation MessageMind sur Custom Webhook.

Comment fonctionne l’authentification de l’intégration Custom Webhook ?

À chaque requête, votre outil envoie le « Secret token » de la campagne dans un en-tête nommé X-Webhook-Token. Aucune connexion n’est nécessaire, et il n’y a aucun lien entre le compte MessageMind et l’autre outil. Les identifiants sont stockés chiffrés et utilisés uniquement côté serveur : ils ne sont jamais transmis au navigateur ni à des tiers.

MessageMind lance-t-il vraiment une campagne depuis n’importe quel outil capable d’envoyer une requête à une URL avec l’en-tête de votre choix ?

Vous pouvez lancer une campagne depuis n’importe quel outil capable d’envoyer une requête à une URL avec l’en-tête de votre choix, par exemple Zapier, Make ou votre propre code.

Que faire si votre outil reçoit la réponse « Invalid webhook token. » ?

Vérifiez que la campagne est en Published et enregistrée, que l’en-tête s’appelle X-Webhook-Token et que sa valeur correspond au « Secret token » actuel. Après avoir cliqué sur Regenerate, seul le nouveau jeton fonctionne. Pour une URL d’objectif, la campagne doit aussi commencer par le déclencheur Custom Webhook.