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.
Webhook opisujący wiadomość, którą firma wysłała z aplikacji WhatsApp Business na numerze Coexistence.
Jak długo Meta ponawia webhook WhatsApp, którego endpoint nie przyjął, co może dostarczyć tę samą wiadomość dwukrotnie.
Dostawy każdego przekazanego zdarzenia Instagram, Facebook lub TikTok, bez ponawiania i bez zachowywania kopii.
Okno obsługi klienta WhatsApp po wiadomości osoby; poza nim firma wysyła wyłącznie zatwierdzone szablony.
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.
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.
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