Cum construiți un agent WhatsApp cu OpenAI Agents SDK

OpenAI Agents SDK este framework-ul open-source al OpenAI pentru construirea agenților: un model cu instrucțiuni, instrumente pe care le poate apela, predări către alți agenți și măsuri de protecție pentru intrările și ieșirile sale, toate rulate într-o buclă până când sarcina este încheiată. Este o modalitate excelentă de a construi un agent. Dar, singur, nu vă oferă un număr WhatsApp, un inbox de echipă, mesaje șablon sau o cale prin care o persoană să preia conversația. Cu Agent Harness de la MonoChat alegeți OpenAI Agents SDK ca AI Harness, puneți un nod AI Agent într-un flux, conectați WhatsApp și testați, iar MonoChat se ocupă de restul.

Acest ghid acoperă ce vă oferă SDK-ul, cele trei moduri de a folosi agenți OpenAI în MonoChat, o configurare pas cu pas și detaliile specifice WhatsApp care decid dacă clienții au încredere în agent.

Ce vă oferă OpenAI Agents SDK

SDK-ul este construit în jurul unui set mic de idei:

• Agenți: un model plus instrucțiuni care descriu sarcina sa.
• Instrumente: funcții pe care agentul le poate apela, precum „caută o comandă” sau „verifică un interval orar”, plus servere MCP.
• Predări (handoffs): un agent care transmite sarcina altuia specializat în ea, de exemplu de la un agent general de suport la un agent pentru retururi.
• Măsuri de protecție (guardrails): verificări care rulează alături de agent pentru a opri intrările sau ieșirile nedorite.
• Sesiuni și trasare: memorie pe parcursul schimburilor și o evidență a ceea ce a făcut agentul, pas cu pas.

Împreună, acestea formează un agent harness: bucla care permite unui model să acționeze, să își verifice munca și să continue, în loc să răspundă o singură dată. În mesageria cu clienții, asta este diferența dintre a explica politica dvs. de retur și a crea efectiv returul.

Ce adaugă WhatsApp problemei

Construirea agentului este jumătate din treabă. Punerea lui în fața clienților pe WhatsApp înseamnă să gestionați:

• WhatsApp Business Platform. O conexiune API oficială, o companie verificată și un număr aprobat.
• Fereastra de 24 de ore. Răspunsurile libere sunt permise în 24 de ore de la ultimul mesaj al clientului; după aceea aveți nevoie de un șablon aprobat.
• Politica. Din 15 ianuarie 2026, WhatsApp ține asistenții AI de uz general în afara platformei. Un agent care servește propriii dvs. clienți este permis, iar o cale clară către un om este așteptată când răspunsurile sunt automate.
• Oamenii. Unele conversații trebuie să ajungă la o persoană, cu istoricul intact, în instrumentul pe care echipa dvs. îl folosește deja.
• Alte canale. Clienții care scriu pe Instagram, Messenger sau pe site se așteaptă la aceleași răspunsuri.

MonoChat se ocupă de acestea în jurul agentului, astfel încât munca dvs. rămâne la agentul însuși.

Trei moduri de a folosi agenți OpenAI în MonoChat

Opțiune	Unde rulează	Ce vă trebuie
OpenAI Agents SDK	În MonoChat	Nimic în plus; folosește modelele dvs. AI
OpenAI Agents API (găzduit de OpenAI)	Cloud-ul OpenAI	Cheia dvs. API OpenAI
Custom (propriul serviciu Agents SDK)	Propriul server	Un URL de endpoint și un secret partajat

Începeți cu harness-ul OpenAI Agents SDK dacă vreți un agent în stil OpenAI fără să implementați nimic. Alegeți OpenAI Agents API dacă agenții dvs. trăiesc deja pe platforma găzduită a OpenAI. Alegeți Custom dacă dezvoltatorii dvs. și-au scris propriul agent cu SDK-ul, cu propriile instrumente, predări și teste, și vor să continue să ruleze acel cod; vedeți cum conectați propriul agent AI la WhatsApp.

Pas cu pas: un agent OpenAI Agents SDK pe WhatsApp

1. Adăugați un AI Harness

Adăugați un AI Harness în MonoChat și alegeți OpenAI Agents SDK ca furnizor. Rulează în MonoChat și folosește modelele AI pe care le-ați configurat deja, deci nu există chei sau servere suplimentare pentru acest pas.

