## À quoi ça sert

Le canal **API** est destiné aux développeurs. Il vous permet de brancher sur Madyis Hub n'importe quelle source de messages qui n'a pas de connecteur dédié : une application maison, un canal interne, un service tiers, etc. Vos messages entrent et sortent par l'API de Madyis Hub.

## Pour qui

Cette option suppose un minimum de développement. Si vous n'êtes pas technique, les autres canaux (Site web, E-mail, WhatsApp…) couvrent la plupart des besoins sans code.

## Étapes

1. Allez dans **Réglages → Boîtes de réception → Ajouter une boîte de réception → API**.
2. Donnez un **nom** à la boîte de réception.
3. Indiquez si besoin une **URL de webhook** : Madyis Hub y enverra les messages sortants pour que votre système les transmette à votre client. Ce champ est facultatif.
4. Validez, puis ajoutez les agents.

## Ensuite

Une fois la boîte créée, votre application utilise l'API de Madyis Hub pour **envoyer les messages entrants** (de votre client vers Madyis Hub) et, via le webhook, pour **recevoir les messages sortants** (de Madyis Hub vers votre client). Reportez-vous à la documentation API pour les points d'entrée exacts.

> Astuce : l'URL de webhook doit commencer par http(s). Vous pourrez la modifier plus tard dans les réglages de la boîte.