Documentazione di Oracle Cloud Infrastructure

Canali solo testo

Come il canale Facebook, è possibile configurare canali di solo testo utilizzando artifact generati sia dalla piattaforma di messaggistica che da Digital Assistant. Per i canali di solo testo come Twilio/SMS, tuttavia, è necessario aggiornare anche la definizione del flusso della finestra di dialogo per consentire alle risposte del bot di eseguire il rendering in modo appropriato quando i pulsanti non sono supportati. Vi sono due aspetti:
  • Mostrare o nascondere il contenuto per i canali di solo testo. Per i componenti di risposta comune, ciò significa che è necessario aggiornare la proprietà metadata in modo da includere (o, se applicabile, escludere) Twilio per qualsiasi elemento di risposta, scheda o azione globale:
    responseItems:
- type: "text"
  text: "This text text displays on Twilio"
  visible:
    channels:
      include: "twilio"             
- type: "text"
  text: "This text is not shown in Twilio or Facebook!"
  visible:
    channels:
      exclude: "facebook, twilio"
  actions:
  - label: "This action is only shown on web channel."
    type: "postback"
    payload:
      action: "someAction"
    visible:
      channels:
        include: "web"

  • Configurazione di auto-numbering.

Twilio/SMS

Per eseguire l'assistente digitale su Twilio/SMS, è necessario disporre dei seguenti elementi:
  • Credenziali Twilio (le si forniscono alla configurazione del canale Digital Assistant):

    • Numero di telefono Twilio.

    • SID account

    • Token di autenticazione

  • Da Digital Assistant (e fornito a Twilio):

    • L'URL del webhook (generato quando si crea il canale Twilio).

Nota

Quando si crea un canale per un assistente digitale in Twilio, tenere presente che "exit", che gli utenti possono utilizzare per allontanarsi dalle competenze nell'assistente digitale, è anche una parola chiave predefinita in Twilio. Pertanto, se un utente immette "exit" in un canale Twilio, la conversazione Twilio verrà terminata e l'assistente digitale non riceverà tale input. Gli utenti che desiderano "uscita" per lavorare con l'assistente digitale dovrebbero contattare Twilio e avere "uscita" rimossa come parola chiave dal proprio account.

Passo 1: ottenere un numero Twilo abilitato per SMS

