Jak zbudować produkt z agentem AI na WhatsApp, Instagramie i TikToku klientów
Produkt z agentem AI na kanałach klientów opiera się na trzech elementach: gotowym linku do połączenia dla numeru WhatsApp lub konta społecznościowego każdego klienta, webhookach, które przekazują wiadomości i komentarze do Twojego backendu, gdzie własny model pisze odpowiedzi wysyłane przez oficjalne API sieci z tokenem klienta, oraz zdarzeniach statusu dla połączeń, które się zerwą. Agent przestrzega zasad sieci, na przykład 24-godzinnego okna WhatsApp.
easyCoexistence daje agentom AI Twojego produktu głos na numerach WhatsApp Twoich klientów oraz na ich kontach Instagram, Facebook, TikTok, YouTube i LinkedIn, a także na kolejnych kanałach: gotowe linki do połączenia, świeże dane uwierzytelniające, webhooki i podpisane zdarzenia statusu w oficjalnym API sieci, a połączenia są monitorowane 24/7.
Okno obsługi klienta WhatsApp po wiadomości lub połączeniu od użytkownika; każda nowa wiadomość je resetuje.
Co firma WhatsApp może wysłać po zamknięciu okna obsługi klienta: zatwierdzone wcześniej wiadomości szablonowe.
Warunki Meta zakazują dostawcom AI wykorzystywania WhatsApp do oferowania AI jako podstawowej, a nie pobocznej funkcjonalności.
Okno, w którym konto Instagram może wysłać jedną prywatną odpowiedź na komentarz, liczone od chwili jego napisania.
Stała przepustowość numeru używanego jednocześnie w aplikacji WhatsApp Business i w Cloud API.
Czego agent AI potrzebuje z kanału każdego klienta?
Czterech rzeczy: sposobu, by klient mógł go połączyć, dotarcia jego wiadomości do Twojego backendu, tokenu do odpowiadania oraz informacji, gdy połączenie przestanie działać. Partner API obejmuje każdą z nich, a model, prompty i logika rozmów pozostają po Twojej stronie. easyCoexistence łączy konto, odnawia jego dostęp i je monitoruje, a Twoje odpowiedzi idą z backendu prosto do API sieci.
Jak łączy się każdy klient?
Twój backend tworzy sesję połączenia poleceniem POST /connect-sessions, wskazując kanał, redirect_url i external_ref klienta, a dla numeru także webhook_url i webhook_verify_token. Klient otwiera gotowy link, loguje się przez Meta, TikTok, Google lub LinkedIn i wraca do Twojej aplikacji z connection_id lub channel_id. Nie potrzebuje konta easyCoexistence, adresu e-mail ani karty, a połączenia wykonane Twoim kluczem należą do Twojego konta.
Jak wiadomości i komentarze docierają do Twojego modelu?
Przez webhook, w sieciach, które je wysyłają. Meta dostarcza wiadomości numeru wprost na jego webhook_url, a to, co pracownicy firmy wysyłają z aplikacji WhatsApp Business, trafia tam jako smb_message_echoes. Komentarze, wzmianki i DM z Instagrama oraz Facebooka, a także komentarze z TikToka, są przekazywane pod adres docelowy każdego kanału i podpisane jego sekretem. YouTube i LinkedIn nie wysyłają zdarzeń o komentarzach, więc agent czyta nowe komentarze przez ich API według harmonogramu. Odpowiedz na dostarczenie kodem 2xx od razu i pozwól workerowi wywołać model.
Jak agent odpowiada?
Przez własne API sieci, z danymi uwierzytelniającymi, które Twój backend pobrał. Odpowiedź na WhatsApp to POST na send_endpoint numeru z tokenem klienta; DM na Instagramie lub Facebooku trafia pod messages edge konta; odpowiedź na TikToku idzie pod komentarz przez business/comment/reply/create/. Poniższy szkic odpowiada na wiadomości WhatsApp: sprawdza sekret w ścieżce URL, dodaje każdą przychodzącą wiadomość do kolejki i odpowiada tym, co zwróci Twój 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()Serwer MCP czy Partner API: którego używa agent?
Partner API, gdy agent jest Twoim produktem, a klienci wnoszą kanały: Twój backend trzyma klucz, odbiera zdarzenia i uruchamia dowolny wybrany model. Serwer MCP pod adresem https://easycoexistence.com/api/mcp nadaje się dla asystenta, takiego jak Claude lub ChatGPT, działającego na Twoim koncie easyCoexistence, przez narzędzia wywoływane na żądanie po logowaniu OAuth. Numery i kanały podłączone Twoim kluczem też znajdują się na tym koncie, więc sesja MCP może do nich sięgnąć na potrzeby Twojego zespołu.
| 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 |
Jak agencje prowadzą agentów dla wielu klientów?
Na jednym koncie, z oznaczeniem każdego klienta. Przekaż ID klienta jako external_ref w każdej sesji połączenia, pokaż nazwę agencji na hostowanej stronie przez partner_name i wypisz połączenia jednego klienta przez GET /connections?external_ref= oraz GET /channels?external_ref=. Każde połączenie jest rozliczane z agencją od US$ 9 do US$ 0.75 za połączenie miesięcznie, im więcej połączeń, tym taniej. Meta obciąża opłatami za konwersacje WhatsApp konto WhatsApp Business samego klienta. Przy Coexistence personel klienta nadal odpowiada w aplikacji WhatsApp Business obok agenta.
Jakich zasad musi przestrzegać agent?
Zasad sieci, które Twój kod powinien sprawdzić, zanim odpowiedź modelu zostanie wysłana. Platformy przestrzegają ich w imieniu swoich klientów, bo egzekwowanie Meta dotyka konta klienta:
- WhatsApp: swobodne odpowiedzi tylko w ciągu 24 godzin od ostatniej wiadomości klienta; później zatwierdzony szablon, wysłany przez API, bo aplikacja WhatsApp Business nie może wysyłać szablonów w Coexistence.
- WhatsApp: warunki Meta zakazują oferowania AI jako podstawowej funkcjonalności, co referencja Partner API przekłada na brak ogólnych botów AI, a dostrajanie modeli na danych WhatsApp jest dozwolone wyłącznie na wyłączny użytek firmy.
- Instagram i Facebook: DM w ciągu 24 godzin od ostatniej wiadomości osoby oraz jedna prywatna odpowiedź na komentarz w ciągu 7 dni od niego.
- TikTok: odpowiedzi na komentarze są publiczne, ponieważ połączenie TikTok nie obsługuje DM.
- Wolumen: 20 wiadomości na sekundę na numer Coexistence, a szablony marketingowe wymagają metody płatności na koncie WhatsApp Business klienta.
Skąd agent wie, że kanał przestał działać?
Ze zdarzeń statusu. connection.disconnected lub channel.disconnected oznacza, że odpowiedzi kończą się niepowodzeniem, dopóki klient się nie połączy ponownie, więc wstrzymaj agenta tego klienta, poinformuj go i wyślij nowy link do połączenia. connection.token_missing oznacza, że numer może odbierać, ale jeszcze nie wysyłać. Gdy ponownie pojawi się connection.connected lub channel.connected, pobierz świeże dane uwierzytelniające i wznów pracę. Zdarzenia są podpisane nagłówkiem X-EC-Signature i ponawiane przez około 33 godziny.
Typowe błędy
- Pozwolenie modelowi na odpowiedź na wiadomość WhatsApp starszą niż 24 godziny swobodnym tekstem. Okno już się zamknęło, więc sprawdź czas ostatniej wiadomości przychodzącej klienta i przełącz się na zatwierdzony szablon.
- Trenowanie wspólnego modelu na rozmowach klientów z WhatsApp. Warunki Meta dopuszczają dostrajanie na danych WhatsApp Business Platform wyłącznie na wyłączny użytek firmy, nigdy do ulepszania innych modeli.
- Traktowanie smb_message_echoes jako wiadomości klienta. To wiadomości, które personel firmy wysłał z aplikacji, więc przekaż je modelowi jako kontekst, a nie jako wiadomości do odpowiedzi.
- Odpowiadanie na własne wiadomości konta. DM, które konto wysyła na Instagramie, wracają jako echa, a odpowiedzi TikToka jako zdarzenia o komentarzach, więc pomijaj wszystko, co konto napisało samo, inaczej agent odpowie sam sobie.
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, im więcej połączeń, tym taniej, z bezpłatnym okresem próbnym pierwszych 3 dni.
Najczęściej zadawane pytania
Czy mogę użyć własnego modelu AI?
Tak. Twój backend odbiera wiadomości, wywołuje dowolny wybrany model i odpowiada przez API sieci tokenem klienta. Wiadomości numeru WhatsApp idą z Meta prosto na Twój webhook, nigdy przez easyCoexistence.
Co zasady AI Meta oznaczają dla agenta na WhatsApp?
Warunki Meta zakazują dostawcom AI wykorzystywania WhatsApp Business Platform do oferowania technologii AI jako podstawowej, a nie pobocznej lub dodatkowej funkcjonalności, jak ustala Meta. Przestrzegaj ich w imieniu swoich klientów, wraz z 24-godzinnym oknem i zatwierdzonymi szablonami.
Czy agent może wysyłać DM na TikToku, YouTube lub LinkedIn?
Nie. W tych sieciach agent działa w komentarzach: odpowiedzi na TikToku są publiczne, a komentarze na YouTube i LinkedIn są czytane i obsługiwane przez ich API.
Ile kosztuje easyCoexistence dla produktu z agentem AI?
Za połączenie, tak samo we wszystkich sieciach: od US$ 9 do US$ 0.75 za połączenie miesięcznie, im więcej połączeń, tym taniej, z bezpłatnym okresem próbnym pierwszych 3 dni. Meta obciąża opłatami za konwersacje WhatsApp konto WhatsApp Business każdego klienta.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w