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

Collega uno di questi in Impostazioni > Connettività > Gateway di 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 e in fase di ulteriore stabilizzazione.

Configurazione

  1. Attiva l'Accesso remoto per questo dispositivo in Impostazioni > Connettività > Connessioni > Relay privato. Questo è ciò che collega effettivamente il dispositivo al relay che riceve i messaggi in arrivo: senza di esso non arriva nulla, indipendentemente da come sono configurati i servizi sottostanti. È disattivato per impostazione predefinita e per singolo dispositivo (vedi Supporto piattaforma, di seguito).
  2. Vai su Impostazioni > Connettività > Gateway di messaggistica.
  3. Scegli un servizio.
  4. Inserisci le credenziali standard del bot o aziendali di quel provider: lo stesso token o account aziendale che useresti per qualsiasi integrazione su quella piattaforma.
  5. Caiioo registra la rotta in entrata. Se l'Accesso remoto non è ancora attivo da nessuna parte, Impostazioni > Connettività > Gateway di messaggistica te lo segnala e ti permette di attivarlo direttamente lì.

Configuri ogni servizio una sola volta. Dopodiché, l'agente vede un'unica funzionalità di messaggistica indipendentemente da quanti servizi siano 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

Tutto l'elaborazione dei messaggi avviene localmente, sul dispositivo su cui è attivo l'Accesso remoto: l'app desktop, l'estensione del browser o entrambi. L'agente viene eseguito sulla tua macchina; conversazioni, credenziali e file multimediali vengono gestiti lì, non nel cloud.

Cloudflare funge unicamente da relay webhook per-utente non intelligente. Ogni utente riceve un Durable Object single-tenant che inoltra il webhook in arrivo grezzo al tuo dispositivo tramite una connessione privata e nient'altro. Non esiste alcun cloud storage per i messaggi né elaborazione lato cloud. I messaggi in uscita bypassano completamente Cloudflare: il tuo dispositivo chiama direttamente l'API del servizio. Cloudflare è coinvolto solo perché i servizi esterni necessitano di un URL pubblico stabile per consegnare i webhook in arrivo.

Supporto piattaforma

Ciò che determina effettivamente se ricevi un messaggio è l'Accesso remoto (Impostazioni > Connettività > Connessioni > Relay privato): un interruttore per singolo dispositivo, disattivato per impostazione predefinita, che non viene sincronizzato di proposito tra i tuoi dispositivi (è un'impostazione di esposizione di rete, come l'apertura di una porta). Attivalo su ogni dispositivo con cui vuoi rispondere ai messaggi; lascialo disattivato su quelli in cui non vuoi.

  • macOS, Windows, Linux — supportati. Attiva l'Accesso remoto nell'app desktop per farlo rispondere.
  • Estensione per browser (Chrome, Safari) — supportata e funziona completamente da sola (nessuna app desktop richiesta). Attiva l'Accesso remoto nelle Impostazioni dell'estensione stessa e si connetterà direttamente rispondendo ai messaggi in autonomia.
  • Se hai sia un'app desktop che l'estensione con l'Accesso remoto attivo contemporaneamente, l'app desktop ha la priorità; l'estensione rimane in standby come backup nel caso in cui l'app desktop vada offline.
  • iOS o Android — non disponibili. Le app mobili non eseguono il client di relay privato da cui dipende il gateway, quindi i messaggi in arrivo non possono essere ricevuti o gestiti lì, indipendentemente dall'Accesso remoto.

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.