Per generare il numero Twilio, il SID account e il token di autenticazione necessari per la configurazione del canale Twilio, è innanzitutto necessario creare un account Twilio (se non si dispone già di un account). Dopo aver verificato la tua identità:

  1. Fare clic su Tutti i prodotti e i servizi (Questa è un'immagine dell'icona Tutti i prodotti e servizi.) nella barra di navigazione a sinistra.

  2. Inserire sia SMS programmabile (Questa è un'immagine dell'icona SMS programmabile.) che Numeri di telefono (Immagine dell'icona Numeri di telefono.) nel dashboard.
    Descrizione di twilio-products.png segue
    Descrizione dell'immagine twilio-products.png

  3. Fare clic su Numeri di telefono (ora bloccati nella barra di navigazione a sinistra), quindi fare clic su Per iniziare.

  4. Scegliere Ottieni un numero o Acquista un numero. In entrambi i casi, assicurarsi di selezionare la funzionalità SMS. Mantieni questo numero a portata di mano, perché utilizzerai questo numero per configurare nuovamente il canale Twilio in Digital Assistant.

  5. Fare clic su Dashboard console (Immagine dell'icona del dashboard.) nella barra di navigazione a sinistra e prendere nota del SID account e del token di autenticazione, a cui è possibile accedere facendo clic su Visualizza. Insieme al numero Twilio, sono necessarie queste credenziali per configurare il canale Twilio.

Passaggio 2: collega il tuo bot al numero Twilio

Con le credenziali Twilio a portata di mano:

  1. Tornare a Digital Assistant, fare clic sui canali nel menu a sinistra, quindi scegliere Utenti.

  2. Fare clic su Aggiungi canale.

  3. Nella finestra di dialogo Crea canale effettuare le operazioni riportate di seguito.

    1. Immettere un nome, quindi scegliere SMS Twilio dal menu Tipo canale.

    2. Immettere il SID account, il token di autenticazione e il numero Twilio.

    3. Attivare Canale abilitato.

    4. Fare clic su icona per l'elenco a discesa Instrada a ... e selezionare l'assistente digitale o lo skill che si desidera associare al canale.

  4. Fare clic su Crea. Prendere nota dell'URL del webhook. Questa operazione sarà necessaria per un'ultima sosta alla console Twilio.

  5. Nella console Twilio, fare clic su Numeri di telefono (Immagine dell'icona Numeri di telefono.), quindi su Numeri attivi.

  6. Fare clic sul numero Twilio nella pagina Numeri attivi.

  7. Nella sezione Messaggistica della pagina Configura incollare l'URL del webhook nel campo In arrivo di un messaggio.

  8. Fare clic su Salva.

Suggerimenti per i test

Puoi testare il canale Twilio utilizzando il tuo telefono inviando messaggi al numero di account Twilio di Digital Assistant.

Funzioni supportate

I canali Twilio in Digital Assistant supportano le seguenti funzionalità:

  • testo
  • Immagini (come URL)
  • file (come URL)
  • emoji (come URL)
  • collegamenti
  • postback (come URL)
  • proprietà personalizzate (parziali)
  • componenti carosello (parziali)
  • componenti elenco (parziale)
Nota

Se si sta indirizzando la propria abilità a più canali con diverse funzionalità di formattazione, è possibile utilizzare il markup HTML nei messaggi. Per i canali basati su testo, questo markup verrà rimosso dal messaggio quando il messaggio viene trasmesso al canale. Vedere Formattazione di testo ricco nei canali.

Vincoli messaggio

I canali Twilio in Digital Assistant hanno i seguenti vincoli di messaggio:

  • Messaggi di testo
    • Lunghezza massima del messaggio di testo: 1600 caratteri. Se la lunghezza supera 1600, il testo viene diviso su più messaggi.
    • Tipi di azioni di testo consentiti: Postback, Call, 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.
  • Schede orizzontali
    • Supportato?: No, ma la funzionalità quasi equivalente si ottiene convertendo alcuni tipi di azione in testo.
    • Tipi di azioni della carta consentiti: Postback, Call, 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.
    • Tipi di azioni dell'elenco di carte consentite: Postback, Call, 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.
  • Schede verticali
    • Supportato: No, ma la funzionalità quasi equivalente si ottiene convertendo alcuni tipi di azione in testo.
    • Tipi di azioni della carta consentiti: Postback, Call, 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.
    • Tipi di azioni dell'elenco di carte consentite: Postback, Call, 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.
  • Messaggi allegato
    • Supportato?: Sì, se MMS è abilitato.
    • Tipi di azioni di allegato consentiti: 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.
  • Pulsanti di azione
    • supportato? No, ma la funzionalità quasi equivalente viene ottenuta convertendo alcuni tipi di azione in testo.
    • Tipi di azioni globali consentiti: 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.

Estensioni canale Twilio

Per i canali Twilio, è possibile estendere le funzionalità dei componenti Common Response con funzionalità specifiche di Twilio.

Per accedere alle estensioni, utilizzare l'elemento channelCustomProperties nel componente e impostare le proprietà appropriate. Il codice ha il formato seguente: 

...
            channelCustomProperties:
            - channel: "twilio"
              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 sono riportate le proprietà personalizzate disponibili per i canali Twilio.

Nome Valori ammessi Si applica a... descrizione;
mmsEnabled
  • true
  • false
 Elementi di risposta di tipo cards o attachment. Può essere utilizzato per sostituire l'impostazione predefinita abilitata per MMS della configurazione del canale. Se l'opzione è abilitata, le immagini vengono visualizzate nel relativo fumetto con un pulsante Tocca per rivedere.
optimizeCardRendering
  • true
  • false
 Elementi di risposta di tipo cards. Impostare su true per rendere la selezione dell'azione scheda un processo in due fasi, in cui l'utente seleziona prima una scheda e quindi l'azione scheda.
cardListHeader
  • testo libero
 Elementi di risposta di tipo cards. Intestazione visualizzata quando viene visualizzato l'elenco di schede. Questa proprietà sostituisce la proprietà headerText del messaggio della scheda. Applicabile solo se optimizeCardRendering è impostato su true.
cardListFooter
  • testo libero
 Elementi di risposta di tipo cards. Il piè di pagina visualizzato quando viene visualizzato l'elenco delle schede. Questa proprietà sostituisce la proprietà footerText del messaggio della scheda. Applicabile solo se optimizeCardRendering è impostato su true.
cardDetailHeader
  • testo libero
 Uno degli elementi riportati di seguito.
  • Una scheda in cui è specificata la proprietà "url"
  • Un action dove "type": "url"
 Intestazione visualizzata quando vengono presentati i dettagli della carta. Questa proprietà sostituisce la proprietà headerText del messaggio della scheda. Applicabile solo se optimizeCardRendering è impostato su true.
cardDetailFooter
  • testo libero
 Uno degli elementi riportati di seguito.
  • Una scheda in cui è specificata la proprietà "url"
  • Un action dove "type": "url"
 Piè di pagina visualizzato quando vengono presentati i dettagli della scheda. Questa proprietà sostituisce la proprietà footerText del messaggio della scheda. Applicabile solo se optimizeCardRendering è impostato su true.

Per ulteriori informazioni sull'uso di channelCustomProperties, vedere Estensioni specifiche del canale.