Webhooks (pour développeurs)

À quoi ça sert

Un webhook permet à Madyis Hub de prévenir automatiquement vos propres systèmes dès qu'il se passe quelque chose dans votre compte : par exemple une nouvelle conversation, un nouveau message ou un changement de statut d'une conversation. Concrètement, vous indiquez une adresse web (une URL) qui vous appartient, et Madyis Hub y envoie un message (un appel HTTP) à chaque événement.

C'est l'outil idéal pour connecter Madyis Hub à vos automatisations : déclencher une action dans votre CRM, alimenter un outil interne, envoyer une alerte dans un autre logiciel, etc. Tout se passe en temps réel, sans avoir à venir vérifier manuellement.

ℹ️ Bon à savoir — Cette fonctionnalité s'adresse surtout aux personnes à l'aise avec la technique (développeurs, ou un outil d'automatisation). Si vous n'avez pas de système à connecter, vous pouvez ignorer cet article sans souci.

Comment ajouter un webhook

1. Ouvrez Réglages → Intégrations → Webhooks.
2. Cliquez sur Configurer puis sur Ajouter un nouveau webhook.
3. Dans le champ URL de souscription, saisissez l'adresse web qui doit recevoir les événements (par exemple https://mon-systeme.com/madyis-hub).
4. Sélectionnez les événements que vous souhaitez recevoir (nouvelle conversation, nouveau message, changement de statut, etc.). Vous pouvez n'en choisir que certains.
5. Cliquez sur Créer un webhook.

C'est tout : à partir de maintenant, chaque fois qu'un de ces événements se produit, Madyis Hub envoie automatiquement les informations à votre URL.

Ce que vous recevez

À chaque événement, Madyis Hub envoie une requête HTTP POST à votre URL, avec les détails au format JSON (le type d'événement, la conversation ou le message concerné, etc.). Votre système n'a plus qu'à lire ces informations et à réagir comme vous le souhaitez.

Quelques bonnes pratiques

• Votre URL doit être accessible publiquement et idéalement en HTTPS (adresse sécurisée).
• Elle doit répondre rapidement : contentez-vous d'accuser réception, puis traitez le contenu de votre côté.
• Vous pouvez créer plusieurs webhooks vers des URL différentes, par exemple un pour chaque système à alimenter.

Modifier ou supprimer un webhook

1. Retournez dans Réglages → Intégrations → Webhooks.
2. Repérez le webhook dans la liste.
3. Utilisez les actions à côté pour le modifier (changer l'URL ou les événements) ou le supprimer.

Si vous ne recevez plus rien, vérifiez d'abord que votre URL est toujours en ligne et qu'elle répond correctement.