Die Aufgabe: ein Ort, an dem jede Kundennachricht landet, egal aus welcher App sie kam, und ein Aufruf, der sie dort beantwortet. Fünf Schritte, jeder eine Anfrage.
1. Das Posteingangskonto anlegen
curl -X POST https://makehybrid.com/inbox/v1/account \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Einmal pro Organisation. Wird der Aufruf wiederholt, antwortet er mit demselben Konto, deshalb ist er bei jedem Deployment sicher auszuführen.
2. Kanäle hinzufügen
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…"}}'
Der Website-Chat antwortet mit dem Snippet, das Sie vor </body> einfügen; es lädt von Ihrer eigenen Domain. Instagram und TikTok werden über einen Anmeldelink hinzugefügt, Facebook Messenger über einen Link, den der Verwalter einer Facebook-Seite öffnet, und LINE, SMS und WhatsApp mit den eigenen Zugangsdaten der Plattform — die Referenz beschreibt jeden einzelnen.
3. Neue Nachrichten erhalten
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"]}'
Bewahren Sie das Secret auf, das zurückkommt: Jede Zustellung wird damit im Header x-mh-signature signiert, und dass dasselbe Ereignis wiederholt eintrifft, ist normal.
4. Dort antworten, wo geschrieben wurde
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"}'
Die Antwort geht über den eigenen Kanal der Unterhaltung hinaus. Fügen Sie "private": true hinzu, und es ist eine Notiz, die nur Ihr Team sieht.
5. Lösen
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"}'
Eine gelöste Unterhaltung öffnet sich von selbst wieder, wenn der Kunde schreibt.
Manche Kanäle lassen ein Unternehmen nur mit einer von der Plattform genehmigten Vorlage zuerst schreiben — WhatsApp außerhalb des 24-Stunden-Fensters ist der häufigste Fall. Antworten ist immer erlaubt; Anfangen entscheidet die Plattform.
Häufige Fragen
Kann mein Team ohne Code antworten?
Ja. Der Bildschirm „Posteingang“ der installierten App zeigt jedem angemeldeten Mitglied dieselben Unterhaltungen, mit Antworten, privaten Notizen, Zuweisung, Labels und Benachrichtigungen aufs Handy.
Kann ein KI-Agent die Antworten entwerfen?
Ja. Geben Sie einem eigenen KI-Agenten in einem Projektraum den Agenten des Posteingangs oder verbinden Sie Ihren Assistenten mit /inbox/mcp und bitten Sie ihn um einen Entwurf; eine Person im Raum sagt „los“, bevor etwas gesendet wird.