## À 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.