Messaggi di risposta avanzati

Molte delle piattaforme di integrazione supportano messaggi di risposta avanzati specifici per le piattaforme. Questi messaggi possono essere usati per fornire all'utente non semplici risposte di testo. È possibile scegliere tra diversi tipi di risposta. Ad esempio, puoi mostrare immagini, riprodurre audio o fornire pulsanti. Ogni piattaforma supporta un sottoinsieme dei tipi di risposta disponibili.

Dove trovare questi dati

Durante la creazione di un agente, è più comune utilizzare Dialogflow ES Console (consulta la documentazione, apri la console). Le istruzioni riportate di seguito sono incentrate sull'utilizzo della console. Per accedere ai dati della risposta dell'intent:

  1. Vai alla console Dialogflow ES.
  2. Seleziona un agente.
  3. Seleziona Intent nel menu della barra laterale a sinistra.
  4. Seleziona un intent.
  5. Scorri verso il basso fino alla sezione Risposte.

Se stai creando un agente utilizzando l'API anziché la console, consulta la documentazione di riferimento per gli intent. I nomi dei campi API sono simili a quelli dei campi della console. Le istruzioni riportate di seguito evidenziano eventuali differenze importanti tra la console e l'API.

Aggiungi messaggi di risposta avanzati

La sezione Risposte contiene schede per ogni piattaforma, inclusa una piattaforma predefinita. Puoi definire le risposte per la piattaforma predefinita, utilizzabile su tutte le piattaforme.

Screenshot che mostra l'aggiunta di messaggi RTF.

Puoi definire le risposte per le schede specifiche della piattaforma, che funzionano solo sulle piattaforme corrispondenti. Puoi anche scegliere di utilizzare le risposte predefinite per una piattaforma specifica, in modo da non dover creare risposte di testo duplicate per tutte le piattaforme.

Screenshot che mostra l'aggiunta di messaggi RTF.

Per aggiungere messaggi di risposta avanzati:

  1. Seleziona la scheda relativa alla piattaforma che preferisci. Se la scheda della piattaforma che ti interessa non è visualizzata, fai clic sul pulsante Aggiungi e selezionala.
  2. Fai clic sul pulsante Aggiungi risposte. Un menu a discesa mostra i tipi di risposta supportati dalla piattaforma.
  3. Scegli il tipo di risposta. Questi sono descritti di seguito.
  4. Compila i campi per il tipo di risposta selezionato.
  5. Aggiungi altre schede della piattaforma e risposte in base alle tue esigenze. Puoi aggiungere fino a 10 messaggi ordinati in ogni scheda.
  6. Fai clic su Salva.

Puoi utilizzare i riferimenti ai parametri nelle risposte ai parametri di riferimento forniti dall'utente finale o dagli eventi in fase di runtime.

Risposte testuali

Per impostazione predefinita, le risposte di tipo Testo inviano un messaggio di risposta all'utente finale.

Se la sintesi vocale è attivata per un agente o richiesta dalle richieste di rilevamento dell'intento, il testo fornito viene utilizzato per sintetizzare la voce e riprodurre l'audio. In questo caso, il testo fornito può utilizzare facoltativamente il linguaggio SSML (Speech Synthesis Markup Language).

I campi sono:

  • Elenco di voci di testo o SSML

Quando inserisci una risposta, premi Maiusc + Invio per inserire una nuova riga o semplicemente Invio per inserire un'altra risposta di testo.

Si applicano le seguenti limitazioni:

  • Massimo 300 voci di testo per risposta

Risposte immagine

Le risposte Image inviano un'immagine all'utente finale. Contengono i seguenti campi:

  • URL accessibile pubblicamente per l'immagine

Risposte scheda

Le risposte della scheda inviano all'utente finale un'immagine, il titolo di una scheda, il sottotitolo della scheda e pulsanti interattivi. Lo stile della scheda varia in base alla piattaforma.

Puoi configurare i pulsanti per indirizzare l'utente finale a un URL o per inviare testo preconfigurato a Dialogflow come se l'utente finale fornisse un'espressione.

