La tâche : un seul endroit où arrive chaque message de client, quelle que soit l'application d'où il écrit, et un seul appel qui lui répond là. Cinq étapes, chacune une requête.
1. Créez le compte de boîte de réception
curl -X POST https://makehybrid.com/inbox/v1/account \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Une fois par organisation. Un nouvel appel renvoie le même compte, donc on peut l'exécuter sans risque à chaque déploiement.
2. Ajoutez des canaux
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Website","channel":{"type":"web_widget","website_url":"https://acme.com"}}'
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Telegram","channel":{"type":"telegram","bot_token":"123456:ABC…"}}'
Le chat web répond avec l'extrait à coller avant </body> ; il se charge depuis votre propre domaine. Instagram et TikTok s'ajoutent par un lien de connexion, Facebook Messenger par un lien qu'ouvre le gestionnaire d'une page, et LINE, SMS et WhatsApp avec les identifiants propres à la plateforme — la référence détaille chacun.
3. Recevez les nouveaux messages
curl -X POST https://makehybrid.com/inbox/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"url":"https://acme.com/hooks/inbox","events":["inbox.message_created"]}'
Conservez le secret qu'il renvoie : chaque livraison est signée avec lui dans l'en-tête x-mh-signature, et qu'un même événement arrive plusieurs fois est normal.
4. Répondez là où l'on vous a écrit
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"content":"Thanks, we are on it.","message_type":"outgoing"}'
La réponse part sur le canal propre à la conversation. Ajoutez "private": true et c'est une note que seule votre équipe voit.
5. Résolvez-la
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/toggle_status \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"status":"resolved"}'
Une conversation résolue se rouvre d'elle-même quand le client écrit.
Certains canaux ne laissent une entreprise écrire en premier qu'avec un modèle approuvé par la plateforme — WhatsApp hors de sa fenêtre de 24 heures en est le cas courant. Répondre est toujours permis ; commencer relève de la plateforme.
Questions fréquentes
Mon équipe peut-elle répondre sans écrire de code ?
Oui. L'écran Inbox de l'application installée montre les mêmes conversations à chaque membre connecté, avec réponses, notes privées, attribution, étiquettes et notifications sur le téléphone.
Un agent IA peut-il rédiger les réponses ?
Oui. Donnez à un agent IA qui vous est propre l'agent de la boîte de réception dans une salle de projet, ou connectez votre assistant à /inbox/mcp, et demandez-lui de rédiger ; une personne dans la salle dit « go » avant que quoi que ce soit parte.