---
title: "Usar dados em uma sequência de voz"
description: "Defina campos de entrada de chamada, mapeie valores para etapas da sequência e trate informações opcionais do chamador e novos escopos de dados após uma transferência."
canonical: "https://bird.com/pt-br/documentacao/guides/voice/sequences/data"
---

# Usar dados em uma sequência de voz

> **Aviso:** as sequências de voz estão em versão prévia. As etapas, os dados de entrada e o formato de definição da sequência podem mudar de formas que quebram sequências existentes e solicitações API.

Defina os dados que uma entrada de chamada aceita e depois use esses dados nos campos de etapas compatíveis. Um lembrete pode aceitar o nome do cliente e o horário do compromisso a partir do aplicativo que inicia a chamada.

Use o seletor de campos para ver quais fontes e modos de valor a etapa selecionada suporta.

## Definir dados de entrada

1. Selecione a entrada **Start call** no seu rascunho.
2. Adicione os campos de dados e marque os obrigatórios.
3. Selecione uma etapa posterior e abra seu editor expandido.
4. Escolha um campo em **Available data** e visualize-o com dados de entrada representativos.

O `sequence.trigger_data` de uma chamada API deve ser um objeto correspondente ao schema da entrada selecionada. Forneça `{}` quando a entrada não precisar de dados. Uma rota de número de entrada fornece `{}`, então sua entrada deve aceitar um objeto vazio. Mantenha os campos de entrada opcionais e trate valores ausentes nas etapas seguintes.

Dados do aplicativo são separados da identidade da chamada. Um campo chamado `caller` fornecido pelo seu aplicativo não estabelece quem está ligando nem concede permissão para usar um número.

## Mapear um valor ou compor texto

Campos compatíveis oferecem valores fixos, valores de etapas anteriores, texto com valores inseridos ou expressões **fx**. Use um valor direto para um campo tipado e texto com valores inseridos para frases faladas. Uma string contendo dígitos continua sendo texto.

Por exemplo, defina um campo de string obrigatório chamado `customer_name` na entrada. Em um campo de fala compatível, combine `Hello`, um espaço, o valor do campo e `, your appointment is confirmed.` Visualize com `{"customer_name":"Ada"}` para inspecionar o texto preparado.

Expressões de voz leem campos de entrada como `trigger.data.customer_name`. Saídas anteriores elegíveis usam `steps.<step_id>.output`. O seletor de fonte ajuda você a escolher a etapa e o campo corretos.

## Tratar dados ausentes e ramificações

Campos opcionais podem estar ausentes, nulos ou vazios. Visualize esses casos e escolha um fallback explícito quando for apropriado. Uma etapa em um caminho não percorrido não tem saída naquela execução.

Observações da chamada ficam em `execution`. Por exemplo, o número do chamador original pode estar ausente. Uma expressão protegida o lê com segurança:

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

Essas observações descrevem endpoints telefônicos; elas não autenticam uma pessoa. A visualização precisa de uma amostra de execução quando uma expressão alcançada usa `execution`. Sem ela, a visualização para antes de avaliar essa etapa. Forneça-a em **Advanced scenario JSON**, seguindo o formato reportado pela validação.

Observações privadas do teclado não ficam disponíveis para fontes de expressão posteriores nem para detalhes retidos da etapa. Não projete um campo de fala ou resultado posterior em torno de dígitos privados.

## Passar dados por uma transferência

Uma **Transfer** local fornece um novo objeto para a entrada de destino. Mapeie os valores que essa entrada precisa e verifique seus campos obrigatórios.

O destino recebe `trigger.data` novos, e as saídas de etapas anteriores são limpas. Identidade da chamada, estado de gravação e limites de execução continuam. Passar um valor explicitamente é necessário quando a nova entrada precisa de informações do caminho anterior.

## Próximos passos

- [Configure prompts e menus de teclado](/docs/guides/voice/sequences/media-and-keypad).
- [Disque e transfira chamadas](/docs/guides/voice/sequences/dial-and-transfer).
- [Visualize e verifique uma sequência](/docs/guides/voice/sequences/preview).
- [Crie uma chamada pela API](/docs/guides/voice/create-calls).

## Related resources

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