2. Adăugați un nod AI Agent într-un flux

În fluxul care primește conversațiile dvs. WhatsApp, adăugați un nod AI Agent și selectați harness-ul. Scrieți instrucțiunile agentului: cui servește, ce poate face, ce nu are voie să facă niciodată și când predă conversația.

3. Alegeți modelele principal, de rezervă și rapid

Fiecare nod AI Agent are trei roluri de model:

• Modelul principal raționează și scrie răspunsurile.
• Modelul de rezervă preia după o limită soft sau o eroare.
• Modelul rapid se ocupă de munca din fundal.

Adăugați o limită de buget pe rulare, astfel încât o conversație neobișnuită să nu genereze o factură mare. Nu sunteți sigur cum alegeți rezerva? Citiți de ce agentul dvs. AI orientat către clienți are nevoie de un model de rezervă.

4. Conectați instrumentele

Oferiți agentului instrumentele care se potrivesc celor mai frecvente solicitări:

• Instrumente de funcții AI pentru apeluri către propriile API-uri, cu intrări structurate.
• Integrare MCP pentru instrumente din sisteme compatibile MCP.
• Baza de cunoștințe AI pentru răspunsuri bazate pe documentele și politicile dvs.
• Funcții personalizate pentru logică care rulează în interiorul conversației.

Trei instrumente bune valorează mai mult decât cincisprezece testate pe jumătate. Adăugați mai multe după ce vedeți conversații reale.

5. Conectați WhatsApp (și restul)

Conectați numărul WhatsApp Business prin MonoChat, partener oficial Meta Business Partner. Același flux poate rula pe Instagram, Messenger, TikTok, Telegram, web chat, SMS și voce, deci un singur agent acoperă fiecare canal.

6. Testați cu mesaje reale

Folosiți conversațiile din luna trecută ca set de testare. Includeți-le pe cele dificile: clienți furioși, întrebări vagi, mai multe solicitări într-un singur mesaj, un client care cere imediat o persoană. Verificați apelurile de instrumente, tonul și predarea. Apoi lansați.

Tipare care funcționează bine pe WhatsApp

O întrebare pe mesaj. Agenții construiți pentru chat pe web tind să răspundă cu liste lungi. Pe telefon, mesajele scurte și o singură întrebare clară pe rând primesc răspunsuri mai bune de la clienți.

Confirmați înainte de acțiuni ireversibile. Lăsați agentul să propună, iar clientul să confirme, înainte de o anulare, o rambursare sau o modificare de rezervare.

Specialiști prin predări între agenți, oameni prin inbox. Predările din SDK sunt excelente pentru rutarea între agenți (vânzări, suport, retururi). Predarea către o persoană aparține inboxului comun al echipei din MonoChat, unde conversația ajunge cu tot istoricul.

Instrucțiuni care numesc limitele. „Rambursări de până la 50 € puteți aproba; peste această sumă, predați echipei de facturare.” Cifrele explicite bat regulile vagi.

Rămâneți la afacerea dvs. Un agent care își ajută clienții este permis pe WhatsApp. Unul care răspunde la orice riscă să încalce regulile WhatsApp din 2026; ghidul nostru despre politica WhatsApp pentru chatboți AI explică unde este limita.

Costuri

Se adună trei lucruri: planul dvs. MonoChat, utilizarea modelelor AI și taxele Meta pentru mesajele WhatsApp. Din 1 octombrie 2026, Meta taxează răspunsurile de serviciu după primele 1.000 pe număr de companie în fiecare lună; vedeți ghidul nostru despre prețurile WhatsApp API.

Pe partea de AI, MonoChat nu adaugă niciun adaos când folosiți propriile chei de furnizor. Bugetele pe rulare, un model rapid mai ieftin pentru munca din fundal și o rezervă fiabilă mențin factura previzibilă.

Fără blocare la un furnizor

Agent Harness vă lasă să alegeți framework-ul, nu doar modelul. Dacă mai târziu vreți să încercați Claude Agent SDK, Pi, Claude Managed Agents sau propriul framework, adăugați un alt AI Harness și îndreptați nodul AI Agent către el. Canalele, instrumentele și predarea rămân cum sunt. Comparați toți furnizorii pe pagina Agent Harness.