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:

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.
• Disque e transfira chamadas.
• Visualize e verifique uma sequência.
• Crie uma chamada pela API.