Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Arhitectura SaaS cu agent AI: ajungeți la clienții clienților dumneavoastră pe WhatsApp, Instagram și TikTok

Un SaaS cu agent AI care ajunge la clienții clienților dumneavoastră funcționează în cinci straturi: conexiuni, unde fiecare client își leagă WhatsApp, Instagram, TikTok și alte canale prin Partner API al easyCoexistence; ingestie, care verifică și pune în coadă webhook-urile; un depozit de conversații pe care îl dețineți; un worker al agentului care rulează modelul dumneavoastră; și ieșiri, care trimit răspunsuri, publică postări și urmăresc evenimentele de stare prin API-ul oficial al fiecărei rețele.

smb_message_echoes

Webhook-ul care descrie un mesaj trimis de firmă din aplicația WhatsApp Business pe un număr Coexistence.

7 days

Cât timp reîncearcă Meta un webhook WhatsApp pe care endpoint-ul dumneavoastră nu l-a acceptat, ceea ce poate livra același mesaj de două ori.

1 attempt

Livrările fiecărui eveniment Instagram, Facebook sau TikTok transmis mai departe, fără reîncercare și fără copie păstrată.

24 hours

Fereastra de serviciu pentru clienți de după mesajul unei persoane; în afara ei, o firmă trimite doar șabloane aprobate.

20 mps

Debitul fix al unui număr folosit atât cu aplicația WhatsApp Business, cât și cu Cloud API.

Care sunt straturile unui SaaS cu agent AI?

Cinci, fiecare cu o singură sarcină, astfel încât un model lent să nu piardă niciodată un mesaj, iar un cont pierdut să nu scoată produsul din funcțiune. easyCoexistence se află în primul și în ultimul: conectează conturile și le menține funcționale, în timp ce logica conversației și modelul rămân în backendul dumneavoastră.

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

Cum modelați clienții, canalele și conversațiile?

În trei tabele. Un client este clientul dumneavoastră, iar ID-ul lui este trimis ca external_ref în fiecare sesiune de conectare, astfel încât fiecare conexiune și eveniment de stare revine etichetat cu el. Un rând de canal păstrează connection_id-ul unui număr WhatsApp sau channel_id-ul unui cont social, împreună cu rețeaua și starea acestuia. O conversație este identificată prin canal și ID-ul persoanei în rețeaua respectivă: numărul WhatsApp din câmpul from, ID-ul delimitat la Instagram al unui mesaj direct sau firul comentariului pe TikTok.

Unde ajung primele evenimente primite?

Într-o coadă durabilă, înainte să ruleze orice model. Endpoint-ul de ingestie verifică secretul din calea URL-ului la livrările WhatsApp și X-EC-Signature la evenimentele sociale transmise mai departe, scrie evenimentul în coadă și răspunde cu 2xx. Cele două surse se comportă diferit: Meta reîncearcă un webhook WhatsApp timp de până la 7 zile, deci același mesaj poate sosi de două ori, în timp ce un eveniment Instagram, Facebook sau TikTok transmis mai departe este trimis o singură dată și nu se păstrează, deci un eveniment respins de endpoint-ul dumneavoastră este pierdut. Deduplicați pe ID-ul propriu al mesajului sau comentariului din rețea.

Cum păstrați răspunsurile în ordine și la timp?

Un worker pe conversație și o verificare înainte de fiecare trimitere. Blocați conversația cât timp lucrează agentul, astfel încât două mesaje de la aceeași persoană să primească răspuns pe rând și niciodată de două ori. Înainte ca un răspuns WhatsApp să plece, comparați ultimul mesaj al persoanei cu fereastra de 24 de ore și treceți la un șablon aprobat după ce aceasta s-a închis. Puneți în coadă trimiterile fiecărui număr la cel mult 20 de mesaje pe secundă, debitul fix al unui număr Coexistence, și rețineți că un răspuns TikTok este un comentariu public.

Cum preia o persoană conversația de la agent?

Prin chiar canalul. Cu Coexistence, personalul clientului dumneavoastră continuă să folosească aplicația WhatsApp Business pe același număr, iar fiecare mesaj trimis de ei ajunge la webhook-ul dumneavoastră ca smb_message_echoes. Tratați un ecou ca pe un transfer: opriți agentul pe conversația respectivă, transmiteți răspunsul personalului modelului ca context și reluați după o perioadă de liniște sau când personalul îl returnează din produsul dumneavoastră. Instagram returnează și mesajele directe ale contului ca ecouri, așa că aceeași regulă împiedică agentul să-și răspundă singur.

Ar trebui agentul să și publice, nu doar să răspundă?

Poate, prin aceeași cheie. Agentul redactează postări, iar backendul dumneavoastră le pune în coadă cu POST /channels/:id/posts pe Instagram, Facebook, TikTok și LinkedIn, cu un avans între 1 minut și 90 de zile, iar post.published și post.failed raportează înapoi către depozitul de conversații. Postările LinkedIn pleacă doar după ce o persoană aprobă fiecare în produsul dumneavoastră, deoarece Condițiile API ale LinkedIn restricționează postarea automată.

Cum reacționează produsul când o conexiune cade?

