Direct bericht naar één persoon op X verzenden is een POST op /x/v1/2/dm_conversations/with/{participant_id}/messages, in de MakeHybrid X API: het eigen X-account van je organisatie, via de sleutels van je eigen X-app. Elk verzoek draagt je eigen sleutel in een X-API-KEY-header — dezelfde sleutel als die van de LinkedIn API — en bereikt alleen het account dat je organisatie heeft gekoppeld.
De aanroepen gaan uit onder de sleutels van je eigen X-app, dus de limieten die gelden zijn die van je app, zoals X ze telt voor het abonnement van je app.
Het verzoek
curl -X POST "https://makehybrid.com/x/v1/2/dm_conversations/with/$PARTICIPANT_ID/messages" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
Wat er in het pad hoort
- participant_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/x/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 „Direct bericht naar één persoon op X verzenden” 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 toon de directe berichten van vandaag op X en schrijf bij elk een conceptantwoord.
Veelgestelde vragen
Kan een AI-agent „Direct bericht naar één persoon op X verzenden” 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.