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

Architektura SaaS z agentem AI: dotarcie do klientów Twoich klientów przez WhatsApp, Instagram i TikTok

SaaS z agentem AI, który dociera do klientów Twoich klientów, działa w pięciu warstwach: połączeniach, w których każdy klient łączy WhatsApp, Instagram, TikTok i kolejne kanały przez Partner API easyCoexistence; przyjmowaniu, które weryfikuje i kolejkuje webhooki; magazynie rozmów, który należy do Ciebie; workerze agenta, uruchamiającym Twój model; oraz wysyłce, która odpowiada, publikuje i śledzi zdarzenia statusu przez oficjalne API każdej sieci.

smb_message_echoes

Webhook opisujący wiadomość, którą firma wysłała z aplikacji WhatsApp Business na numerze Coexistence.

7 days

Jak długo Meta ponawia webhook WhatsApp, którego endpoint nie przyjął, co może dostarczyć tę samą wiadomość dwukrotnie.

1 attempt

Dostawy każdego przekazanego zdarzenia Instagram, Facebook lub TikTok, bez ponawiania i bez zachowywania kopii.

24 hours

Okno obsługi klienta WhatsApp po wiadomości osoby; poza nim firma wysyła wyłącznie zatwierdzone szablony.

20 mps

Stała przepustowość numeru używanego zarówno w aplikacji WhatsApp Business, jak i w Cloud API.

Jakie są warstwy SaaS z agentem AI?

Pięć, każda z jednym zadaniem, dzięki czemu wolny model nigdy nie gubi wiadomości, a odłączenie konta nie wyłącza produktu. easyCoexistence działa w pierwszej i ostatniej: łączy konta i utrzymuje ich działanie, a logika rozmów i model pozostają w Twoim backendzie.

1ConnectionsHosted links, channel_id and connection_id per customer
2IngestionVerify, queue, then answer 2xx
3ConversationsYour store, one thread per person
4AgentYour model, prompts and tools
5OutboundReplies, posts and status events

Jak modelować tenantów, kanały i rozmowy?

W trzech tabelach. Tenant to Twój klient, a jego id trafia jako external_ref do każdej sesji połączenia, dzięki czemu każde połączenie i zdarzenie statusu wraca oznaczone tym identyfikatorem. Wiersz kanału przechowuje connection_id numeru WhatsApp albo channel_id konta w mediach społecznościowych, wraz z siecią i jej statusem. Rozmowa jest kluczowana przez kanał i identyfikator osoby w danej sieci: numer WhatsApp w polu from, identyfikator osoby w Instagramie w wiadomości prywatnej albo wątek komentarza na TikToku.

Gdzie najpierw powinny trafiać zdarzenia przychodzące?

W trwałej kolejce, zanim uruchomi się jakikolwiek model. Endpoint przyjmujący sprawdza sekret w ścieżce adresu URL przy dostawach WhatsApp oraz X-EC-Signature przy przekazanych zdarzeniach z sieci społecznościowych, zapisuje zdarzenie w kolejce i odpowiada 2xx. Oba źródła zachowują się inaczej: Meta ponawia webhook WhatsApp przez maksymalnie 7 dni, więc ta sama wiadomość może przyjść dwukrotnie, natomiast przekazane zdarzenie Instagram, Facebook lub TikTok wysyłane jest raz i nigdzie nie zostaje zapisane, więc zdarzenie odrzucone przez Twój endpoint przepada. Usuwaj duplikaty na podstawie identyfikatora wiadomości lub komentarza nadanego przez daną sieć.

Jak utrzymać kolejność i terminowość odpowiedzi?

Jeden worker na rozmowę i sprawdzenie przed każdą wysyłką. Zablokuj rozmowę na czas pracy agenta, aby dwie wiadomości od jednej osoby były obsłużone po kolei i nigdy nie dwukrotnie. Zanim odpowiedź WhatsApp wyjdzie, porównaj ostatnią wiadomość osoby z 24-godzinnym oknem, a gdy się zamknęło, przełącz się na zatwierdzony szablon. Kolejkuj wysyłki każdego numeru najwyżej po 20 wiadomości na sekundę, czyli ze stałą szybkością numeru Coexistence, i pamiętaj, że odpowiedź na TikToku to publiczny komentarz.

Jak osoba przejmuje rozmowę od agenta?

Przez sam kanał. Przy Coexistence personel Twojego klienta dalej korzysta z aplikacji WhatsApp Business na tym samym numerze, a każda jego wiadomość trafia do webhooka jako smb_message_echoes. Traktuj echo jako przekazanie: wstrzymaj agenta w tej rozmowie, przekaż odpowiedź personelu modelowi jako kontekst i wznów po okresie ciszy albo wtedy, gdy personel odda rozmowę w Twoim produkcie. Instagram zwraca także echo wiadomości prywatnych konta, więc ta sama zasada nie pozwoli agentowi odpowiadać samemu sobie.

