Zo bouwt u een WhatsApp-agent met de OpenAI Agents SDK

De OpenAI Agents SDK is het open-sourceframework van OpenAI om agents te bouwen: een model met instructies, tools die het mag aanroepen, handoffs naar andere agents en guardrails rond invoer en uitvoer, alles in een lus uitgevoerd tot de taak klaar is. Het is een uitstekende manier om een agent te bouwen. Het geeft u op zichzelf geen WhatsApp-nummer, teaminbox, templateberichten of manier waarop een medewerker kan overnemen. Met de Agent Harness van MonoChat kiest u de OpenAI Agents SDK als AI Harness, plaatst u een AI Agent-node in een flow, koppelt u WhatsApp en test u, en MonoChat regelt de rest.

Deze gids behandelt wat de SDK u biedt, de drie manieren om OpenAI-agents in MonoChat te gebruiken, een stapsgewijze installatie en de WhatsApp-specifieke details die bepalen of klanten de agent vertrouwen.

Wat de OpenAI Agents SDK u biedt

De SDK is gebouwd rond een kleine set ideeën:

• Agents: een model plus instructies die zijn taak beschrijven.
• Tools: functies die de agent kan aanroepen, zoals “een bestelling opzoeken” of “een tijdslot controleren”, plus MCP-servers.
• Handoffs: een agent die de taak doorgeeft aan een andere die erin gespecialiseerd is, bijvoorbeeld van een algemene supportagent naar een retouragent.
• Guardrails: controles die naast de agent draaien om ongewenste invoer of uitvoer te stoppen.
• Sessies en tracing: geheugen over beurten heen en een overzicht van wat de agent stap voor stap deed.

Samen is dat een agent harness: de lus waarmee een model kan handelen, zijn werk kan controleren en kan doorgaan, in plaats van één keer te antwoorden. Voor klantberichten is dat het verschil tussen uw retourbeleid uitleggen en daadwerkelijk de retour aanmaken.

Wat WhatsApp aan het probleem toevoegt

De agent bouwen is de helft van het werk. Hem voor klanten op WhatsApp zetten betekent dat u het volgende moet regelen:

• Het WhatsApp Business Platform. Een officiële API-verbinding, een geverifieerd bedrijf en een goedgekeurd nummer.
• Het venster van 24 uur. Vrije antwoorden zijn toegestaan binnen 24 uur na het laatste bericht van de klant; daarna heeft u een goedgekeurde template nodig.
• Beleid. Sinds 15 januari 2026 houdt WhatsApp algemene AI-assistenten van het platform. Een agent die uw eigen klanten bedient, is toegestaan en een duidelijke weg naar een medewerker wordt verwacht wanneer antwoorden geautomatiseerd zijn.
• Mensen. Sommige gesprekken moeten naar een medewerker, met intacte geschiedenis, in de tool die uw team al gebruikt.
• Andere kanalen. Klanten die schrijven op Instagram, Messenger of uw website verwachten dezelfde antwoorden.

MonoChat regelt dit rond de agent, zodat uw werk bij de agent zelf blijft.

Drie manieren om OpenAI-agents te gebruiken in MonoChat

Optie	Waar het draait	Wat u nodig heeft
OpenAI Agents SDK	Binnen MonoChat	Niets extra; gebruikt uw AI-modellen
OpenAI Agents API (gehost door OpenAI)	De cloud van OpenAI	Uw OpenAI API-sleutel
Custom (uw eigen Agents SDK-service)	Uw eigen server	Een endpoint-URL en een gedeeld geheim

Begin met de OpenAI Agents SDK-harness als u een agent in OpenAI-stijl wilt zonder iets te implementeren. Kies de OpenAI Agents API als uw agents al op het gehoste platform van OpenAI leven. Kies Custom als uw ontwikkelaars met de SDK een eigen agent hebben geschreven, met eigen tools, handoffs en tests, en die code willen blijven draaien; zie hoe u uw eigen AI-agent aan WhatsApp koppelt.

Stap voor stap: een OpenAI Agents SDK-agent op WhatsApp

1. Voeg een AI Harness toe

Voeg in MonoChat een AI Harness toe en kies OpenAI Agents SDK als provider. Die draait binnen MonoChat en gebruikt de AI-modellen die u al heeft ingesteld, dus voor deze stap zijn er geen extra sleutels of servers.