Printr-o stare pe rândul canalului. Un eveniment de stare o trece pe disconnected, removed sau suspended, agentul încetează să trimită pe acel canal, iar interfața dumneavoastră cere clientului să se reconecteze printr-o sesiune nouă de conectare. Un eveniment connection.token_missing lasă un număr să primească mesaje, dar fără posibilitatea de a trimite, astfel că agentul redactează răspunsuri pentru personal. connection.connected sau channel.connected readuce rândul la active, iar workerul preia credențiale noi înainte de următorul răspuns.

Ce date stocați și ce păstrează easyCoexistence?

Produsul dumneavoastră stochează conversațiile. Mesajele unui număr WhatsApp merg de la Meta direct la webhook-ul dumneavoastră, iar evenimentele sociale transmise mai departe trec prin easyCoexistence fără o copie. easyCoexistence păstrează ce îi trebuie pentru a servi conexiunea: înregistrarea contului, token-urile acestuia, istoricul stării și postările pe care le publică. Dacă dumneavoastră activați și propriile automatizări ale easyCoexistence, textul mesajelor lor se păstrează 7 zile, iar jurnalele de rulare 30 de zile.

Greșeli frecvente

  • Gruparea conversațiilor doar după numărul de telefon al persoanei. Aceeași persoană poate scrie la doi dintre clienții dumneavoastră, deci identificați fiecare fir după canal și ID-ul persoanei împreună.
  • Lăsarea a doi workeri să răspundă la aceeași conversație. Workerii paraleli pot trimite răspunsuri în dezordine sau de două ori, așa că blocați fiecare fir cât timp agentul lucrează la el.
  • Menținerea agentului activ după ce personalul răspunde din aplicația WhatsApp Business. Ecoul arată că o persoană a preluat firul, deci opriți agentul acolo până ce regula dumneavoastră de transfer îl returnează.
  • Publicarea ciornelor LinkedIn ale agentului cu un cronometru. O persoană aprobă fiecare postare LinkedIn, așa că trimiteți aceste ciorne la un pas de revizuire înainte să ajungă în coadă.
Faceți acest lucru cu EasyCoexistence

easyCoexistence este stratul de conexiuni pentru produsul dumneavoastră cu agenți: numerele WhatsApp ale clienților și conturile lor Instagram, Facebook, TikTok, YouTube și LinkedIn, precum și alte canale, conectate prin link-uri găzduite, cu credențiale proaspete, webhook-uri, o coadă de publicare și evenimente de stare semnate, fiecare conexiune fiind monitorizată non-stop. De la US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Clienții clienților dumneavoastră trebuie să instaleze ceva?

Nu. Ei scriu firmei așa cum fac deja, pe WhatsApp, în mesajele directe Instagram sau pe Messenger, ori în comentarii, iar agentul dumneavoastră răspunde pe același canal.

Personalul clienților dumneavoastră poate continua să răspundă manual?

Da. Cu Coexistence, aplicația WhatsApp Business continuă să funcționeze pe același număr, iar fiecare mesaj trimis de personal ajunge la webhook-ul dumneavoastră ca ecou, astfel încât agentul se poate retrage.

easyCoexistence rulează modelul?

Nu. Modelul, prompturile și memoria lui rulează în backendul dumneavoastră. easyCoexistence conectează conturile, livrează evenimentele lor și menține funcțional accesul.

Cât percepe easyCoexistence pe client al unui SaaS cu agent?

Fiecare număr sau cont conectat costă de la US$ 9 până la US$ 0.75 pe lună, scăzând pe măsură ce totalul dumneavoastră crește, deci un client cu WhatsApp și Instagram se numără de două ori. Primele 3 zile sunt gratuite.

Continuați să citiți

Cum construiești un produs cu agent AI pe WhatsApp, Instagram și TikTok ai clienților tăiConstruiește un produs cu agent AI pe WhatsApp, Instagram, Facebook și TikTok ai clienților tăi, cu Partner API, modelul tău și regulile fiecărei rețele.Cum construiți un scheduler de social media pe un API: coada, media și statusurile postărilorConstruiți un scheduler pentru social media pe API-ul de posturi easyCoexistence: publish_at cu până la 90 de zile înainte și șase statusuri.Revânzarea funcțiilor de social media în propriul SaaS: marje de la US$ 9 până la US$ 0.75 pe conexiuneCe câștigă un SaaS revânzând funcții de social media și WhatsApp la US$ 9 până la US$ 0.75 pe conexiune: marje reale, pe abonament fix și pe cont.API social media pentru agenții: gestionați conturile clienților din propriul softwareAPI pentru agenții: conectați conturile fiecărui client printr-un link, etichetați-le cu id-ul clientului, publicați cu aprobare și generați rapoarte.Cum primiți mesajele WhatsApp ale clienților și comentariile din rețelele sociale printr-un webhookUn webhook per conexiune: mesajele WhatsApp direct de la Meta, autentificate printr-un secret din URL, comentariile și DM-urile semnate cu X-EC-Signature.Cum aflați când se întrerupe conexiunea WhatsApp sau socială a unui clientEvenimentele de status connection.* și channel.*: motive precum PRIMARY_INACTIVITY, X-EC-Signature, reîncercări timp de circa 33 de ore și deduplicare după id.

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la