Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Kako izgraditi proizvod s AI agentom na WhatsAppu, Instagramu i TikToku vaših kupaca

Proizvod s AI agentom na kanalima kupaca počiva na tri dijela: hostiranoj poveznici za povezivanje za svaki WhatsApp broj ili društveni račun kupca, webhookovima koji poruke i komentare šalju vašem poslužiteljskom sustavu, gdje vaš vlastiti model piše odgovore koji se šalju putem službenog API-ja svake mreže s tokenom kupca, te statusnim događajima za veze koje prestanu raditi. Agent poštuje pravila svake mreže, poput 24-satnog prozora za WhatsApp.

easyCoexistence daje AI agentima vašeg proizvoda glas na WhatsApp brojevima vaših kupaca te na njihovim računima na Instagramu, Facebooku, TikToku, YouTubeu i LinkedInu, i još kanala: hostirane poveznice za povezivanje, svježe vjerodajnice, webhookove i potpisane statusne događaje na službenom API-ju svake mreže, uz praćenje svake veze 24/7.

24 hours

Prozor korisničke usluge na WhatsAppu otvara se nakon poruke ili poziva korisnika; svaka nova poruka ga ponovno pokreće.

Templates only

Što WhatsApp poslovni račun smije poslati nakon zatvaranja prozora korisničke usluge: unaprijed odobrene predloške poruka.

Section 4.7

Metini uvjeti zabranjuju AI pružateljima korištenje WhatsAppa za nuđenje umjetne inteligencije kao primarne, a ne sporedne funkcionalnosti.

7 days

Prozor za jedan privatni odgovor na komentar na Instagram računu, računa se od trenutka kad je komentar napisan.

20 mps

Fiksni propusni kapacitet broja koji se koristi i s aplikacijom WhatsApp Business i s Cloud API-jem.

Što proizvod s AI agentom treba od kanala svakog kupca?

Četiri stvari: način da kupac to poveže, dolazak njegovih poruka na vaš poslužiteljski sustav, token kojim se odgovara i obavijest kad veza prestane raditi. Partner API pokriva svaku od njih, dok model, upute i logika razgovora ostaju vaši. easyCoexistence povezuje račun, održava pristup obnovljenim i prati ga, a vaši odgovori idu izravno iz vašeg sustava prema API-ju svake mreže.

1ConnectA hosted link per customer: POST /connect-sessions
2ReceiveMessages from Meta; comments and DMs forwarded, signed
3DecideYour model, your prompts, your memory
4ReplyThe network's API, with the customer's token
5Watchconnection.* and channel.* status events

Kako se svaki kupac povezuje?

Vaš poslužiteljski sustav otvara sesiju povezivanja pomoću POST /connect-sessions, navodeći kanal, redirect_url i external_ref za vašeg kupca, a za broj i webhook_url te webhook_verify_token. Kupac otvara hostiranu poveznicu, prijavljuje se s Metom, TikTokom, Googleom ili LinkedInom i vraća se u vašu aplikaciju s connection_id ili channel_id. Ne treba mu račun easyCoexistence, e-adresa ni kartica, a svaka veza napravljena vašim ključem pripada vašem računu.

Kako poruke i komentari dolaze do vašeg modela?

Webhookom, na mrežama koje ih šalju. Meta isporučuje poruke broja izravno na njegov webhook_url, a ono što osoblje poslovnog računa pošalje iz aplikacije WhatsApp Business stiže tamo kao smb_message_echoes. Komentari, spominjanja i izravne poruke na Instagramu i Facebooku te komentari na TikToku prosljeđuju se na odredište svakog kanala, potpisani njegovom tajnom. YouTube i LinkedIn ne šalju događaje komentara, pa agent nove komentare čita putem njihovih API-ja prema rasporedu. Na svaku isporuku odmah odgovorite statusom 2xx, a pozadinski zadatak neka pozove model.

Kako agent odgovara?

Putem vlastitog API-ja mreže, s vjerodajnicama koje je vaš poslužiteljski sustav dohvatio. Odgovor na WhatsApp šalje se POST-om na send_endpoint broja s tokenom kupca; izravna poruka na Instagramu ili Facebooku ide na messages edge računa; odgovor na TikToku ide ispod komentara preko business/comment/reply/create/. Nacrt u nastavku odgovara na WhatsApp poruke: provjerava tajnu u putanji URL-a, stavlja svaku dolaznu poruku u red čekanja i odgovara onim što vrati vaš model.

Python: a WhatsApp agent on your own 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 poslužitelj ili Partner API: koji agent koristi?

Partner API, kad je agent vaš proizvod, a kupci donose kanale: vaš poslužiteljski sustav drži ključ, prima događaje i pokreće bilo koji model koji odaberete. MCP poslužitelj na https://easycoexistence.com/api/mcp prikladan je za asistenta poput Claudea ili ChatGPT-ja koji djeluje na vašem vlastitom računu easyCoexistence, putem alata koje poziva na zahtjev nakon prijave OAuth-om. Brojevi i kanali povezani vašim ključem također su na tom računu, pa im MCP sesija može pristupiti za rad vašeg tima.

