Questa è una traduzione automatica del documento originale in inglese. In caso di discrepanze tra la presente traduzione e la versione originale in inglese, prevarrà la versione inglese. Leggi la versione originale in inglese


Messaging Gateway: Lascia che Caiioo risponda sulle App che i tuoi contatti già usano

Il Messaging Gateway è un modo agnostico rispetto al servizio per consentire a Caiioo di inviare e ricevere messaggi sulle piattaforme che i tuoi clienti e contatti già utilizzano. Le persone ti scrivono su WhatsApp, Telegram o ovunque si trovino, e l'agente risponde loro autonomamente — nel loro canale, in tempo reale. Lo stesso gateway funziona anche nell'altro senso: da qualsiasi thread, l'agente può inviare un messaggio come strumento ("scrivi al gruppo del team su Telegram riguardo alla riunione").

Un unico gateway, molti servizi. Connetti ogni servizio una volta e Caiioo normalizza tutto dietro un'unica interfaccia.

Servizi Supportati

Connetti uno di questi in Impostazioni > Messaggistica:

  • WhatsApp Business — stabile
  • Telegram — stabile
  • Messenger (beta)
  • iMessage (beta)
  • Signal (beta)
  • Viber (beta)
  • Beeper (beta)

WhatsApp Business e Telegram sono stabili. Gli altri sono in beta — pienamente utilizzabili, ma ancora in fase di perfezionamento.

Configurazione

  1. Vai su Impostazioni > Messaggistica (il Messaging Gateway).
  2. Scegli un servizio.
  3. Inserisci le credenziali standard del bot o dell'account business di quel provider — lo stesso token o account che useresti per qualsiasi integrazione su quella piattaforma.
  4. Caiioo registra la rotta in entrata e inizia l'ascolto.

Configuri ogni servizio una volta sola. Dopodiché, l'agente vede un'unica funzionalità di messaggistica indipendentemente da quanti servizi sono collegati.

Modalità di Interazione per Conversazione

Ogni conversazione ha la sua modalità, scelta tra tre pulsanti in cima al thread, così decidi esattamente come l'agente si presenta per ogni contatto:

Auto (verde)

L'agente risponde a tutti automaticamente. Qualsiasi cosa tu scriva in quello stesso thread è trattata come coaching — modella la risposta successiva dell'agente ma non viene inviata al contatto. Usa questa modalità quando vuoi che l'agente gestisca la conversazione ma desideri occasionalmente guidarlo ("sii più formale", "offri lo sconto").

Chime In (blu)

L'agente risponde ancora automaticamente ai messaggi in arrivo, ma tutto ciò che scrivi tu arriva direttamente al contatto a tuo nome. Usa questa modalità quando vuoi intervenire e parlare personalmente con la persona mentre l'agente mantiene attiva la conversazione nel frattempo.

Chat (ambra)

L'agente si mette in pausa e si fa da parte — smette di rispondere automaticamente e tu gestisci la conversazione personalmente, con i tuoi messaggi inviati al contatto a tuo nome. Usa questa modalità quando un thread richiede l'intervento umano e vuoi che l'IA non interferisca.

Media in Entrambe le Direzioni

Immagini, audio e video fluiscono in entrambe le direzioni. Quando un contatto invia una foto, questa raggiunge il modello, così puoi chiedere "cosa c'è in questa foto che il cliente ha appena inviato?" e rispondere subito nello stesso canale. I media prodotti o allegati dall'agente tornano al contatto allo stesso modo.

Privacy e Architettura

Tutta l'elaborazione dei messaggi avviene localmente, sul tuo server desktop. L'agente gira sulla tua macchina; conversazioni, credenziali e media sono gestiti lì — non nel cloud.

Cloudflare funge solo da semplice relay di webhook per utente. Ogni utente riceve un Durable Object a singolo tenant che inoltra il webhook grezzo in entrata al tuo server locale tramite una connessione privata e nulla più. Non c'è alcuna archiviazione di messaggi nel cloud né elaborazione lato cloud. I messaggi in uscita bypassano completamente Cloudflare — il tuo server locale chiama direttamente l'API del servizio. Cloudflare è nel circuito solo perché i servizi esterni necessitano di un URL pubblico stabile per consegnare i webhook in entrata.

Supporto Piattaforma

Il Messaging Gateway gira sulla tua app desktop o server — è lì che risiedono il relay dei webhook e l'elaborazione dei messaggi:

  • macOS — supportato
  • Windows — supportato
  • Linux — supportato

L'estensione del browser (Chrome, Safari) può usare il gateway a sua volta, purché sia connessa alla tua app desktop — il server desktop effettua la ricezione e l'elaborazione effettiva per suo conto.

Non è disponibile su iOS o Android. Le app mobili non eseguono il relay dei webhook o l'elaborazione locale da cui dipende il gateway, quindi i messaggi in arrivo non possono essere ricevuti o risposti lì.

Una nota su Slack

Slack non fa parte del Messaging Gateway. Slack risiede nel Community Hub come pacchetto OAuth a sé stante — installalo da lì. Vedi Community Hub.

Piano

Il Messaging Gateway è una funzionalità Pro.

Vedi Anche


This guide is maintained by the Caiioo team using Slate, our built-in editor.