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

Arhitektura SaaS-a s AI agentom: dopiranje do kupaca vaših kupaca na WhatsAppu, Instagramu i TikToku

SaaS aplikacija s AI agentom koja dopire do kupaca vaših kupaca radi u pet slojeva: veze, u kojima svaki kupac povezuje WhatsApp, Instagram, TikTok i još kanala putem Partner API-ja tvrtke easyCoexistence; prihvat, koji provjerava i stavlja u red webhookove; pohranu razgovora u vašem vlasništvu; radnika agenta koji pokreće vaš model; i odlazne poruke, koje odgovaraju, objavljuju i prate događaje statusa putem službenog API-ja svake mreže.

smb_message_echoes

Webhook koji opisuje poruku koju je tvrtka poslala iz aplikacije WhatsApp Business na Coexistence broju.

7 days

Koliko dugo Meta ponavlja webhook za WhatsApp koji vaš endpoint nije prihvatio, što može dostaviti istu poruku dvaput.

1 attempt

Isporuke svakog proslijeđenog događaja s Instagrama, Facebooka ili TikToka, bez ponavljanja i bez zadržane kopije.

24 hours

Prozor za korisničku službu na WhatsAppu nakon poruke osobe; izvan njega tvrtka šalje samo odobrene predloške.

20 mps

Fiksna propusnost broja koji se koristi s aplikacijom WhatsApp Business i uz Cloud API.

Koji su slojevi SaaS-a s AI agentom?

Pet, s jednom zadaćom svaki, tako da spori model nikad ne izgubi poruku, a ispadanje računa ne ruši proizvod. easyCoexistence je u prvom i zadnjem sloju: povezuje račune i održava ih u radu, dok logika razgovora i model ostaju u vašem backendu.

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

Kako modelirati klijente, kanale i razgovore?

U tri tablice. Klijent je vaš kupac, a njegov ID šalje se kao external_ref u svakoj sesiji povezivanja, pa se svaka veza i događaj statusa vraća s tom oznakom. Redak kanala sadrži connection_id WhatsApp broja ili channel_id društvenog računa, uz mrežu i njezin status. Razgovor je određen kanalom i ID-jem osobe na toj mreži: brojem WhatsApp broja u polju from, ID-jem osobe na Instagramu u DM-u ili nitom komentara na TikToku.

Kamo prvo trebaju stizati dolazni događaji?

U trajni red čekanja, prije nego što se pokrene bilo koji model. Endpoint za prihvat provjerava tajnu u putanji URL-a za WhatsApp isporuke i X-EC-Signature kod proslijeđenih društvenih događaja, upisuje događaj u red i odgovara 2xx. Dva izvora se ponašaju različito: Meta ponavlja WhatsApp webhook do 7 dana, pa ista poruka može stići dvaput, dok se proslijeđeni događaj s Instagrama, Facebooka ili TikToka šalje jednom i nikad se ne čuva, pa je događaj koji vaš endpoint odbaci zauvijek izgubljen. Uklonite duplikate prema ID-ju poruke ili komentara u mreži.

Kako održati odgovore redom i na vrijeme?

Jedan radnik po razgovoru i provjera prije svakog slanja. Zaključajte razgovor dok agent radi, da se dvije poruke jedne osobe odgovore redom i nikad dvaput. Prije nego što odgovor na WhatsAppu odlazi, usporedite posljednju poruku osobe s 24-satnim prozorom, a kad se on zatvori, prijeđite na odobreni predložak. Ograničite slanja svakog broja na najviše 20 poruka u sekundi, što je fiksna brzina Coexistence broja, i zapamtite da je odgovor na TikToku javni komentar.

Kako osoba preuzima razgovor od agenta?

Kroz sam kanal. Uz Coexistence, osoblje vašeg kupca i dalje koristi aplikaciju WhatsApp Business na istom broju, a svaka njihova poruka stiže na vaš webhook kao smb_message_echoes. Eho tretirajte kao predaju razgovora: pauzirajte agenta u tom razgovoru, pošaljite odgovor osoblja modelu kao kontekst i nastavite nakon tihog razdoblja ili kad osoblje vrati razgovor u vašem proizvodu. Instagram također vraća vlastite DM-ove kao ehe, pa isto pravilo sprječava da agent odgovara sam sebi.

