---
title: "Usare i dati in una sequenza vocale"
description: "Definisci i campi di ingresso della chiamata, mappa i valori negli step della sequenza e gestisci le informazioni facoltative del chiamante e i nuovi ambiti dati dopo un trasferimento."
canonical: "https://bird.com/it-it/documentazione/guides/voice/sequences/data"
---

# Usare i dati in una sequenza vocale

> **Avviso:** le sequenze vocali sono in anteprima. Gli step, i dati di ingresso e il formato di definizione della sequenza possono cambiare in modi che rendono non funzionanti le sequenze e le richieste API esistenti.

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:

```text
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](/docs/guides/voice/sequences/media-and-keypad).
- [Chiamare e trasferire chiamate](/docs/guides/voice/sequences/dial-and-transfer).
- [Visualizzare l'anteprima e verificare una sequenza](/docs/guides/voice/sequences/preview).
- [Creare una chiamata tramite la API](/docs/guides/voice/create-calls).

## Related resources

- [Voice sequences](/docs/guides/voice/sequence-builder) (docs)