Vous pouvez recevoir et répondre à vos messages WhatsApp directement dans Madyis Hub en passant par **Twilio**. Comptez environ 10 minutes. Suivez les étapes dans l'ordre.

> ⚠️ Le point le plus important : contrairement à d'autres canaux, la connexion WhatsApp via Twilio **n'est pas 100 % automatique**. Il faut coller une URL (le « webhook ») dans Twilio, sinon les messages reçus n'arrivent jamais dans Madyis Hub. C'est l'étape 3 ci-dessous, et c'est la cause n°1 des messages qui « ne s'affichent pas ».

## Avant de commencer
- Un compte **Twilio** avec WhatsApp activé (un numéro WhatsApp approuvé, ou le bac à sable « Sandbox » pour tester).
- Vos identifiants Twilio : **Account SID** et **Auth Token**, visibles sur la page d'accueil de la console Twilio.

## Étape 1 — Créer la boîte de réception dans Madyis Hub
1. Allez dans **Boîtes & canaux → Ajouter un canal → WhatsApp**, puis choisissez **Twilio**.
2. Renseignez :
   - le **nom** de la boîte de réception (ex. « Support WhatsApp ») ;
   - votre **numéro WhatsApp** au format international (ex. `+33612345678`, sans espace) ;
   - votre **Account SID** et votre **Auth Token**.
3. Cliquez sur **Créer le canal**.

## Étape 2 — Copier l'URL de callback
Juste après la création, Madyis Hub affiche une **URL de callback**. Vous la retrouvez aussi à tout moment dans l'onglet **Configuration** de la boîte de réception. Elle ressemble à :

`https://madyishub.io/twilio/callback`

Copiez-la. C'est elle qui indique à Twilio **où livrer** les messages que vos clients vous envoient.

## Étape 3 — Coller l'URL dans Twilio (l'étape à ne pas oublier)
Dans la console Twilio, ouvrez la configuration de votre expéditeur WhatsApp : **Messaging → Senders → WhatsApp senders → votre numéro**. Repérez la section **« Messaging Endpoint Configuration »** et remplissez :
- **Webhook URL for incoming messages** : collez l'URL de callback copiée à l'étape 2.
- **Webhook method for incoming messages** : **HTTP Post**.
- **Status callback URL** *(optionnel)* : `https://madyishub.io/twilio/delivery_status` — pour recevoir les accusés de livraison (envoyé / lu).
- **Messaging service** : laissez **vide** si vous n'en utilisez pas.

Cliquez sur **Save**.

> Le champ **« Profile about »** que Twilio peut vous demander est simplement le petit texte de description de votre profil WhatsApp (cosmétique, texte libre, ~139 caractères). Par exemple : « Support — réservations et questions ». Il n'a **aucun impact** sur la réception des messages.

## Étape 4 — Tester
Depuis un téléphone, envoyez un message WhatsApp **vers votre numéro**. En quelques secondes, il doit apparaître comme une nouvelle conversation dans la boîte de réception que vous venez de créer.

## Cas particulier : le bac à sable (Sandbox) Twilio
Le Sandbox sert à tester avant d'avoir un numéro WhatsApp approuvé :
- Depuis votre téléphone, **rejoignez d'abord le Sandbox** : envoyez `join <votre-code>` au numéro du Sandbox indiqué par Twilio.
- Mettez l'URL de callback dans les réglages du Sandbox, champ **« When a message comes in »**.
- Dans Madyis Hub, le numéro de la boîte doit être le **numéro du Sandbox** (souvent `+14155238886`), pas votre vrai numéro.

## Ça ne marche toujours pas ?
- Vérifiez que l'**URL de callback est exacte** et bien en **HTTP Post**.
- Vérifiez que le **numéro de la boîte correspond exactement** à votre numéro Twilio (format international `+…`, sans espace).
- Si vous utilisez un **Messaging Service** Twilio : mettez plutôt l'URL de callback dans la configuration de ce service (onglet *Integration → Incoming Messages*), puis renseignez son **Messaging Service SID** au moment de créer la boîte.
- Bloqué sur une étape ? Posez votre question à l'assistant en bas à droite de votre tableau de bord.