MakeHybrid
Gesprek plannen
Nederlands

Antwoord geven aan een websitebezoeker — MakeHybrid API

POST /webchat/v1/conversations/{id}/messages op de MakeHybrid Website chat API: het verzoek, de id’s die het nodig heeft en wat elke fout betekent.

Antwoord geven aan een websitebezoeker is een POST op /webchat/v1/conversations/{id}/messages, in de MakeHybrid Website chat API: de eigen chat van je organisatie op haar websites, beantwoord door je team of je AI-agents. Elk verzoek draagt je eigen sleutel in een X-API-KEY-header — dezelfde sleutel als die van de LinkedIn API — en bereikt alleen je eigen chats.

De chat is van jou en wordt door ons bijgehouden, niet door een andere inboxdienst: het gesprek van een bezoeker is alleen met jouw sleutel te bereiken, en een AI-agent die bezoekers antwoordt, doet dat zonder enige tools.

Het verzoek

curl -X POST "https://makehybrid.com/webchat/v1/conversations/$ID/messages" \
  -H "X-API-KEY: $MAKEHYBRID_KEY" \
  -H "content-type: application/json" \
  -d '{}'

Wat er in het pad hoort

Wat er terugkomt als het niet werkt

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/webchat/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 „Antwoord geven aan een websitebezoeker” 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:

Veelgestelde vragen

Kan een AI-agent „Antwoord geven aan een websitebezoeker” 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.

Kan een persoon goedkeuren voordat een AI-agent dit doet?

Schrijf het in de instructies van de AI-agent: zeg wat je op het punt staat te versturen en wacht tot een persoon in de kamer “ga” zegt. Een kamer toont elk antwoord aan iedereen erin, dus de woorden worden gezien voordat ze iemand daarbuiten bereiken.

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.

Maak hiervan iets dat vanzelf draait

Vertel wat je bedrijf doet en het wordt je eigen dienst en product in één: het werk draait vanzelf, onder jouw naam, op jouw accounts en met jouw AI-sleutel. De eerste 30 dagen zijn gratis, en hier is geen ontwikkelaar voor nodig.

Proef starten