Architettura SaaS con agenti IA: raggiungere i clienti dei tuoi clienti su WhatsApp, Instagram e TikTok
Una SaaS con agenti IA che raggiunge i clienti dei tuoi clienti si articola in cinque livelli: connessioni, dove ogni cliente collega WhatsApp, Instagram, TikTok e altri canali tramite la Partner API di easyCoexistence; ingestione, che verifica e accoda i webhook; un archivio delle conversazioni di tua proprietà; un worker dell'agente che esegue il tuo modello; e invio, che risponde, pubblica e segue gli eventi di stato tramite l'API ufficiale di ciascuna rete.
Il webhook che descrive un messaggio inviato dall'azienda dall'app WhatsApp Business su un numero in Coexistence.
Per quanto tempo Meta riprova un webhook di WhatsApp che il tuo endpoint non ha accettato, cosa che può consegnare due volte lo stesso messaggio.
Consegne di ogni evento Instagram, Facebook o TikTok inoltrato, senza nuovi tentativi e senza copia conservata.
La finestra di assistenza clienti di WhatsApp dopo un messaggio di una persona; fuori da essa, un'azienda invia solo template approvati.
Velocità fissa di un numero usato sia con l'app WhatsApp Business sia con la Cloud API.
Quali sono i livelli di una SaaS con agenti IA?
Cinque, ciascuno con un solo compito, così un modello lento non perde mai un messaggio e un account caduto non blocca mai il prodotto. easyCoexistence si occupa del primo e dell'ultimo: collega gli account e ne mantiene il funzionamento, mentre la logica delle conversazioni e il modello restano nel tuo backend.
Come modelli tenant, canali e conversazioni?
In tre tabelle. Un tenant è il tuo cliente, e il suo id viaggia come external_ref in ogni sessione di connessione, così ogni connessione ed evento di stato torna etichettato con esso. Una riga canale contiene il connection_id di un numero WhatsApp o il channel_id di un account social, con la rete e il suo stato. Una conversazione è identificata dal canale e dall'ID della persona su quella rete: il numero WhatsApp in from, l'ID con ambito Instagram in un DM, o il thread del commento su TikTok.
Dove devono arrivare per prime le notifiche in ingresso?
In una coda durevole, prima che giri qualsiasi modello. L'endpoint di ingestione verifica il segreto nel percorso dell'URL per le consegne WhatsApp e X-EC-Signature per gli eventi social inoltrati, scrive l'evento in coda e risponde 2xx. Le due fonti si comportano in modo diverso: Meta riprova un webhook di WhatsApp per fino a 7 giorni, quindi lo stesso messaggio può arrivare due volte, mentre un evento Instagram, Facebook o TikTok inoltrato viene inviato una sola volta e non viene mai conservato, quindi un evento scartato dal tuo endpoint è perso. Deduplica sull'ID nativo del messaggio o del commento della rete.
Come mantieni le risposte in ordine e puntuali?
Un worker per conversazione e un controllo prima di ogni invio. Blocca la conversazione mentre l'agente lavora, così due messaggi della stessa persona ricevono risposta uno dopo l'altro e mai due volte. Prima che una risposta WhatsApp parta, confronta l'ultimo messaggio della persona con la finestra di 24 ore e passa a un template approvato una volta chiusa. Accoda gli invii di ogni numero a 20 messaggi al secondo al massimo, la velocità fissa di un numero in Coexistence, e ricorda che una risposta TikTok è un commento pubblico.
Come subentra una persona al posto dell'agente?
Attraverso il canale stesso. Con Coexistence, il personale del tuo cliente continua a usare l'app WhatsApp Business sullo stesso numero, e ogni messaggio che invia arriva al tuo webhook come smb_message_echoes. Tratta un eco come un passaggio di consegne: metti in pausa l'agente su quella conversazione, passa la risposta del personale al modello come contesto e riprendi dopo un periodo di silenzio o quando il personale te la riconsegna nel tuo prodotto. Anche Instagram restituisce come eco i DM dell'account stesso, quindi la stessa regola impedisce all'agente di rispondere a se stesso.
L'agente deve anche pubblicare, oltre a rispondere?
Può farlo, con la stessa chiave. L'agente redige i post e il tuo backend li accoda con POST /channels/:id/posts su Instagram, Facebook, TikTok e LinkedIn, da 1 minuto a 90 giorni in anticipo, con post.published e post.failed che riportano l'esito all'archivio delle conversazioni. I post LinkedIn partono solo dopo che una persona approva ciascuno nel tuo prodotto, poiché i Termini dell'API di LinkedIn limitano la pubblicazione automatizzata.
Come reagisce il prodotto quando una connessione cade?
Tramite uno stato sulla riga del canale. Un evento di stato lo porta a disconnected, removed o suspended, l'agente smette di inviare su quel canale e la tua interfaccia chiede al tenant di ricollegarsi tramite una nuova sessione di connessione. Un evento connection.token_missing lascia un numero in grado di ricevere ma non di inviare, quindi l'agente redige bozze di risposta per il personale. connection.connected o channel.connected riporta la riga su active, e il worker recupera credenziali nuove prima della risposta successiva.
Quali dati conservi e quali conserva easyCoexistence?
Il tuo prodotto conserva le conversazioni. I messaggi di un numero WhatsApp passano da Meta direttamente al tuo webhook, e gli eventi social inoltrati transitano attraverso easyCoexistence senza una copia. easyCoexistence conserva ciò che serve a far funzionare la connessione: il record dell'account, i suoi token, lo storico del suo stato di salute e i post che pubblica. Se il tuo account attiva anche le automazioni di easyCoexistence, il testo dei loro messaggi viene conservato per 7 giorni e i log di esecuzione per 30.
Errori comuni
- Usare come chiave solo il numero di telefono della persona. La stessa persona può scrivere a due dei tuoi tenant, quindi indicizza ogni thread insieme sul canale e sull'ID della persona.
- Lasciare che due worker rispondano alla stessa conversazione. Worker in parallelo possono inviare risposte fuori ordine o due volte, quindi blocca ogni thread mentre l'agente ci lavora.
- Tenere l'agente attivo dopo che il personale risponde dall'app WhatsApp Business. L'eco indica che una persona ha preso in mano il thread, quindi metti in pausa l'agente lì finché la tua regola di passaggio di consegne non lo riattiva.
- Pubblicare le bozze LinkedIn dell'agente con un timer. Una persona approva ogni post LinkedIn, quindi indirizza quelle bozze a una fase di revisione prima che raggiungano la coda.
easyCoexistence è il livello di connessione per il tuo prodotto con agenti: i numeri WhatsApp dei tuoi clienti e i loro account Instagram, Facebook, TikTok, YouTube e LinkedIn, più altri canali, collegati tramite link ospitati, con credenziali sempre aggiornate, webhook, una coda di pubblicazione ed eventi di stato firmati, con ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni gratuiti.
Domande frequenti
I clienti dei miei clienti devono installare qualcosa?
No. Scrivono all'azienda come già fanno, su WhatsApp, nei DM di Instagram o Messenger, oppure nei commenti, e il tuo agente risponde sullo stesso canale.
Il personale dei miei clienti può continuare a rispondere a mano?
Sì. Con Coexistence, l'app WhatsApp Business continua a funzionare sullo stesso numero, e ogni messaggio inviato dal personale arriva al tuo webhook come eco, così l'agente può farsi da parte.
easyCoexistence esegue il modello?
No. Il modello, i suoi prompt e la sua memoria girano nel tuo backend. easyCoexistence collega gli account, consegna i loro eventi e mantiene attivo il loro accesso.
Quanto costa easyCoexistence per cliente di una SaaS con agenti?
Ogni numero o account collegato costa da US$ 9 a US$ 0,75 al mese, con prezzo che scende man mano che il totale cresce, quindi un cliente su WhatsApp e Instagram conta due volte. I primi 3 giorni sono gratuiti.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il