Czy agent ma także publikować, a nie tylko odpowiadać?

Może, tym samym kluczem. Agent przygotowuje posty, a Twój backend kolejkuje je przez POST /channels/:id/posts na Instagramie, Facebooku, TikToku i LinkedIn, z wyprzedzeniem od 1 minuty do 90 dni, a zdarzenia post.published i post.failed wracają do magazynu rozmów. Posty na LinkedIn wychodzą wyłącznie po zatwierdzeniu każdego z nich przez osobę w Twoim produkcie, ponieważ Warunki korzystania z API LinkedIn ograniczają automatyczne publikowanie.

Jak produkt reaguje, gdy połączenie się urywa?

Przez stan zapisany w wierszu kanału. Zdarzenie statusu przenosi go do disconnected, removed lub suspended, agent przestaje wysyłać na tym kanale, a interfejs prosi tenanta o ponowne połączenie przez nową sesję. Zdarzenie connection.token_missing zostawia numer odbierający, lecz niezdolny do wysyłania, więc agent przygotowuje odpowiedzi dla personelu. Zdarzenie connection.connected lub channel.connected ustawia wiersz z powrotem na active, a worker pobiera świeże dane uwierzytelniające przed kolejną odpowiedzią.

Jakie dane przechowujesz, a jakie zachowuje easyCoexistence?

Twój produkt przechowuje rozmowy. Wiadomości z numeru WhatsApp idą od Meta prosto do Twojego webhooka, a przekazane zdarzenia z sieci społecznościowych przechodzą przez easyCoexistence bez kopii. easyCoexistence zachowuje to, czego potrzebuje do obsługi połączenia: rekord konta, jego tokeny, historię stanu i publikowane posty. Jeśli Twoje konto włączy też automatyzacje easyCoexistence, treść ich wiadomości jest przechowywana przez 7 dni, a dzienniki uruchomień przez 30.

Typowe błędy

  • Kluczowanie rozmów wyłącznie po numerze telefonu osoby. Ta sama osoba może pisać do dwóch Twoich tenantów, dlatego klucz rozmowy składaj z kanału i identyfikatora osoby razem.
  • Pozwolenie dwóm workerom odpowiadać w jednej rozmowie. Równoległe workery mogą wysłać odpowiedzi w złej kolejności lub dwukrotnie, dlatego blokuj wątek na czas pracy agenta.
  • Pozostawienie agenta włączonego, gdy personel odpowie z aplikacji WhatsApp Business. Echo pokazuje, że osoba przejęła wątek, więc wstrzymaj tam agenta, aż Twoja zasada przekazania mu go zwróci.
  • Publikowanie szkiców LinkedIn agenta według harmonogramu. Każdy post na LinkedIn zatwierdza osoba, więc kieruj te szkice do kroku przeglądu, zanim trafią do kolejki.
Z EasyCoexistence zrobisz to

easyCoexistence to warstwa połączeń dla Twojego produktu z agentem: numery WhatsApp Twoich klientów oraz ich konta na Instagramie, Facebooku, TikToku, YouTube i LinkedIn, a także kolejne kanały, łączone przez hostowane linki, ze świeżymi danymi uwierzytelniającymi, webhookami, kolejką publikacji i podpisanymi zdarzeniami statusu, a każde połączenie monitorowane 24/7. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, im więcej połączeń, tym taniej, a pierwsze 3 dni są za darmo.

Najczęściej zadawane pytania

Czy klienci Twoich klientów muszą cokolwiek instalować?

Nie. Piszą do firmy tak jak dotąd, na WhatsApp, w prywatnych wiadomościach na Instagramie lub Messengerze albo w komentarzach, a agent odpowiada w tym samym kanale.

Czy personel klientów może nadal odpowiadać ręcznie?

Tak. Przy Coexistence aplikacja WhatsApp Business działa dalej na tym samym numerze, a każda wiadomość wysłana przez personel trafia do webhooka jako echo, dzięki czemu agent może się wycofać.

Czy easyCoexistence uruchamia model?

Nie. Model, jego prompty i pamięć działają w Twoim backendzie. easyCoexistence łączy konta, dostarcza ich zdarzenia i utrzymuje ich dostęp.

Ile easyCoexistence pobiera za klienta produktu SaaS z agentem?

Każde połączone konto lub numer kosztuje od US$ 9 do US$ 0,75 miesięcznie, im większa łączna liczba, tym taniej, więc klient z WhatsApp i Instagramem liczy się podwójnie. Pierwsze 3 dni są za darmo.

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