Gesprek in de inbox ophalen is een GET op /inbox/v1/conversations/{id}, in de MakeHybrid Inbox API: één inbox voor WhatsApp, Instagram, Facebook, TikTok, Telegram, LINE, e-mail, SMS en de chat op je website. Elk verzoek draagt je eigen sleutel in een X-API-KEY-header — dezelfde sleutel als die van de LinkedIn API — en bereikt alleen het inboxaccount van je eigen organisatie.
Eén inbox bevat elk kanaal dat je eraan toevoegt, dus een antwoord gaat via dezelfde aanroep terug op het kanaal waarop de klant schreef — WhatsApp, Instagram, e-mail of welk ander kanaal ook.
Het verzoek
curl -X GET "https://makehybrid.com/inbox/v1/conversations/$ID" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Wat er in het pad hoort
- id — een id die een eerdere aanroep uit deze familie teruggaf.
Wat er terugkomt als het niet werkt
- 401 — de sleutel ontbreekt, is fout of is ingetrokken.
- 402 — het abonnement is niet betaald. De MakeHybrid API antwoordt dit zodra een proef voorbij is.
- 404 — óf het ding staat er niet, óf het is niet van je organisatie. Allebei met opzet hetzelfde antwoord, zodat id’s niet af te tasten zijn.
- 429 — te veel verzoeken, of het platform dat ons vraagt te vertragen. Wacht even voordat je het opnieuw probeert.
- 502 of 503 — het platform gaf zojuist geen antwoord. Probeer het over een moment opnieuw.
Elke fout is JSON in dezelfde vorm: {"type":"errors/<code>","status":<n>,"detail":"..."} — één handler dekt ze dus allemaal, en de detail is geschreven om aan een mens te laten zien.
Het aan een assistent vragen
Deze operatie is ook een MCP-tool. Plak https://makehybrid.com/inbox/mcp/<your API key> in Claude, ChatGPT of welke assistent dan ook die MCP spreekt, en vraag in gewone woorden wat je wilt — de assistent kiest de aanroep, vult de id’s in en leest je het antwoord voor. De alles-in-één-agent op https://makehybrid.com/mcp/<your API key> biedt dit ook, naast de LinkedIn API en elk ander kanaal.
In een projectkamer
Vink in een projectkamer bij een eigen AI-agent onder “Mag gebruiken” de agent van deze API aan, en hij roept „Gesprek in de inbox ophalen” aan als tool wanneer het gesprek dat nodig heeft. Iedereen in de kamer ziet wat hij vroeg en wat er terugkwam. Vraag het in gewone woorden; hier heet de agent @scout:
- @scout som de open gesprekken van vandaag uit elk kanaal op en schrijf een conceptantwoord voor het oudste.
Veelgestelde vragen
Kan een AI-agent „Gesprek in de inbox ophalen” voor me aanroepen?
Ja. Elke assistent die MCP spreekt kan dat, via het adres hierboven, en een eigen AI-agent in een projectkamer waarin de agent van deze API is aangevinkt ook. De ingebouwde agents van een kamer kunnen het niet: ze adviseren en hebben je sleutel niet.
Werkt het ook buiten een kamer, vanuit mijn eigen code?
Ja. Het verzoek hierboven is dezelfde operatie die de toolaanroepen van een AI-agent uitvoeren, met hetzelfde antwoord en dezelfde fouten, en je sleutel bereikt dezelfde kanalen, hoe je ook binnenkomt.
Werkt het in een kamer onder mijn eigen merk?
Ja. Op een white-labeladres dragen de API, de referentie en de AI-agent de naam van jouw product, en bereiken ze dezelfde kanalen onder dezelfde regels.
In welk abonnement
Inbegrepen in het abonnement MakeHybrid API, met dezelfde sleutel als de LinkedIn API: $9 per plek per maand, $7 vanaf tien plekken en $5 vanaf duizend. Je hebt zoveel plekken nodig als je er hebt van het soort waarvan je er de meeste hebt — LinkedIn-accounts, WhatsApp-nummers, X-accounts of inboxaccounts — en de proefperiode van 30 dagen geldt voor één plek.