Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

24 hours

Okno obsługi klienta WhatsApp po wiadomości lub połączeniu od użytkownika; każda nowa wiadomość je resetuje.

Templates only

Co firma WhatsApp może wysłać po zamknięciu okna obsługi klienta: zatwierdzone wcześniej wiadomości szablonowe.

Section 4.7

Warunki Meta zakazują dostawcom AI wykorzystywania WhatsApp do oferowania AI jako podstawowej, a nie pobocznej funkcjonalności.

7 days

Okno, w którym konto Instagram może wysłać jedną prywatną odpowiedź na komentarz, liczone od chwili jego napisania.

20 mps

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.

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

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.

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()

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 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

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.
Z EasyCoexistence zrobisz to

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