Cum construiești un produs cu agent AI pe WhatsApp, Instagram și TikTok ai clienților tăi
Un produs cu agent AI pe canalele clienților se sprijină pe trei elemente: un link găzduit de conectare pentru fiecare număr WhatsApp sau cont social al clientului, webhook-uri care aduc mesajele și comentariile clienților către backend-ul tău, unde propriul tău model scrie răspunsuri trimise prin API-ul oficial al fiecărei rețele, cu token-ul clientului, și evenimente de stare pentru conexiunile care se întrerup. Agentul respectă regulile fiecărei rețele, precum fereastra de 24 de ore a WhatsApp.
easyCoexistence oferă agenților AI ai produsului tău o voce pe numerele WhatsApp ale clienților și pe conturile lor de Instagram, Facebook, TikTok, YouTube și LinkedIn, plus alte canale: linkuri găzduite de conectare, credențiale proaspete, webhook-uri și evenimente de stare semnate pe API-ul oficial al fiecărei rețele, cu fiecare conexiune monitorizată 24/7.
Fereastra de serviciu pentru clienți a WhatsApp după un mesaj sau apel al utilizatorului; fiecare mesaj nou o resetează.
Ce poate trimite o firmă WhatsApp după ce fereastra de serviciu pentru clienți se închide: mesaje șablon aprobate în prealabil.
Termenii Meta interzic furnizorilor de AI să folosească WhatsApp pentru a oferi AI ca funcționalitate principală, nu incidentală.
Fereastra pentru unicul răspuns privat la un comentariu al unui cont Instagram, numărată de la momentul în care a fost făcut comentariul.
Debitul fix al unui număr folosit atât cu aplicația WhatsApp Business, cât și cu Cloud API.
De ce are nevoie un produs cu agent AI de canalul fiecărui client?
Patru lucruri: o cale prin care clientul îl conectează, mesajele lui ajunse la backend-ul tău, un token cu care să răspunzi și un semnal căS-a întrerupt conexiunea. Partner API acoperă fiecare dintre ele, în timp ce modelul, prompturile și logica conversațiilor rămân ale tale. easyCoexistence conectează contul, îi reînnoiește accesul și îl monitorizează, iar răspunsurile tale merg de la backend direct la API-ul rețelei.
Cum se conectează fiecare client?
Backend-ul tău creează o sesiune de conectare cu POST /connect-sessions, indicând canalul, un redirect_url și un external_ref pentru clientul tău, iar pentru un număr, webhook_url și webhook_verify_token. Clientul deschide linkul găzduit, se autentifică cu Meta, TikTok, Google sau LinkedIn și revine în aplicația ta cu connection_id sau channel_id. Nu are nevoie de cont easyCoexistence, e-mail sau card, iar fiecare conexiune făcută cu cheia ta aparține contului tău.
Cum ajung mesajele și comentariile la modelul tău?
Prin webhook, pe rețelele care le trimit. Meta livrează mesajele unui număr direct la webhook_url, iar mesajele trimise de angajații firmei din aplicația WhatsApp Business ajung acolo ca smb_message_echoes. Comentariile, mențiunile și mesajele directe de pe Instagram și Facebook, precum și comentariile de pe TikTok, sunt redirecționate către destinația fiecărui canal, semnate cu secretul acestuia. YouTube și LinkedIn nu trimit evenimente de comentarii, deci agentul citește comentariile noi prin API-urile lor, după un program. Răspunde fiecărei livrări cu 2xx imediat și lasă un worker să apeleze modelul.
Cum răspunde agentul?
Prin API-ul propriu al rețelei, cu credențialele pe care le-a luat backend-ul tău. Un răspuns WhatsApp este un POST către send_endpoint-ul numărului, cu token-ul clientului; un mesaj direct pe Instagram sau Facebook merge către messages edge al contului; un răspuns TikTok se postează sub comentariu prin business/comment/reply/create/. Schița de mai jos răspunde la mesajele WhatsApp: verifică secretul din calea URL-ului, pune în coadă fiecare mesaj primit și răspunde cu ce returnează modelul tău.
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request
EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"} # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"] # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {} # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)
@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
if not hmac.compare_digest(secret, PATH_SECRET):
abort(404)
if request.method == "GET": # Meta's handshake when the destination is set
if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
abort(403)
return request.args.get("hub.challenge", "")
for entry in request.get_json().get("entry", []):
for change in entry.get("changes", []):
if change.get("field") == "messages": # echoes and history are context, not prompts
value = change["value"]
for msg in value.get("messages", []):
jobs.put((value["metadata"]["phone_number_id"], msg))
return "", 200 # answer at once; dedupe on msg["id"], since Meta can deliver twice
def worker() -> None:
while True:
phone_number_id, msg = jobs.get()
conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
headers=KEY, params={"credentials": 1}).json()
creds = conn["credentials"]
if not creds["access_token"]: # token_ready is false: a new connect session issues one
continue
reply = my_model(conn["external_ref"], msg) # your model, your prompt, your memory
requests.post(creds["send_endpoint"], # a reply to a fresh message is inside the 24 hours
headers={"Authorization": f"Bearer {creds['access_token']}"},
json={"messaging_product": "whatsapp", "to": msg["from"],
"type": "text", "text": {"body": reply}})
threading.Thread(target=worker, daemon=True).start()Serverul MCP sau Partner API: pe care îl folosește agentul?
Partner API, când agentul este produsul tău, iar clienții tăi aduc canalele: backend-ul tău deține cheia, primește evenimentele și rulează orice model alegi. Serverul MCP de la https://easycoexistence.com/api/mcp se potrivește unui asistent precum Claude sau ChatGPT care acționează în contul tău easyCoexistence, prin instrumente pe care le apelează la cerere, după o autentificare OAuth. Numerele și canalele conectate cu cheia ta se află și ele în acel cont, așa că o sesiune MCP le poate accesa pentru munca echipei tale.
| Partner API | MCP server | |
|---|---|---|
| Built for | Your product, serving your customers | An assistant working on your own account |
| Signs in with | An ec_live_ key, one per account | OAuth, from Claude, ChatGPT or another client |
| Incoming messages | Webhooks to your backend | Read when the assistant calls a tool |
| The model | Any model you run | The assistant's own |
| Replies | Your code calls each network's API | Tools such as send_message and reply_to_comment |
Cum rulează agențiile agenți pentru mulți clienți?
Pe un singur cont, cu fiecare client etichetat. Transmite ID-ul clientului ca external_ref la fiecare sesiune de conectare, afișează numele agenției tale pe pagina găzduită cu partner_name și listează conexiunile unui client cu GET /connections?external_ref= și GET /channels?external_ref=. Fiecare conexiune se facturează agenției de la US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adaugi conexiuni, în timp ce Meta facturează taxele de conversație WhatsApp contului WhatsApp Business Account al clientului. Cu Coexistence, angajații clientului răspund în continuare în aplicația WhatsApp Business, alături de agent.
Ce reguli trebuie să respecte agentul?
Regulile rețelelor, pe care codul tău ar trebui să le verifice înainte ca răspunsul modelului să plece. Platformele le păstrează în numele clienților lor, deoarece aplicarea de către Meta cade asupra contului clientului:
- WhatsApp: răspunsuri libere doar în 24 de ore de la ultimul mesaj al clientului; după aceea, un șablon aprobat, trimis prin API, pentru că aplicația WhatsApp Business nu poate trimite șabloane în Coexistence.
- WhatsApp: termenii Meta interzic oferirea AI ca funcționalitate principală, ceea ce referința Partner API traduce prin lipsa boților AI de uz general, și permit reglarea fină pe datele WhatsApp doar pentru uzul exclusiv al firmei.
- Instagram și Facebook: mesaje directe în 24 de ore de la ultimul mesaj al persoanei și un singur răspuns privat la fiecare comentariu, în 7 zile de la acesta.
- TikTok: răspunsurile la comentarii sunt publice, pentru că o conexiune TikTok nu are mesaje directe.
- Volum: 20 de mesaje pe secundă pentru fiecare număr Coexistence, iar șabloanele de marketing necesită o metodă de plată în contul WhatsApp Business Account al clientului.
Cum află agentul că un canal a încetat să funcționeze?
Din evenimentele de stare. connection.disconnected sau channel.disconnected înseamnă că răspunsurile eșuează până când clientul se reconectează, deci oprește agentul acelui client, anunță-l și trimite un link nou de conectare; connection.token_missing înseamnă că numărul poate primi, dar nu poate trimite încă. Când sosește din nou connection.connected sau channel.connected, preia credențiale proaspete și reia. Fiecare eveniment este semnat cu X-EC-Signature și reîncercat timp de aproximativ 33 de ore.
Greșeli frecvente
- Lăsarea modelului să răspundă cu text liber unui mesaj WhatsApp mai vechi de 24 de ore. Fereastra s-a închis, deci verifică ora ultimului mesaj primit de la client și treci la un șablon aprobat.
- Antrenarea unui model comun pe conversațiile WhatsApp ale clienților. Termenii Meta permit reglarea fină pe datele WhatsApp Business Platform doar pentru uzul exclusiv al firmei, niciodată pentru a îmbunătăți alte modele.
- Tratarea smb_message_echoes ca mesaje ale clienților. Acestea sunt ce au trimis angajații firmei din aplicație, deci dă-le modelului ca context, nu ca mesaje la care trebuie să răspundă.
- Răspunsul la propriile răspunsuri ale contului. Mesajele directe pe care le trimite contul revin ca echo-uri, iar răspunsurile TikTok ca evenimente de comentariu, deci ignoră orice a scris contul, altfel agentul răspunde singur.
De la US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adaugi conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Pot folosi propriul meu model AI?
Da. Backend-ul tău primește mesajele, apelează orice model alegi și răspunde prin API-ul rețelei cu token-ul clientului. Mesajele unui număr WhatsApp merg de la Meta direct la webhook-ul tău, niciodată prin easyCoexistence.
Ce înseamnă politica AI a Meta pentru un agent WhatsApp?
Termenii Meta interzic furnizorilor de AI să folosească WhatsApp Business Platform pentru a oferi tehnologie AI ca funcționalitate principală, nu incidentală sau accesorie, așa cum stabilește Meta. Respect-o în numele clienților tăi, împreună cu fereastra de 24 de ore și șabloanele aprobate.
Poate agentul să trimită mesaje directe pe TikTok, YouTube sau LinkedIn?
Nu. Pe aceste rețele agentul lucrează în comentarii: răspunsurile TikTok sunt publice, iar comentariile de pe YouTube și LinkedIn sunt citite și li se răspunde prin API-urile lor.
Cât costă easyCoexistence pentru un produs cu agent AI?
Pe conexiune, la fel pe fiecare rețea: de la US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adaugi conexiuni, cu primele 3 zile gratuite. Meta facturează taxele de conversație WhatsApp contului WhatsApp Business al fiecărui client.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la