Aduceți propriul agent AI în WhatsApp: conectați orice framework (LangGraph, ADK, personalizat) printr-un endpoint webhook

Puteți conecta aproape orice agent AI la WhatsApp fără să îl rescrieți. Rulați agentul, construit cu LangGraph, Google ADK, CrewAI sau cu propriul cod, în spatele unui endpoint HTTPS, apoi adăugați-l în MonoChat ca AI Harness cu furnizorul Custom: un URL de endpoint și un secret partajat. Puneți un nod AI Agent într-un flux, conectați numărul WhatsApp, iar agentul dvs. răspunde clienților pe WhatsApp și pe fiecare alt canal conectat de MonoChat, cu un inbox comun și predare către un om în jurul lui.

Acest ghid este pentru echipele care au deja un agent sau vor control deplin asupra modului în care funcționează. Acoperă când are sens să vă aduceți propriul agent, de ce răspunde endpoint-ul dvs., configurarea în MonoChat și detaliile care contează în producție.

De ce să vă aduceți propriul agent?

Majoritatea platformelor de mesagerie pentru clienți vin cu un singur agent AI integrat. Este convenabil până când:

• Agentul dvs. este deja construit. Dezvoltatorii dvs. au petrecut luni întregi pe un graf LangGraph sau pe o configurație multi-agent ADK, cu evaluări și teste. Reconstruirea lui în builder-ul de boți al unui furnizor aruncă acea muncă.
• Aveți nevoie de propria logică. Reguli de preț, verificări de eligibilitate, pași de conformitate sau sisteme interne la care ajunge doar codul dvs.
• Vreți să alegeți framework-ul. Framework-urile se mișcă repede. Astăzi este LangGraph; anul viitor poate fi altceva. Canalele și inboxul dvs. nu ar trebui să se schimbe odată cu el.
• Datele trebuie să rămână la dvs. Unele organizații vor ca raționamentul agentului și apelurile de instrumente să ruleze pe propria infrastructură.

Agent Harness de la MonoChat este construit pentru asta: aduceți propriul framework de agenți și păstrați tot ce îl înconjoară, canalele, inboxul, oamenii, într-un singur loc.

Cum funcționează harness-ul Custom

Gândiți-vă la el ca la o împărțire a muncii.

MonoChat se ocupă de stratul de conversație:

• Conexiunile oficiale la WhatsApp, Instagram, Messenger, TikTok, Telegram, web chat, SMS și voce (MonoChat este partener oficial Meta Business Partner).
• Fluxul care decide când este apelat agentul, prin nodul AI Agent.
• Inboxul comun al echipei, unde o persoană poate prelua cu tot istoricul.

Endpoint-ul dvs. se ocupă de agent:

• Primirea conversației de la MonoChat.
• Rularea agentului dvs.: raționamentul, instrumentele, memoria.
• Returnarea răspunsului agentului.

Între ele se află un secret partajat, o valoare pe care o cunosc ambele părți, astfel încât endpoint-ul dvs. să poată verifica faptul că o cerere vine de la contul dvs. MonoChat. MonoChat definește formatul exact al cererii și al răspunsului pe care îl implementează endpoint-ul dvs.; dacă nu îl aveți încă, vorbiți cu noi și îl vom transmite dezvoltatorilor dvs.

Ce ar trebui să facă endpoint-ul dvs.

Indiferent de framework, un endpoint de agent pregătit pentru producție are câteva sarcini.

Verificați fiecare cerere

Verificați secretul partajat la fiecare apel și respingeți tot ce nu se potrivește. Păstrați secretul în managerul de secrete sau în variabilele de mediu, nu în cod, și schimbați-l dacă a fost vreodată expus.

Păstrați fiecare conversație separată

Clienții scriu în paralel. Asigurați-vă că starea, memoria și orice fișiere de lucru ale agentului dvs. sunt limitate la o singură conversație, astfel încât datele unui client să nu ajungă niciodată în răspunsul altuia.

Răspundeți în mesaje de dimensiune potrivită pentru chat

Agenții construiți pentru aplicații web tind să scrie răspunsuri lungi și formatate. WhatsApp se citește pe telefon. Cereți agentului mesaje scurte, o întrebare pe rând, și evitați Markdown-ul încărcat în răspunsuri.

Eșuați zgomotos, nu în tăcere

Dacă un instrument expiră sau furnizorul de modele returnează o eroare, returnați o eroare clară, nu un răspuns pe jumătate gata. O eroare previzibilă permite fluxului să facă ce trebuie, de exemplu să predea conversația unei persoane.

