Informazioni di base canale
Informazioni sui canali
Per esporre gli assistenti digitali e le competenze autonome agli utenti, è necessario configurare i canali in Digital Assistant. I canali portano la chat avanti e indietro dagli utenti su varie piattaforme di messaggistica all'assistente digitale e alle sue varie competenze. Esistono anche canali per l'escalation e il test dell'agente utente.
Tipi di canale
È possibile creare e gestire i seguenti tipi di canale dalla pagina Canali, a cui si accede facendo clic su Canali nel menu a sinistra. C'è una scheda per ogni tipo.
Tipo di canale | Usa |
---|---|
Utenti |
|
Integrazioni agente |
|
DA come agente |
|
Applicazioni |
|
Sistema |
|
Instradamento canale utente
È possibile instradare ogni canale rivolto all'utente a una singola versione di un assistente digitale o di uno skill.

Descrizione del routing dell'immagine: menu.png
È possibile eseguire su un canale una sola versione di uno skill o di un assistente digitale alla volta. Quando si crea una nuova versione dello skill, è possibile interrompere l'instradamento alla versione precedente e quindi assegnare l'instradamento alla versione aggiornata.
È possibile supportare l'esecuzione contemporanea di due versioni di uno skill o di un assistente digitale creando canali separati per ciascuno di essi. Ad esempio, i beta tester potrebbero accedere alle competenze attraverso un canale mentre i clienti continuano a chattare attraverso un canale separato ininterrottamente.
Instrada (o reindirizza) un canale
-
Fare clic su
per aprire il menu laterale e selezionare Sviluppo > Canali > Utenti.
- Selezionare la scheda Utenti e selezionare il canale.
- Nel canale, accanto al campo Invia a, selezionare
, quindi selezionare l'assistente digitale o lo skill in cui si desidera instradare il canale.
Funzionamento dell'instradamento del canale utente di Digital Assistant
Quando si registra un'abilità a un assistente digitale, i messaggi inviati e ricevuti vengono trasmessi tramite i canali utente dell'assistente digitale. Il routing dell'assistente digitale prende il sopravvento, anche se l'abilità ha già altri canali instradati ad esso.
Ad esempio, diciamo che ci sono due competenze, ognuna con il proprio canale Web che sono state registrate a un assistente digitale, che a sua volta si indirizza al proprio canale Web e a un canale Facebook. Quando gli utenti inviano un messaggio all'assistente digitale tramite il canale Web dell'assistente digitale, determina l'intento e invia il messaggio allo skill appropriato. Quando lo skill risponde, il relativo messaggio viene inviato all'utente tramite il canale Web dell'assistente digitale, non tramite il canale Web dello skill. Allo stesso modo, quando l'assistente digitale intercetta un messaggio da un abbonato di Facebook, la risposta dell'abilità all'utente viene inviata sul canale Facebook dell'assistente digitale invece del canale Web dell'abilità.
Test rendering per un canale
Per vedere come verrà visualizzata una conversazione con un assistente digitale o una singola abilità in un determinato canale utente, è possibile utilizzare il tester.
-
Aprire l'assistente digitale o lo skill che si desidera testare.
-
Nella parte inferiore della navigazione a sinistra per l'assistente digitale o la competenza, fare clic su
.
-
Nell'elenco a discesa Canale selezionare il canale in cui si prevede di distribuire l'assistente digitale o la competenza.
-
Nel campo di testo nella parte inferiore del tester, immettere un testo di test.
Durante il test del canale, è possibile vedere come verrà visualizzato nel canale. Inoltre, quando esistono limitazioni per quel tipo di canale che costringono la conversazione a essere visualizzata in modo diverso da quello che potrebbe essere altrimenti, tali limitazioni sono descritte nella scheda Conversazioni.
Aggiornamenti canale senza tempi di inattività
È possibile reindirizzare il canale da uno skill o da un assistente digitale a un altro senza causare tempi di inattività dell'utente.
Ecco come si imposta:
- Per un canale indirizzato a un assistente digitale, effettuare le operazioni riportate di seguito.
- Creare una nuova versione dell'assistente digitale.
- Nella nuova versione dell'assistente digitale, apportare le modifiche necessarie, inclusa l'aggiunta di nuove versioni delle competenze esistenti.
- Reindirizza il canale alla nuova versione dell'assistente digitale.
- Per un canale indirizzato a una singola abilità:
- Creare una nuova versione dello skill, apportare gli aggiornamenti desiderati e pubblicare lo skill.
- Reindirizza il canale alla nuova versione dello skill.
Ecco cosa succede dopo il reindirizzamento del canale:
- Se l'utente non dispone di una sessione aperta, riceverà il nuovo assistente digitale o la nuova abilità al successivo accesso al canale.
- Se l'utente dispone di una sessione aperta con l'assistente digitale o lo skill ma non si trova nel mezzo di un flusso in uno skill, la sessione viene aggiornata con l'assistente digitale o lo skill aggiornati.
- Se l'utente si trova nel mezzo di un flusso di uno skill quando il canale viene reindirizzato, l'utente continuerà a visualizzare la versione precedente dello skill o dell'assistente digitale. Al termine del flusso (che si verifica quando viene richiamata la transizione
return
nel flusso), la sessione verrà aggiornata con l'assistente digitale o la competenza aggiornati.
Attenzione:
Se si aggiorna un assistente digitale esistente (anziché creare una nuova versione dell'assistente digitale e quindi eseguire di nuovo il reindirizzamento a tale versione), la funzione senza tempi di inattività non funzionerà. Ad esempio, se una nuova versione di uno skill è stata aggiunta all'assistente digitale e un utente si trova nel mezzo di una sessione con la versione precedente dello skill, la sessione verrà interrotta e lo skill smetterà di funzionare.Formattazione Rich Text nei canali
È possibile utilizzare i tag HTML per formattare i messaggi di skill, anche per i canali con markup o markdown specifici del canale. Quando il messaggio viene passato al canale, i tag HTML inclusi vengono sostituiti con il markup o il markdown appropriato per quel canale specifico. Ciò consente di scrivere messaggi in un'unica posizione per più canali.
Se un tag non ha un equivalente diretto in un canale, viene utilizzato l'equivalente più vicino. Ad esempio, se il messaggio contiene tag <h1>Title 1</h1>
e <h2>Title 2</h2>
, tali tag vengono convertiti in *Title 1*
e *Title 2*
quando vengono inviati a un canale Slack.
Se non esiste un equivalente approssimativo per il tag nel canale, i tag vengono semplicemente rimossi dal messaggio quando inviati al canale.
Stile | Tag e attributi HTML |
---|---|
grassetto |
<strong> ; <b> |
corsivo | <em> ; <i> |
intestazioni | <h1> ; <h2> ; <h3> |
elenchi non ordinati (inclusa la nidificazione) | <ul> ; <li> |
liste ordinate (inclusa la nidificazione) | <ol> ; <li> |
testo pre-formattato | <pre> |
blocca | <blockquote> |
newline | <newline> |
collegamento ipertestuale | <a href=""> Nota: se il collegamento include una E commerciale ( |
collegamento immagine | <img> |
tabella | <table> ; <th> ; <tr> ; <td> |
Dimensione carattere | font-size (ad esempio, <p style="font-size:large;">Large Font</p> )
|
Colore carattere | color (ad esempio, <p style="color:red;">Red Font</p> )
|
video | <video controls="" src="link_to_video_source_file"> Nota: questa tag funziona solo se si esegue il collegamento diretto al file video, ad esempio |
Scadenza sessione
Per ogni canale configurato, utilizzare il campo Scadenza sessione per impostare il timeout per le sessioni utente inattive. Per la maggior parte dei tipi di canale, il valore predefinito è un giorno (1440 minuti). Quando la sessione è scaduta, la conversazione viene interrotta e viene inviato un messaggio per informare l'utente di tale fatto.
Inoltre, tutte le variabili impostate nel flusso di dialogo di un'abilità verranno eliminate, a meno che la variabile non sia stata dichiarata come variabile con ambito utente. Vedere Variabili con ambito utente nei flussi di dialogo YAML.
Modifica prompt scadenza sessione
Alla scadenza di una sessione, all'utente viene richiesto di immettere un messaggio impostato nella proprietà Prompt errore sessione scaduta per l'assistente digitale o lo skill al quale viene instradato il canale. Per impostazione predefinita, questo messaggio è "La sessione è scaduta. Per favore, ricomincia."
Per modificare questo messaggio per un assistente digitale:
-
Fare clic su
per aprire il menu laterale, selezionare Sviluppo > Assistenti digitali e aprire l'assistente digitale.
-
Nella navigazione a sinistra dell'assistente digitale, fare clic su
e selezionare la scheda Configurazioni.
- Scorrere fino alla sezione Altri parametri della pagina e aggiornare la proprietà Prompt errore sessione scaduta.
Per modificare questo messaggio per uno skill autonomo:
-
Fare clic su
per aprire il menu laterale, selezionare Sviluppo > Competenze e aprire lo skill.
-
Nella navigazione a sinistra dello skill, fare clic su
e selezionare la scheda Configurazione.
- Aggiornare la proprietà Prompt errore sessione scaduta.
Reimposta sessioni canale utente
Se necessario, è possibile interrompere le conversazioni correnti in un canale utente facendo clic sul relativo pulsante Reimposta sessioni.
Attenzione:
Questo pulsante è destinato principalmente ai casi in cui si sta sviluppando la competenza o l'assistente digitale. Se lo si utilizza per un canale in produzione, tutte le conversazioni utente in corso verranno interrotte.Per accedere al pulsante Reimposta sessioni, effettuare le operazioni riportate di seguito.
- Fare clic su
per aprire il menu laterale, selezionare Sviluppo > Canali e selezionare il canale utente.
Abilita o disabilita canali
Di tanto in tanto, potrebbe essere necessario disabilitare un canale per eseguire la manutenzione o gli aggiornamenti alla configurazione e quindi riabilitare il canale.
A tale scopo, è possibile utilizzare i seguenti switch:
- Canale abilitato
- Interazione abilitata (per integrazioni agente)
- Applicazione abilitata (per applicazioni)
La disabilitazione del canale di sistema, che supporta il tester di skill, avvisa gli sviluppatori che il canale non è disponibile.
Per accedere a queste opzioni:
- Fare clic su
per aprire il menu laterale, selezionare Sviluppo > Canali e selezionare il canale.
Estensioni specifiche per canale
Oltre agli elementi generici che è possibile utilizzare nei flussi di dialogo per eseguire il rendering su più canali, è anche possibile sfruttare le funzioni specifiche di un tipo di canale. È possibile farlo tramite l'elemento metadati channelCustomProperties
del componente Common Response, che assume il seguente formato:
...
channelCustomProperties:
- channel: "CHANNEL_NAME" // can be facebook, slack, cortana, twilio, androidsdk, iossdk, websdk, test
properties:
PROPERTY_NAME: "PROPERTY_VALUE"
...
È possibile applicare channelCustomProperties
nei metadati del componente a livello di globalActions
, responseItems
ed elementi di responseItems
, a seconda della proprietà specificata.
Di seguito è riportato un esempio di proprietà personalizzate definite a livello di elemento di risposta e a livello di scheda.
responseItems:
- type: "cards"
cardLayout: "vertical"
cards:
- title: "${pizzas.name}"
description: "${pizzas.description}"
imageUrl: "${pizzas.image}"
url: "${pizzas.moreInfo}"
iteratorVariable: "pizzas"
channelCustomProperties:
- channel: "facebook"
properties:
webview_height_ratio: "compact"
fallback_url: "https://www.example.com"
channelCustomProperties:
- channel: "facebook"
properties:
top_element_style: "large"
..
L'elemento channelCustomProperties
utilizza un array, in cui ogni voce specifica le proprietà di un canale specifico. Alcune proprietà personalizzate sono applicabili solo a un elemento componente di risposta comune specifico o anche a un tipo di elemento di risposta specifico, come nell'esempio precedente, dove top_element_style
si applica solo agli elementi di risposta di tipo cards
.
È inoltre possibile utilizzare le espressioni Freemarker per specificare il valore di una proprietà personalizzata del canale.
Di seguito è riportato un esempio in cui un selettore data viene visualizzato in Slack solo quando viene richiesto l'elemento della data di spesa durante la risoluzione della spesa dell'entità sacchetto composito:
responseItems:
- type: "text"
text: "${system.entityToResolve.value.prompt}"
channelCustomProperties:
- channel: "slack"
properties:
showDatePicker: "${system.entityToResolve.value.name=='Date'}"
...
Le proprietà disponibili variano in base al canale. Per l'elenco delle proprietà personalizzate disponibili per ciascun canale, vedere gli argomenti riportati di seguito.
Confronto delle funzionalità del canale
Ecco un confronto non esaustivo dei canali e delle funzionalità che supportano.
Funzione | Facebook Messenger | Slack | Microsoft Team | Cortana | Twilio | Web, iOS e Android |
---|---|---|---|---|---|---|
Testo | Sì | Sì | Sì | Sì | Sì | Sì |
Immagini | Sì | Sì | Sì | Sì per l'invio. No per la ricezione | Parzialmente | Sì |
File | Sì | Parziale per l'invio. Sì per la ricezione | Sì | Sì per l'invio. No per la ricezione | Parzialmente | Sì |
Emojis | Sì | Parziale per l'invio. Sì per la ricezione | Sì | Sì per l'invio. No per la ricezione | Parzialmente | Sì |
Posizione | Sì, ma non più valido | No | No | No | No | Sì |
Collegamenti | Sì | Sì | Sì | Sì | Sì | Sì |
Postback | Sì | Sì | Sì | No | Parzialmente | Sì |
Richieste ubicazione | Sì | No | No | No | No | Sì |
Estensioni | No | No | No | No | No | No |
Proprietà personalizzate | Sì | Sì | Sì | Sì | Parzialmente | Sì |
Selettore | Sì | Parzialmente | Sì | Sì | Parzialmente | Sì |
Elenca | Sì | Sì | Sì | Sì | Parzialmente | Sì |
Tabelle e moduli | No | Sì | Sì (la sottomissione automatica non è supportata) | No | No | Sì |
Per eseguire il rendering di un'emoji dal flusso della finestra di dialogo, iniziare con la relativa rappresentazione Unicode, sostituire
+
con 000
e anteporre al codice \
. Ad esempio, per U+1F600
, è possibile immettere \U0001F600
nel flusso della finestra di dialogo. Per un elenco dei codici Unicode per ogni emoji, vedere https://unicode.org/emoji/charts/full-emoji-list.html.
Confronto dei vincoli dei messaggi canale
Ecco un confronto di vincoli su messaggi e pulsanti di azione, per canale.
Vincoli messaggio di testo
Vincolo messaggio di testo | Facebook Messenger | Slack | Microsoft Teams e Cortana | Twilio | Web, iOS e Android |
---|---|---|---|---|---|
Lunghezza massima del messaggio di testo | 640 caratteri. Se la lunghezza supera 640, il testo viene diviso su più messaggi. | 3000 caratteri. Se la lunghezza supera 3000, il testo viene suddiviso su più messaggi. | Nessun limite. | 1600 caratteri. Se la lunghezza supera 1600, il testo viene diviso su più messaggi. | Nessun limite. |
Lunghezza massima dell'etichetta dell'azione di testo | 20 caratteri | 30 caratteri | 1 riga (circa 50 caratteri) | N/A | 128 caratteri |
Tipi di azioni di testo consentiti | Postback, chiamata, URL | Postback, URL | Postback, chiamata, URL | Postback, chiamata, URL. Questi tipi di azione vengono convertiti in testo. Per le azioni di postback, l'etichetta funge da parola chiave che può essere utilizzata per attivare il postback. | Postback, URL, Richiesta di posizione, Chiamata (se il dispositivo ha capacità di chiamata) e Condividi (se la piattaforma lo supporta) |
Numero massimo di azioni di testo | Se ci sono più azioni di testo, il messaggio viene convertito in più schede orizzontali, con lo stesso testo utilizzato come titolo su ogni scheda e ogni scheda contenente fino a 3 azioni. | Nessun limite. | Nessun limite. | N/A | Se ci sono più azioni di testo, il messaggio viene convertito in più schede orizzontali, con lo stesso testo utilizzato come titolo su ogni scheda e ogni scheda contenente fino a 6 azioni. |
Messaggi carta orizzontale
Vincolo messaggio carta orizzontale | Facebook Messenger | Slack | Microsoft Teams e Cortana | Twilio | Web, iOS e Android |
---|---|---|---|---|---|
supportato? | Sì | N. Il layout della scheda viene convertito in verticale. | Sì | No, ma la funzionalità quasi equivalente viene ottenuta convertendo alcuni tipi di azione in testo. | Sì |
Lunghezza massima del titolo | 80 caratteri | 3000 caratteri | 2 linee (circa 80 caratteri) | N/A | 30 caratteri |
Lunghezza massima della descrizione | 80 caratteri | 3000 caratteri | 25,000 caratteri | N/A | 128 caratteri |
Lunghezza massima dell'etichetta di azione della scheda | 20 caratteri | 30 caratteri | 1 riga (circa 50 caratteri) | N/A | 25 caratteri |
Numero massimo di schede | 10 | N/A | 10 | N/A | 10 |
Numero massimo di azioni carta | 3. Se il numero di azioni carta supera 3, la carta viene duplicata per eseguire il rendering delle azioni carta rimanenti. | N/A | 6. Se il numero di azioni carta supera 6, la carta viene duplicata per eseguire il rendering delle azioni carta rimanenti. | N/A | 3. Se il numero di azioni carta supera 3, la carta viene duplicata per eseguire il rendering delle azioni carta rimanenti. |
Numero minimo di azioni carta | 0 | N/A | 0 | N/A | 1 |
Numero massimo di azioni elenco carte | 0 | N/A | 6 | N/A | -- |
È richiesta almeno una descrizione, un'immagine o un'azione? | Sì | N/A | No | N/A | No |
Tipi di azioni carta consentite | Postback, Chiamata, URL, Condividi | Postback, URL | Postback, chiamata, URL | Postback, chiamata, URL. Questi tipi di azione vengono convertiti in testo. Per le azioni di postback, l'etichetta funge da parola chiave che può essere utilizzata per attivare il postback. | Postback, URL |
Tipi di azioni elenco carte consentiti | N/A | Postback, URL | Postback, chiamata, URL | Postback, chiamata, URL. Questi tipi di azione vengono convertiti in testo. Per le azioni di postback, l'etichetta funge da parola chiave che può essere utilizzata per attivare il postback. | Postback, URL |
Messaggi carta verticali
Vincolo messaggio carta verticale | Facebook Messenger | Slack | Microsoft Teams e Cortana | Twilio | Web, iOS e Android |
---|---|---|---|---|---|
supportato? | No | Sì | Sì | No, ma la funzionalità quasi equivalente viene ottenuta convertendo alcuni tipi di azione in testo. | Sì.
Nota
Per la versione 19.4.1, questa opzione non è supportata. |
Lunghezza massima del titolo | N/A | 3000 caratteri | 2 linee (circa 80 caratteri) | N/A | 30 caratteri |
Lunghezza massima della descrizione | N/A | 3000 caratteri | 25,000 caratteri | N/A | 128 caratteri |
Lunghezza massima dell'etichetta di azione della scheda | N/A | 30 caratteri | 1 riga (circa 50 caratteri) | N/A | 25 caratteri |
Numero massimo di schede | N/A | 100 | 10 | N/A | N/A |
Numero massimo di azioni carta | N/A | -- | 3 | N/A | N/A |
Numero minimo di azioni carta | 0 | 0 | 0 | N/A | N/A |
Numero massimo di azioni elenco carte | 1 | -- | 6 | N/A | N/A |
È richiesta almeno una descrizione, un'immagine o un'azione? | Sì | N/A | No | N/A | No |
Tipi di azioni carta consentite | Postback, Chiamata, URL, Condividi | Postback, URL | Postback, chiamata, URL | Postback, chiamata, URL. Questi tipi di azione vengono convertiti in testo. Per le azioni di postback, l'etichetta funge da parola chiave che può essere utilizzata per attivare il postback. | N/A |
Tipi di azioni elenco carte consentiti | Postback, chiamata, URL | Postback, URL | Postback, chiamata, URL | Postback, chiamata, URL. Questi tipi di azione vengono convertiti in testo. Per le azioni di postback, l'etichetta funge da parola chiave che può essere utilizzata per attivare il postback. | N/A |
Messaggi allegato
Vincolo messaggio allegato | Facebook Messenger | Slack | Microsoft Teams e Cortana | Twilio | Web, iOS e Android |
---|---|---|---|---|---|
supportato? | Sì | Sì | Sì | Sì, se MMS è abilitato | Sì |
Numero massimo di azioni allegato | 0 | -- | -- | N/A | -- |
Tipi di azioni consentite | N/A | Postback,URL | Postback, chiamata, URL. | Postback, chiamata, URL. Questi tipi di azione vengono convertiti in testo. Per le azioni di postback, l'etichetta funge da parola chiave che può essere utilizzata per attivare il postback. | Postback,URL |
Pulsanti di azione
Vincolo pulsante azione | Facebook Messenger | Slack | Microsoft Teams e Cortana | Twilio | Web, iOS e Android |
---|---|---|---|---|---|
supportato? | Sì | Sì | Sì | No, ma la funzionalità quasi equivalente viene ottenuta convertendo alcuni tipi di azione in testo. | Sì |
Lunghezza massima dell'etichetta azione globale | 20 caratteri | 30 caratteri | 1 riga (circa 50 caratteri) | N/A | 128 caratteri |
Numero massimo di azioni globali | 11 | -- | 6 | N/A | -- |
Tipi di azioni globali consentiti | Postback, posizione | Postback,URL | Postback, chiamata, URL | Postback, chiamata, URL. Questi tipi di azione vengono convertiti in testo. Per le azioni di postback, l'etichetta funge da parola chiave che può essere utilizzata per attivare il postback. | Postback, posizione |