Kako napraviti proizvod sa AI agentom na WhatsApp-u, Instagramu i TikTok-u vaših klijenata
Proizvod sa AI agentom na kanalima vaših klijenata oslanja se na tri dela: hostovani link za povezivanje za WhatsApp broj ili društveni nalog svakog klijenta, webhookove koji njihove poruke i komentare šalju na vaš backend, gde vaš sopstveni model piše odgovore koji se preko zvaničnog API-ja svake mreže šalju uz token klijenta, i događaje o statusu za veze koje prestanu da rade. Agent poštuje pravila svake mreže, na primer 24-časovni prozor za WhatsApp.
easyCoexistence daje AI agentima vašeg proizvoda glas na WhatsApp brojevima vaših klijenata i na njihovim Instagram, Facebook, TikTok, YouTube i LinkedIn nalozima, uz još kanala koji se dodaju: hostovani linkovi za povezivanje, sveži kredencijali, webhookovi i potpisani događaji o statusu preko zvaničnog API-ja svake mreže, uz praćenje svake veze 24/7.
Period za korisničku podršku WhatsApp-a nakon poruke ili poziva korisnika; svaka nova poruka ga resetuje.
Šta WhatsApp firma može da pošalje kada period za korisničku podršku istekne: unapred odobrene šablon poruke.
Meta-ovi uslovi zabranjuju AI pružaocima da koriste WhatsApp za ponudu AI-ja kao glavne, a ne sporedne funkcije.
Rok za jedan privatni odgovor na komentar sa Instagram naloga, računat od trenutka kada je komentar napisan.
Fiksni protok broja koji se koristi i sa WhatsApp Business aplikacijom i sa Cloud API-jem.
Šta proizvod sa AI agentom treba od kanala svakog klijenta?
Četiri stvari: način da klijent poveže kanal, da njegove poruke stignu do vašeg backenda, token kojim se odgovara i obaveštenje kada veza prestane da radi. Partner API pokriva svaku od njih, dok model, promptovi i logika razgovora ostaju vaši. easyCoexistence povezuje nalog, obnavlja mu pristup i prati ga, a vaši odgovori idu sa vašeg backenda direktno na API mreže.
Kako se svaki klijent povezuje?
Vaš backend kreira sesiju za povezivanje pozivom POST /connect-sessions, navodeći kanal, redirect_url i external_ref za vašeg klijenta, a za broj još i webhook_url i webhook_verify_token. Klijent otvara hostovani link, prijavljuje se preko Meta, TikTok, Google ili LinkedIn naloga i vraća se u vašu aplikaciju sa connection_id ili channel_id. Nije mu potreban nalog easyCoexistence, e-pošta ni kartica, a svaka veza napravljena preko vašeg ključa pripada vašem nalogu.
Kako poruke i komentari stižu do vašeg modela?
Webhookom, na mrežama koje ih šalju. Meta isporučuje poruke broja direktno na njegov webhook_url, a ono što zaposleni u firmi pošalju iz WhatsApp Business aplikacije stiže tamo kao smb_message_echoes. Komentari, pominjanja i DM-ovi na Instagramu i Facebooku, kao i TikTok komentari, prosleđuju se na odredište svakog kanala, potpisani njegovim tajnim ključem. YouTube i LinkedIn ne šalju događaje o komentarima, pa agent nove komentare čita preko njihovih API-ja po rasporedu. Svaku isporuku odmah potvrdite sa 2xx, a model neka poziva radni proces.
Kako agent odgovara?
Preko API-ja same mreže, sa kredencijalima koje je vaš backend preuzeo. Odgovor na WhatsApp poruku je POST na send_endpoint broja sa tokenom klijenta; DM na Instagramu ili Facebooku ide na messages edge naloga; odgovor na TikTok šalje se ispod komentara preko business/comment/reply/create/. Primer ispod odgovara na WhatsApp poruke: proverava tajnu u putanji URL-a, stavlja u red svaku dolaznu poruku i odgovara onim što vrati vaš model.
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()MCP server ili Partner API: koji koristi agent?
Partner API, kada je agent vaš proizvod, a klijenti donose kanale: vaš backend čuva ključ, prima događaje i pokreće bilo koji model koji izaberete. MCP server na https://easycoexistence.com/api/mcp pogodan je za asistenta kao što su Claude ili ChatGPT koji radi na vašem sopstvenom easyCoexistence nalogu, preko alata koje poziva na zahtev nakon OAuth prijave. Brojevi i kanali povezani vašim ključem takođe su na tom nalogu, pa im MCP sesija može pristupiti za rad vašeg tima.
| 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 |
Kako agencije vode agente za mnogo klijenata?
Na jednom nalogu, pri čemu je svaki klijent označen. Prosledite ID klijenta kao external_ref u svakoj sesiji za povezivanje, prikažite ime vaše agencije na hostovanoj stranici preko partner_name i izlistajte veze jednog klijenta preko GET /connections?external_ref= i GET /channels?external_ref=. Svaka veza se agenciji naplaćuje od US$ 9 do US$ 0.75 po vezi mesečno, a cena pada kako dodajete veze, dok Meta naplaćuje troškove WhatsApp razgovora na WhatsApp Business nalogu samog klijenta. Uz Coexistence, zaposleni kod klijenta i dalje odgovaraju u WhatsApp Business aplikaciji pored agenta.
Koja pravila agent mora da poštuje?
Pravila samih mreža, koja vaš kod treba da proveri pre nego što odgovor modela ode. Platforme ih poštuju u ime svojih klijenata, jer Metine mere pogađaju nalog klijenta:
- WhatsApp: odgovori u slobodnom tekstu samo u roku od 24 sata od poslednje klijentove poruke; posle toga odobreni šablon, poslat preko API-ja, jer WhatsApp Business aplikacija u Coexistence ne može da šalje šablone.
- WhatsApp: Metini uslovi zabranjuju ponudu AI-ja kao glavne funkcije, što Partner API referenca svodi na zabranu botova opšte namene, i dozvoljavaju fino podešavanje modela na podacima sa WhatsApp-a samo za isključivu upotrebu firme.
- Instagram i Facebook: DM-ovi u roku od 24 sata od poslednje poruke osobe, i jedan privatni odgovor na komentar u roku od 7 dana od njega.
- TikTok: odgovori na komentare su javni, jer TikTok veza nema DM-ove.
- Obim: 20 poruka u sekundi po Coexistence broju, a marketinški šabloni zahtevaju način plaćanja na WhatsApp Business nalogu klijenta.
Kako agent zna da kanal više ne radi?
Iz događaja o statusu. connection.disconnected ili channel.disconnected znači da odgovori ne uspevaju dok klijent ponovo ne poveže nalog, pa zaustavite agenta tog klijenta, obavestite ga i pošaljite novi link za povezivanje; connection.token_missing znači da broj može da prima, ali još ne može da šalje. Kada ponovo stigne connection.connected ili channel.connected, preuzmite sveže kredencijale i nastavite. Svaki događaj se potpisuje sa X-EC-Signature i ponavlja oko 33 sata.
Česte greške
- Dozvoliti modelu da na WhatsApp poruku stariju od 24 sata odgovori slobodnim tekstom. Prozor je zatvoren, pa proverite vreme poslednje dolazne poruke klijenta i pređite na odobreni šablon.
- Treniranje zajedničkog modela na WhatsApp razgovorima klijenata. Metini uslovi dozvoljavaju fino podešavanje na podacima WhatsApp Business platforme samo za isključivu upotrebu firme, nikada za poboljšanje drugih modela.
- Tretiranje smb_message_echoes kao poruka klijenta. To su poruke koje su zaposleni firme poslali iz aplikacije, pa ih modelu dajte kao kontekst, a ne kao poruke na koje treba odgovoriti.
- Odgovaranje na sopstvene odgovore naloga. DM-ovi koje nalog pošalje na Instagramu vraćaju se kao echo, a TikTok odgovori kao događaji o komentarima, pa preskočite sve što je sam nalog napisao, inače agent odgovara sam sebi.
Od US$ 9 do US$ 0.75 po vezi mesečno, a cena pada kako dodajete veze, uz prva 3 dana besplatno.
Često postavljana pitanja
Mogu li da koristim sopstveni AI model?
Da. Vaš backend prima poruke, poziva bilo koji model koji izaberete i odgovara preko API-ja mreže sa tokenom klijenta. Poruke sa WhatsApp broja idu od Mete direktno na vaš webhook, nikada preko easyCoexistence.
Šta Metina AI politika znači za WhatsApp agenta?
Meta-ovi uslovi zabranjuju AI pružaocima da koriste WhatsApp Business Platform za ponudu AI tehnologije kao glavne, a ne sporedne ili pomoćne funkcije, kako Meta odredi. Držite se toga u ime svojih klijenata, zajedno sa 24-časovnim prozorom i odobrenim šablonima.
Može li agent da šalje DM-ove na TikToku, YouTubeu ili LinkedInu?
Ne. Na tim mrežama agent radi u komentarima: odgovori na TikToku su javni, a komentari na YouTubeu i LinkedInu čitaju se i na njih se odgovara preko njihovih API-ja.
Koliko košta easyCoexistence za proizvod sa AI agentom?
Po vezi, isto na svakoj mreži: od US$ 9 do US$ 0.75 po vezi mesečno, a cena pada kako dodajete veze, uz prva 3 dana besplatno. Meta naplaćuje troškove WhatsApp razgovora na WhatsApp Business nalogu svakog klijenta.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na