Envoyer vos prospects de DM vers votre CRM avec des webhooks

Un prospect qui n’existe que dans une messagerie Instagram est un prospect qu’on oublie. La personne a demandé un devis, candidaté à une collaboration ou rejoint une liste d’attente, et une semaine plus tard, plus personne ne se souvient de qui il s’agissait.

Les webhooks règlent ce problème. Un webhook est un message que votre automatisation envoie à un autre système à l’instant où quelque chose se passe. Placez-en un dans une automatisation de DM et chaque prospect arrive là où votre équipe travaille déjà : un CRM, un tableur, un outil d’assistance ou votre propre base de données.

Les deux étapes

Les automatisations de Chat33 ont deux étapes pour communiquer avec d’autres systèmes.

Envoyer les données à un webhook envoie une requête POST avec une description JSON de ce qui vient de se passer vers une URL de votre choix. C’est l’option simple, faite pour les outils qui reçoivent.

Appeler une API appelle une URL avec la méthode de votre choix : GET, POST, PUT ou DELETE. Avec POST et PUT, elle inclut les mêmes détails dans le corps de la requête. Chaque requête porte les identifiants de l’automatisation et du contact en en-têtes, X-Flow-Id et X-Contact-Id. Utilisez-la quand vous appelez votre propre API.

Les deux sont à sens unique : elles envoient des données vers l’extérieur, et l’automatisation continue sans utiliser la réponse. Les automatisations s’exécutent aussi d’un bout à l’autre, de haut en bas ; elles ne s’arrêtent pas pour attendre le prochain message de la personne. Une question posée dans une automatisation reçoit sa réponse dans une autre automatisation, déclenchée par la réponse.

Ce qu’envoie le webhook

Une étape « Envoyer les données à un webhook » envoie un corps comme celui-ci :

{
  "event": "flow_webhook",
  "flowId": "flow_123",
  "contactId": "contact_456",
  "recipientId": "1784...",
  "platform": "instagram",
  "triggerText": "Hi, I'd like a quote for 50 units",
  "triggerType": "dm_keyword",
  "keyword": "QUOTE",
  "postId": null,
  "commentId": null,
  "contact": {
    "name": "Anna",
    "externalId": "1784...",
    "platform": "instagram"
  },
  "timestamp": "2026-04-04T10:15:00.000Z"
}

Le champ le plus utile est souvent triggerText : le message ou le commentaire qui a démarré l’automatisation, dans les mots de la personne. keyword est le mot-clé du déclencheur qui a correspondu, et pour un commentaire, postId et commentId indiquent de quelle publication il vient.

Ce qu’il n’inclut pas : adresses e-mail ni numéros de téléphone. Instagram ne les partage pas avec les apps : si votre CRM a besoin de coordonnées, demandez-les dans la conversation ou envoyez un lien vers un formulaire.

Si le détail dont vous avez besoin est une adresse e-mail, une étape « Collecter l’e-mail » la demande dans le DM, et Chat33 peut envoyer chaque adresse collectée directement vers HubSpot ou Mailchimp, sans webhook. Collectez vos prospects Instagram dans HubSpot montre cette configuration.

Où l’envoyer

Tout ce qui peut recevoir une requête HTTPS convient :

• Le webhook entrant d’une plateforme d’automatisation. La plupart proposent un déclencheur de réception qui vous donne une URL. À partir de là, ajoutez une ligne à un tableur, créez un contact CRM ou publiez dans une discussion d’équipe.
• Le webhook entrant de votre CRM, s’il en a un.
• Votre propre backend, via l’étape « Appeler une API ».

Si vous préférez appeler Instagram depuis votre propre code, le guide de l’API DM Instagram montre ce que cela demande.

La mise en place

1. Récupérez l’URL de réception auprès de l’outil qui acceptera les données.
2. Ajoutez une étape Envoyer les données à un webhook à l’automatisation qui s’exécute une fois que le prospect vous a dit quelque chose d’utile, par exemple l’automatisation par mot-clé devis qui répond à un appui sur « Obtenir un devis ».
3. Collez l’URL.
4. Activez l’automatisation et déclenchez-la depuis un second compte Instagram.
5. Vérifiez dans l’outil récepteur la requête de test, puis associez les champs dont vous avez besoin.

Sécuriser l’endpoint

La requête du webhook n’est pas signée : considérez donc l’URL elle-même comme le secret :

• Utilisez une URL longue et aléatoire ou incluez un jeton secret dans la chaîne de requête que votre récepteur vérifie.
• N’acceptez que les champs attendus et ignorez tout le reste.
• Vérifiez que flowId correspond à l’une de vos automatisations avant d’agir sur les données.
• Utilisez HTTPS.

Fiabilité

Chaque étape fait une seule tentative avec un délai d’expiration de 10 secondes. Si le côté récepteur est indisponible à ce moment, cet événement n’est pas renvoyé.

Pour la plupart des captures de prospects, ce n’est pas grave, car la conversation est toujours dans votre messagerie Chat33 et le contact est toujours étiqueté. Pour tout ce qui est critique, faites répondre rapidement le récepteur (enregistrer d’abord, traiter ensuite), et associez le webhook à une étape Étiqueter la personne pour pouvoir toujours retrouver les prospects dans Chat33 si quelque chose a été manqué. Notre guide des étiquettes propose un schéma de nommage qui fonctionne bien pour cela.

Des automatisations de prospects qui valent le coup

• Demandes de devis : mot-clé devis, étiquette et webhook, puis une question avec réponses rapides dont chaque option déclenche sa propre automatisation (et son propre webhook, si la réponse compte pour votre CRM).
• Demandes de collaboration : mot-clé collab, lien vers le kit média, webhook vers le tableur que lit votre manager. Voir l’automatisation des DM pour les créateurs.
• Listes d’attente : mot-clé en réponse à une story, une confirmation, une étiquette et un webhook pour que le compteur se mette à jour en temps réel.
• Vente en gros : une étape « Vérifier une condition » qui regarde si le message contient « gros » et n’envoie que ces prospects vers votre pipeline B2B.

Intégrations de Chat33

Webhooks, requêtes HTTP et les autres façons dont Chat33 se connecte aux outils que vous utilisez déjà.