Fiți rapid

Clienții se așteaptă la un răspuns în câteva secunde. Țineți munca de lungă durată în afara căii răspunsului unde puteți și faceți instrumentele rapide sau asincrone.

Pas cu pas în MonoChat

1. Implementați agentul în spatele HTTPS

Găzduiți agentul LangGraph, ADK, CrewAI sau personalizat pe propriul server sau cloud, accesibil prin HTTPS. Implementați formatul de cerere și răspuns al MonoChat și verificarea secretului partajat.

2. Adăugați un AI Harness cu furnizorul Custom

În MonoChat, adăugați un AI Harness, alegeți Custom și introduceți URL-ul endpoint-ului și secretul partajat. Adăugați harness-ul o singură dată și îl puteți folosi în câte fluxuri doriți.

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

În fluxul care primește conversațiile, adăugați un nod AI Agent și selectați harness-ul personalizat. Folosiți fluxul din jurul lui pentru ce fac fluxurile cel mai bine: salut, rutare după limbă sau subiect, program de lucru și calea către o persoană.

4. Stabiliți un buget pe rulare

Fiecare nod AI Agent acceptă limite de buget pe rulare. Folosiți-le ca plasă de siguranță alături de limitele pe care le aplicați deja în propriul cod.

5. Conectați WhatsApp și celelalte canale

Conectați numărul WhatsApp Business, apoi atașați același flux la celelalte canale pe care le folosiți. Nu există muncă de integrare suplimentară pentru fiecare canal: endpoint-ul dvs. vede conversații, nu API-uri de canal.

6. Testați, apoi lansați

Reluați mesaje reale ale clienților prin flux. Verificați apelurile de instrumente, timpii de răspuns, tonul și predarea. Urmăriți atent primele zile de trafic real, apoi extindeți ce are voie să facă agentul.

Note despre framework-uri

LangGraph. Un graf de noduri și muchii se potrivește natural parcursurilor de suport (triaj, căutare, rezolvare, escaladare). Încapsulați graful compilat într-un mic serviciu HTTP, încărcați starea conversației la fiecare cerere și returnați mesajul final.

Google ADK. Arborii multi-agent ai ADK, un coordonator cu sub-agenți specializați, se potrivesc bine echipelor de suport, vânzări și facturare. Expuneți agentul rădăcină prin endpoint și lăsați ADK să facă rutarea intern.

CrewAI. Echipele de agenți bazați pe roluri funcționează bine pentru sarcini cu predări clare, precum cercetare apoi răspuns. Păstrați echipele mici pentru chat: fiecare agent în plus adaugă latență.

Propriul cod. O buclă simplă cu un API de model și câteva funcții este adesea suficientă. Păstrați control total, iar MonoChat vă oferă canalele și inboxul.

Predarea: decideți în flux

Decideți în flux ce conversații merg la o persoană și ce echipă le primește și scrieți agentul astfel încât să îi spună onest clientului când nu poate ajuta, în loc să ghicească. Fluxul predă apoi conversația echipei potrivite în inboxul comun, cu tot istoricul. Politica WhatsApp Business Messaging se așteaptă, de asemenea, ca răspunsurile automate să ofere o cale clară către un om.

Păstrați agentul și în limitele afacerii dvs. Din 15 ianuarie 2026, WhatsApp ține asistenții AI de uz general în afara platformei; agenții care servesc propriii dvs. clienți sunt în regulă. Ghidul nostru despre politica WhatsApp pentru chatboți AI explică regula.

Când să nu vă construiți propriul agent

Un agent personalizat este cea mai flexibilă opțiune și, totodată, cea pe care o mențineți dvs. Dacă porniți de la zero, o opțiune integrată vă pune în funcțiune mai repede, fără nimic de găzduit:

• Harness-ul integrat MonoChat, pe modelele dvs. AI din MonoChat.
• OpenAI Agents SDK, rulat în MonoChat (ghid).
• Claude Agent SDK sau Pi, rulate pe agent runner-ul MonoChat (ghid Claude).
• Agenți găzduiți: OpenAI Agents API sau Claude Managed Agents, cu propria cheie.

Deoarece fiecare opțiune folosește același nod AI Agent, puteți începe cu una și trece mai târziu la propriul agent fără să atingeți canalele sau predarea. Comparați-le pe pagina Agent Harness.