Canali
Elenco
Cliccando sul tab "Canali" della sidebar di sinistra è possibile elencare gli attuali canali sui quali si può interagire con gli agenti installati
Creazione
E' possibile creare creare fino a 10 canali web per agente mentre il canale Facebook è unico per pagina Facebook. Attualmente è possibile creare un nuovo canale di due tipi: Web o Facebook.
Cliccando su Web, si potrà scegliere :
- Nome del Canale
- Titolo della chat
- Messaggio introduttivo
- Inviare introduzione come testo: se si scegli "Si" il testo verrà inviato all'agente il quale risponderà in base alle intent create in precedenza
- bubble_avatar_url: l'immagine del widget sul quale occorre cliccare per aprire la chat
- user_id:
- placeholder: testo che compare nello spazio per il messaggio da inviare
- colore sfondo
- background msg utente: colore di sfondo dei messaggi utente
- background msg chatbot : colore di sfondo dei messaggi chatbot
- background header
- Abilita la creazione di issue?: se si è abilitato una integrazione Jira, il canale potrà inviare tickets
- Agente: agente al quale collegare il Canale
{info} Dopo la creazione comparirà il codice javascript da copiare sulla propria pagina web.
Esistono altri parametri facoltativi che sarà possibile inserire manualmente nello script di configurazione del widget e che non vengono creati nello snippet del codice:
- introMessage: un messaggio di testo di introduzione da parte dell'agent
- sendWidgetOpenedEvent:true/false (se true introMessage verrà inviato all'agent il quale potrà rispondere con più messaggi della intent corrispondente)
- expiresAfter: numero di minuti dopo il quale viene cancellata la cronologia e il bot riparte con il messaggio di benvenuto. Di default la cronologia dei messaggi non viene mai cancellata.
- authorisedDomain: dominio pagina dove è installato lo script di configurazione. Impedisce ad un codice malevolo proveniente da fonti non autorizzate di eseguire la Web API (facoltativo)
- changeLanguage:true/false. Se presente abilita lo switch sull'header fra le lingue installate per il canale web
Cliccando su Facebook si verrà rediretti alla pagina di creazione Canali Facebook. Ogni pagina Facebook gestita dall'amministratore dell'account può avere un agente che risponderà alle domande che verranno inviate sulla pagina Facebook o sull'account Messenger corrispondente.
Web API
Il widget web viene fornito con un'API Javascript per inviare messaggi programmaticamente dall'utente o da chatbot. È possibile utilizzare questa funzione quando l'utente fa clic su un pulsante del sito Web per attivare immediatamente il chatbot, senza che l'utente debba digitare qualcosa. Una volta inizializzato il widget della chat, è possibile accedere alla sua API sull'oggetto botmanChatWidget che viene esposto alla finestra contenente il widget della chat.
| Metodo | Descrizione |
|---|---|
| botmanChatWidget.open() | Apre il chat widget. |
| botmanChatWidget.close() | Chiude il chat widget. |
| botmanChatWidget.toggle() | Apre/chiude chat widget. |
| botmanChatWidget.say(text) | Per dire qualcosa al posto dell’utente. Il testo è visibile nel widget |
| botmanChatWidget.whisper(text) | Simile a say, con la differenza che il testo non è visibile |
| botmanChatWidget.sayAsBot(text) | Per dire qualcosa al posto del chatbot. Il testo è visibile nel widget |
| botmanChatWidget.setLocale(text) | Consente di cambiare lingua. Valori possibili:en,it,es |
| botmanChatWidget.setBubbleAvatarUrl(text) | Consente di cambiare dinamicamente la url dell’immagine di sfondo del widget quando è chiuso. |
| botmanChatWidget.isOpen() | true/false se widget aperto o chiuso |
Eventi
Il widget web invia degli eventi javascript sull'oggetto Window della pagina principale ogni qualvolta la chat viene aperta o chiusa. Gli eventi inviati sono:
- chat_opened
- chat_closed
Lo potrai gestire con un semplice :
window.addEventListener('chat_opened', function (e) { console.log('chat_opened') }, false);nello script di inizializzazione del widget.