Treba li agent i objavljivati, a ne samo odgovarati?

Može, kroz isti ključ. Agent priprema objave, a vaš backend ih stavlja u red s POST /channels/:id/posts na Instagramu, Facebooku, TikToku i LinkedInu, od 1 minute do 90 dana unaprijed, dok događaji post.published i post.failed vraćaju stanje u pohranu razgovora. Objave na LinkedInu odlaze tek nakon što osoba odobri svaku u vašem proizvodu, jer uvjeti LinkedIn API-ja ograničavaju automatsko objavljivanje.

Kako proizvod reagira kad veza pukne?

Preko stanja na retku kanala. Događaj statusa ga prebacuje u disconnected, removed ili suspended, agent prestaje slati na tom kanalu, a sučelje traži od klijenta ponovno povezivanje novom sesijom povezivanja. Događaj connection.token_missing ostavlja broj u stanju primanja, ali bez mogućnosti slanja, pa agent umjesto toga priprema nacrte odgovora za osoblje. Događaj connection.connected ili channel.connected vraća redak u active, a radnik prije sljedećeg odgovora dohvaća nove vjerodajnice.

Koje podatke pohranjujete, a koje čuva easyCoexistence?

Vaš proizvod čuva razgovore. Poruke WhatsApp broja idu s Metinih servera izravno na vaš webhook, a proslijeđeni društveni događaji prolaze kroz easyCoexistence bez kopije. easyCoexistence zadržava ono što treba za rad veze: zapis računa, njegove tokene, povijest stanja i objave koje objavljuje. Ako vaš račun uključi i automatizacije same platforme easyCoexistence, tekst njihovih poruka čuva se 7 dana, a zapisnici izvođenja 30 dana.

Uobičajene pogreške

  • Određivanje razgovora samo po broju telefona osobe. Ista osoba može pisati dvama vašim klijentima, pa svaku nit određujte kanalom i ID-jem osobe zajedno.
  • Dopuštanje da dva radnika odgovaraju na isti razgovor. Paralelni radnici mogu odgovore poslati izvan redoslijeda ili dvaput, pa zaključajte svaku nit dok agent na njoj radi.
  • Ostavljanje agenta uključenim nakon što osoblje odgovori iz aplikacije WhatsApp Business. Eho pokazuje da je osoba preuzela nit, pa agenta tu pauzirajte dok ga vaše pravilo predaje ne vrati.
  • Objavljivanje LinkedIn nacrta agenta po rasporedu. Svaku LinkedIn objavu odobrava osoba, pa nacrte usmjerite na korak pregleda prije nego dođu u red.
Radite ovo uz EasyCoexistence

easyCoexistence je sloj povezivanja za vaš proizvod s agentom: WhatsApp brojevi vaših kupaca te njihovi računi na Instagramu, Facebooku, TikToku, YouTubeu i LinkedInu, i još kanala, povezani hostiranim poveznicama, sa svježim vjerodajnicama, webhookovima, redom za objavljivanje i potpisanim događajima statusa, a svaka veza nadzire se 24/7. US$ 9 do US$ 0.75 po povezanoj vezi mjesečno, uz pad kako dodajete veze, a prvih 3 dana besplatno.

Često postavljana pitanja

Trebaju li kupci mojih kupaca išta instalirati?

Ne. Pišu tvrtki kao i do sada, na WhatsAppu, u Instagram DM-ovima ili Messengeru, ili u komentarima, a vaš agent odgovara na istom kanalu.

Mogu li osoblje vaših kupaca i dalje odgovarati ručno?

Da. Uz Coexistence, aplikacija WhatsApp Business i dalje radi na istom broju, a svaka poruka koju osoblje pošalje stiže na vaš webhook kao eho, pa agent može stati sa strane.

Pokreće li easyCoexistence model?

Ne. Model, njegove upute i memorija rade u vašem backendu. easyCoexistence povezuje račune, isporučuje njihove događaje i održava njihov pristup u radu.

Koliko easyCoexistence naplaćuje po kupcu SaaS aplikacije s AI agentom?

Svaki povezani broj ili račun košta US$ 9 do US$ 0.75 mjesečno, uz pad kako vaš ukupni broj raste, pa se kupac s WhatsAppom i Instagramom računa dvaput. Prvih 3 dana su besplatna.

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