2. Voeg een AI Agent-node toe aan een flow

Voeg in de flow die uw WhatsApp-gesprekken ontvangt een AI Agent-node toe en selecteer de harness. Schrijf de instructies van de agent: wie hij bedient, wat hij kan doen, wat hij nooit mag doen en wanneer hij overdraagt.

3. Kies het hoofd-, fallback- en snelle model

Elke AI Agent-node heeft drie modelrollen:

• Het hoofdmodel redeneert en schrijft de antwoorden.
• Het fallbackmodel neemt over na een zachte limiet of een storing.
• Het snelle model verwerkt achtergrondwerk.

Voeg een budgetlimiet per run toe zodat één ongewoon gesprek geen hoge rekening kan opleveren. Weet u niet hoe u de fallback kiest? Lees waarom uw AI-agent voor klantcontact een fallbackmodel nodig heeft.

4. Koppel uw tools

Geef de agent de tools die passen bij uw meest voorkomende verzoeken:

• AI-functietools voor aanroepen van uw eigen API’s met gestructureerde invoer.
• MCP-integratie voor tools uit MCP-compatibele systemen.
• De AI-kennisbank voor antwoorden die zijn gebaseerd op uw documenten en beleid.
• Aangepaste functies voor logica die binnen het gesprek draait.

Drie goede tools zijn beter dan vijftien half geteste. Voeg er meer toe zodra u echte gesprekken ziet.

5. Koppel WhatsApp (en al het andere)

Koppel uw WhatsApp Business-nummer via MonoChat, een officiële Meta Business Partner. Dezelfde flow kan draaien op Instagram, Messenger, TikTok, Telegram, webchat, SMS en voice, zodat één agent elk kanaal dekt.

6. Test met echte berichten

Gebruik de gesprekken van vorige maand als testset. Neem de moeilijke mee: boze klanten, vage vragen, meerdere verzoeken in één bericht, een klant die direct om een medewerker vraagt. Controleer de toolaanroepen, de toon en de overdracht. Ga daarna live.

Patronen die goed werken op WhatsApp

Eén vraag per bericht. Agents die voor chat op het web zijn gebouwd, antwoorden vaak met lange lijsten. Op een telefoon krijgt u betere reacties van klanten met korte berichten en telkens één duidelijke vraag.

Bevestig vóór onomkeerbare acties. Laat de agent voorstellen en de klant bevestigen voordat een annulering, terugbetaling of wijziging van een reservering plaatsvindt.

Specialisten via handoffs, mensen via de inbox. De handoffs van de SDK zijn ideaal om tussen agents te routeren (sales, support, retouren). Overdracht aan een medewerker hoort thuis in de gedeelde teaminbox van MonoChat, waar het gesprek met de volledige geschiedenis aankomt.

Instructies die de grenzen benoemen. “Terugbetalingen tot €50 mag u goedkeuren; daarboven draagt u over aan het billingteam.” Expliciete bedragen winnen het van vage regels.

Houd het bij uw bedrijf. Een agent die uw klanten helpt, is toegestaan op WhatsApp. Een agent die op alles antwoordt, riskeert een overtreding van de WhatsApp-regels van 2026; onze gids over het WhatsApp AI-chatbotbeleid legt uit waar de grens ligt.

Kosten

Drie dingen tellen op: uw MonoChat-abonnement, het gebruik van het AI-model en de WhatsApp-berichtkosten van Meta. Sinds 1 oktober 2026 rekent Meta servicebeantwoordingen af na de eerste 1.000 per zakelijk nummer per maand; zie onze gids over WhatsApp API-prijzen.

Aan de AI-kant rekent MonoChat geen opslag wanneer u uw eigen providersleutels gebruikt. Budgetten per run, een goedkoper snel model voor achtergrondwerk en een betrouwbare fallback houden de rekening voorspelbaar.

Niet vastgezet

Met Agent Harness kiest u het framework, niet alleen het model. Als u later de Claude Agent SDK, Pi, Claude Managed Agents of uw eigen framework wilt proberen, voegt u een andere AI Harness toe en wijst u de AI Agent-node daarnaar. Uw kanalen, tools en overdracht blijven zoals ze zijn. Vergelijk alle providers op de Agent Harness-pagina.