De klus: één plek waar elk klantbericht binnenkomt, uit welke app het ook komt, en één aanroep die het daar beantwoordt. Vijf stappen, elk één verzoek.
1. Maak het inboxaccount
curl -X POST https://makehybrid.com/inbox/v1/account \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Eén keer per organisatie. Als je het nog eens aanroept, krijg je hetzelfde account terug, dus het is veilig om bij elke deploy uit te voeren.
2. Voeg kanalen toe
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…"}}'
De webchat antwoordt met het fragment dat je vóór </body> plakt; het laadt vanaf je eigen domein. Instagram en TikTok voeg je toe via een inloglink, Facebook Messenger via een link die de beheerder van een pagina opent, en LINE, SMS en WhatsApp met de eigen inloggegevens van het platform — de referentie beschrijft ze stuk voor stuk.
3. Ontvang nieuwe berichten
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"]}'
Bewaar het geheim dat je terugkrijgt: elke bezorging is ermee ondertekend in de header x-mh-signature, en dat hetzelfde bericht opnieuw aankomt is normaal.
4. Antwoord waar ze schreven
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"}'
Het antwoord gaat uit op het eigen kanaal van het gesprek. Voeg "private": true toe en het is een notitie die alleen je team ziet.
5. Los het op
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"}'
Een opgelost gesprek gaat uit zichzelf weer open als de klant schrijft.
Sommige kanalen laten een bedrijf alleen als eerste schrijven met een sjabloon dat het platform heeft goedgekeurd — WhatsApp buiten het venster van 24 uur is het bekendste voorbeeld. Antwoorden mag altijd; beginnen bepaalt het platform.
Veelgestelde vragen
Kan mijn team antwoorden zonder code te schrijven?
Ja. Het scherm Inbox van de geïnstalleerde app toont dezelfde gesprekken aan elk ingelogd teamlid, met antwoorden, privénotities, toewijzing, labels en meldingen op de telefoon.
Kan een AI-agent de antwoorden opstellen?
Ja. Geef een eigen AI-agent in een projectkamer de inbox-agent, of koppel je assistent aan /inbox/mcp, en vraag om een concept; een persoon in de kamer zegt “go” voordat er iets wordt verstuurd.