Usare i dati in una sequenza vocale

Warning: Voice sequences are in preview. Steps, entry data, and the sequence definition format can change in ways that break existing sequences and API requests.

Definisci i dati accettati da un ingresso di chiamata, quindi usali nei campi degli step supportati. Un promemoria potrebbe accettare il nome del cliente e l'orario dell'appuntamento dall'applicazione che avvia la chiamata.

Usa il selettore di campo per vedere quali origini e modalità di valore supporta lo step selezionato.

Definire i dati di ingresso

1. Seleziona l'ingresso Start call nella tua bozza.
2. Aggiungi i campi dati e contrassegna quelli obbligatori.
3. Seleziona uno step successivo e apri il suo editor espanso.
4. Scegli un campo da Available data, quindi visualizzane l'anteprima con dati di ingresso rappresentativi.

Il sequence.trigger_data di una chiamata API deve essere un oggetto corrispondente allo schema dell'ingresso selezionato. Fornisci {} quando l'ingresso non richiede dati. Un instradamento di numero in entrata fornisce {}, quindi il suo ingresso deve accettare un oggetto vuoto. Mantieni i campi in entrata facoltativi e gestisci i valori mancanti negli step successivi.

I dati dell'applicazione sono separati dall'identità della chiamata. Un campo denominato caller fornito dalla tua applicazione non stabilisce chi sta chiamando né concede il permesso di utilizzare un numero.

Mappare un valore o comporre testo

I campi supportati offrono valori fissi, valori da step precedenti, testo con valori inseriti o espressioni fx. Usa un valore diretto per un campo tipizzato e testo con valori inseriti per le frasi pronunciate. Una stringa che contiene cifre resta testo.

Ad esempio, definisci un campo stringa obbligatorio denominato customer_name nell'ingresso. In un campo vocale supportato, combina Hello, uno spazio, il valore del campo e , your appointment is confirmed. Visualizza l'anteprima con {"customer_name":"Ada"} per controllare il testo preparato.

Le espressioni vocali leggono i campi di ingresso come trigger.data.customer_name. Gli output precedenti idonei usano steps.<step_id>.output. Il selettore di origine ti aiuta a scegliere lo step e il campo corretti.

Gestire dati mancanti e diramazioni

I campi facoltativi possono essere assenti, null o vuoti. Visualizza l'anteprima di questi casi e scegli un fallback esplicito quando è opportuno. Uno step su un percorso non intrapreso non produce output in quella esecuzione.

Le osservazioni della chiamata si trovano sotto execution. Ad esempio, il numero del chiamante originale può essere assente. Un'espressione con controllo lo legge in modo sicuro:

execution.call.orig != null && has(execution.call.orig.address) ? execution.call.orig.address : ''

Queste osservazioni descrivono endpoint telefonici; non autenticano una persona. L'anteprima richiede un campione di esecuzione quando un'espressione raggiunta usa execution. Senza di esso, l'anteprima si interrompe prima di valutare quello step. Forniscilo tramite Advanced scenario JSON, seguendo la struttura indicata dalla validazione.

Le osservazioni private della tastiera non sono disponibili per le origini di espressione successive né per i dettagli conservati dello step. Non progettare un campo vocale o di risultato successivo basandoti su cifre private.

Passare dati attraverso un trasferimento

Un Transfer locale fornisce un nuovo oggetto all'ingresso di destinazione. Mappa i valori necessari a quell'ingresso e verifica i suoi campi obbligatori.

La destinazione riceve trigger.data nuovi e gli output degli step precedenti vengono cancellati. Identità della chiamata, stato della registrazione e limiti di esecuzione restano attivi. Passare un valore in modo esplicito è necessario quando il nuovo ingresso ha bisogno di informazioni dal percorso precedente.

Prossimi passi

• Configurare prompt e menu a tastiera.
• Chiamare e trasferire chiamate.
• Visualizzare l'anteprima e verificare una sequenza.
• Creare una chiamata tramite la API.