Tema
Canali
Un Canale è il modo in cui un utente raggiunge la piattaforma. È l'unico punto di contatto: non esiste un'interfaccia di Calybron in cui l'utente finale entra — si scrive dove si scrive già, e la piattaforma risponde lì.
Un canale fa due cose, e nessuna delle due è capire il messaggio:
01Porta dentroRiceve il messaggio dalla piattaforma di messaggistica e lo consegna a Calybron, dicendo da chi arriva e in quale perimetro.
02Porta fuoriRiceve la risposta e la riconsegna nella forma di quel mezzo: un messaggio, una mail, una voce.
Quello che sta in mezzo — riconoscere l'intenzione, eseguire un processo, consultare i documenti — non è mai compito del canale. È la ragione per cui un canale nuovo si può aggiungere senza toccare niente di ciò che risponde, e per cui un'automazione scritta per un canale funziona su tutti gli altri.
I tipi disponibili
| Tipo | Come arriva l'utente | Pagina |
|---|---|---|
| Telegram | Un bot dedicato, nell'app che l'utente ha già | Telegram |
| Un numero WhatsApp Business | ||
| Una casella di posta che la piattaforma legge e a cui risponde | ||
| Chat web | Una conversazione dentro una pagina del sito, senza account | Chat web |
| Voce | Una telefonata, con riconoscimento e sintesi vocale | Voce |
Ogni tipo è indipendente dagli altri: la stessa organizzazione può averne quanti vuole, e lo stesso tipo più di una volta — due bot Telegram per due servizi diversi sono due canali.
Com'è fatto un canale
- Nome
- Come lo riconosce chi lo amministra
- Tipo
- Telegram, WhatsApp, Mail, Chat, Voce — decide quali parametri servono
- Token
- Il segreto con cui il canale si presenta alla piattaforma
- Reti ammesse
- Un intervallo di indirizzi da cui il canale può collegarsi. Facoltativo
- Scope
- Uno o più perimetri che quel canale serve
- Abilitato
- Un canale può essere spento senza essere cancellato
- Configurazione
- I parametri propri del tipo: credenziali, tempi, messaggi di benvenuto
Un canale esistente si può duplicare con un clic: stessa configurazione, token nuovo. È il modo più rapido per aggiungere un secondo bot, un secondo numero, una seconda casella.
Il token è il perimetro
Quando un canale si collega, si autentica con il proprio token. Non serve solo a dire «sono io»: è ciò da cui la piattaforma ricava quale canale sta parlando, di quale organizzazione e su quali scope ha diritto di operare.
Il token viene generato dalla piattaforma alla creazione del canale, e la dashboard lo mostra una volta sola. Le reti ammesse lo rafforzano: se il canale gira su un indirizzo noto, restringerle rende il token inutile fuori da lì.
Un canale, più scope
Un canale può servire più di uno scope. È il caso normale quando un unico punto di contatto — un solo bot, un solo numero — deve coprire ambiti che restano distinti: lo stesso bot risponde sia sui rifiuti sia sui tributi, e i due insiemi di intent non si mescolano.
Cosa determina lo scope di un messaggio
Non lo decide l'utente. Il canale porta dentro il messaggio col proprio contesto, e la piattaforma cerca l'intenzione fra gli intent di tutti gli scope che quel canale serve. Quando due ambiti hanno intenti molto simili, due canali distinti rendono il perimetro ancora più leggibile per chi scrive.
Ogni tipo dichiara i suoi parametri
Un canale Telegram vuole il token di un bot; uno Mail vuole un server di posta; uno Voce vuole una voce di sintesi. Questi parametri non sono scritti nel codice della dashboard: ogni tipo di canale porta con sé lo schema dei propri parametri, e il modulo di configurazione viene costruito da quello schema.
Ha due conseguenze pratiche:
- Il modulo che si compila in dashboard è l'elenco di ciò che quel tipo prevede
- Un tipo nuovo si aggiunge senza rifare la dashboard
Come si vede che un canale sta bene
Ogni canale in esercizio riporta il proprio stato al monitoraggio della piattaforma: nella scheda del canale e nella mappa dello stato del sistema si vede se è collegato e in salute, insieme a tutti gli altri componenti. Nella dashboard si vedono anche le sessioni che arrivano da ciascun canale, con il loro andamento nel tempo.
Il contratto, se ne stai costruendo uno
Tutti i canali parlano con la piattaforma con lo stesso protocollo: chi costruisce un canale nuovo — un chiosco, un gateway SMS, la chat di un portale scritto in casa — implementa quello e non ha bisogno di sapere niente di come la piattaforma risponde. Vedi Estendere Calybron.