Partner APIMCP server
Built forYour product, serving your customersAn assistant working on your own account
Signs in withAn ec_live_ key, one per accountOAuth, from Claude, ChatGPT or another client
Incoming messagesWebhooks to your backendRead when the assistant calls a tool
The modelAny model you runThe assistant's own
RepliesYour code calls each network's APITools such as send_message and reply_to_comment

Kako agencije vode agente za mnogo klijenata?

Na jednom računu, sa svakim klijentom označenim. Predajte ID klijenta kao external_ref u svakoj sesiji povezivanja, prikažite naziv vaše agencije na hostiranoj stranici pomoću partner_name i popišite veze jednog klijenta pomoću GET /connections?external_ref= i GET /channels?external_ref=. Svaka se veza naplaćuje agenciji po US$ 9 do US$ 0,75 mjesečno, uz pad cijene kako dodajete veze, dok Meta naplaćuje WhatsApp razgovore na WhatsApp Business računu klijenta. Uz Coexistence osoblje klijenta i dalje odgovara u aplikaciji WhatsApp Business uz agenta.

Koja pravila agent mora poštovati?

Pravila samih mreža, koja vaš kod treba provjeriti prije nego što odgovor modela izađe. Platforme ih poštuju u ime svojih kupaca, jer se Metina provedba odnosi na račun kupca:

  • WhatsApp: slobodan tekst samo unutar 24 sata od posljednje kupčeve poruke; nakon toga odobreni predložak, poslan putem API-ja jer aplikacija WhatsApp Business u Coexistenceu ne može slati predloške.
  • WhatsApp: Metini uvjeti zabranjuju nuđenje umjetne inteligencije kao primarne funkcionalnosti, što referenca Partner API-ja navodi kao zabranu općenamjenskih AI botova, a dopuštaju doradu modela na podacima WhatsAppa samo za isključivu uporabu poslovnog računa.
  • Instagram i Facebook: izravne poruke unutar 24 sata od posljednje poruke osobe, a jedan privatni odgovor na komentar unutar 7 dana od njega.
  • TikTok: odgovori na komentare javni su jer TikTok veza nema izravne poruke.
  • Opterećenje: 20 poruka u sekundi po Coexistence broju, a marketinški predlošci traže način plaćanja na WhatsApp Business računu kupca.

Kako agent zna da kanal više ne radi?

Iz statusnih događaja. connection.disconnected ili channel.disconnected znači da odgovori ne prolaze dok kupac ponovno ne poveže račun, pa pauzirajte agenta tog kupca, obavijestite ga i pošaljite novu poveznicu za povezivanje. connection.token_missing znači da broj može primati, ali još ne može slati. Kad ponovno stigne connection.connected ili channel.connected, dohvatite svježe vjerodajnice i nastavite. Svaki je događaj potpisan zaglavljem X-EC-Signature i ponavlja se oko 33 sata.

Uobičajene pogreške

  • Model odgovara na WhatsApp poruku stariju od 24 sata slobodnim tekstom. Prozor je zatvoren, pa provjerite vrijeme posljednje dolazne poruke kupca i prijeđite na odobreni predložak.
  • Treniranje zajedničkog modela na WhatsApp razgovorima kupaca. Metini uvjeti dopuštaju doradu modela na podacima WhatsApp Business Platform samo za isključivu uporabu poslovnog računa, nikad za poboljšanje drugih modela.
  • Smatranje smb_message_echoes porukama kupaca. To su poruke koje je osoblje poslovnog računa poslalo iz aplikacije, pa ih modelu predajte kao kontekst, a ne kao poruke na koje treba odgovoriti.
  • Odgovaranje na vlastite odgovore računa. Izravne poruke koje račun pošalje na Instagramu vraćaju se kao odjeci, a odgovori na TikToku kao događaji komentara, pa preskočite sve što je sam račun napisao, inače agent odgovara sam sebi.
Radite ovo uz EasyCoexistence

US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Mogu li koristiti vlastiti AI model?

Da. Vaš poslužiteljski sustav prima poruke, poziva bilo koji model koji odaberete i odgovara putem API-ja mreže s tokenom kupca. Poruke jednog WhatsApp broja stižu s Mete izravno na vaš webhook, nikad preko easyCoexistence.

Što Metina AI politika znači za WhatsApp agenta?

Metini uvjeti zabranjuju AI pružateljima korištenje WhatsApp Business Platform za nuđenje tehnologije umjetne inteligencije kao primarne, a ne sporedne ili pomoćne funkcionalnosti, kako to određuje Meta. Držite se toga u ime svojih kupaca, uz 24-satni prozor i odobrene predloške.

Može li agent slati izravne poruke 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 putem njihovih API-ja.

Koliko košta easyCoexistence za proizvod s AI agentom?

Po vezi, isto na svakoj mreži: US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, a prva 3 dana su besplatna. Meta naplaćuje WhatsApp razgovore na WhatsApp Business računu svakog kupca.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na