Alcuni dei campi sono facoltativi, a seconda della piattaforma:

  • URL accessibile pubblicamente per un'immagine
  • Titolo della scheda
  • Sottotitolo della scheda
  • Elenco dei pulsanti con i seguenti campi:
    • Titolo del pulsante
    • Testo da inviare come espressione dell'utente finale o URL da aprire

Si applicano le seguenti limitazioni:

  • Massimo 10 schede per piattaforma e per lingua per un intent. Ad esempio, se il tuo agente supporta inglese, francese, piattaforma X e piattaforma Y, un intent può avere al massimo 40 schede:

    • 10 carte in inglese per la piattaforma X
    • 10 carte in inglese per la piattaforma Y
    • 10 carte francesi per la piattaforma X
    • 10 carte francesi per la piattaforma Y

Risposte rapide

Le risposte rapide inviano un pulsante all'utente finale. Puoi configurare i pulsanti per inviare testo preconfigurato a Dialogflow come se l'utente finale fornisse un'espressione.

I campi sono:

  • Titolo del pulsante
  • Elenco di voci di testo da inviare come espressione dell'utente finale

Si applicano le seguenti limitazioni:

  • Massimo una risposta rapida per piattaforma e lingua per un intent. Ad esempio, se l'agente supporta inglese, francese, piattaforma X e piattaforma Y, un intent può avere al massimo 4 risposte rapide:

    • 1 risposta rapida in inglese per la piattaforma X
    • 1 risposta rapida in inglese per la piattaforma Y
    • 1 risposta rapida in francese per la piattaforma X
    • 1 risposta rapida in francese per la piattaforma Y
  • Massimo 10 voci di testo per risposta rapida.

  • Massimo 20 caratteri per voce di testo.

Sintetizza risposte vocali

Le risposte Sintetizza vocale vengono utilizzate per sintetizzare la sintesi vocale da risposte testuali e riprodurre l'audio. Il testo fornito può facoltativamente utilizzare il linguaggio SSML (Speech Synthesis Markup Language).

I campi sono:

  • Testo o SSML

Si applicano le seguenti limitazioni:

Riproduci risposte audio

Le risposte Riproduci audio vengono utilizzate per riprodurre i file audio. I file audio vengono forniti in un bucket Cloud Storage.

I campi sono:

  • URI dell'oggetto Cloud Storage in formato gs://bucket-name/object-name.

Si applicano le seguenti limitazioni:

  • Funzionalità supportata solo dall'integrazione del gateway telefonico Dialogflow
  • Specifiche dei file audio: un canale singolo (mono) di audio PCM lineare (2 byte / campione) a 8 kHz
  • Massimo 20 risposte audio in riproduzione per intent

Trasferisci le risposte alle chiamate

Le risposte di trasferimento della chiamata vengono utilizzate per trasferire il chiamante per un'integrazione della telefonia.

I campi sono:

  • Il numero di telefono a cui effettuare il trasferimento.

Si applicano le seguenti limitazioni:

Risposte payload personalizzate

Alcune piattaforme supportano risposte di payload personalizzate per gestire risposte avanzate non standard. Questi payload personalizzati sono forniti in un formato JSON definito nella documentazione della piattaforma.

Puoi anche inviare un payload personalizzato alle integrazioni che sviluppi. Non verrà elaborato da Dialogflow, quindi dovrai gestirlo nella tua logica di business.

Puoi configurare un payload personalizzato per più piattaforme. Per la configurazione, usa la piattaforma predefinita e un formato JSON simile al seguente:

{
  "facebook": {
    "attachment": {
      "type": "",
      "payload": {}
    }
  },
  "slack": {
    "text": "",
    "attachments": []
  }
}

Tipi di risposta dell'Assistente Google

L'integrazione dell'Assistente Google fornisce molti tipi di messaggi di risposta. Per ulteriori informazioni, consulta la pagina di riferimento sulle risposte dell'Assistente Google.

Altri tipi di risposta

Altri tipi di messaggi sono supportati da varie piattaforme. Puoi visualizzare l'elenco completo nel riferimento REST del messaggio di risposta. Per saperne di più, consulta la documentazione sull'integrazione della piattaforma.