Menu de Opções por Variáveis no fluxo de voz
O node Menu de Opções por Variáveis transforma uma lista armazenada no fluxo em opções numeradas, reproduz cada item por voz e guarda a opção escolhida. Ele é útil quando as alternativas vêm de uma integração e podem mudar a cada chamada.
Quando usar
- oferecer horários, unidades, pedidos ou serviços retornados por uma API;
- evitar criar manualmente uma saída para cada item dinâmico;
- salvar o item selecionado para uso nos próximos passos.
Onde configurar
Acesse Fluxos Avançados na plataforma. Pela interface, abra o módulo Voz, selecione Configurações e, na árvore Telefonia e Voz, escolha Fluxos Avançados.
Abra ou crie um fluxo. No editor, localize o grupo Coleta de dados. Na lista, o node aparece como Menu de Opções p/ Varíaveis; arraste o item para o canvas e abra sua configuração.
Visão da configuração
Campos de configuração
| Campo | Como usar |
|---|---|
| Texto da solicitação | Mensagem reproduzida antes da lista. Aceita variáveis. |
| Variável com Lista | Nome ou caminho da variável que contém uma lista. |
| Template da opção | Define como cada item será falado. Use {{index}}, {{value}} ou campos como {{label}}. |
| Variável de saída | Nome usado para guardar o item escolhido. |
| Timeout | Tempo em segundos para aguardar a escolha. |
| Repetir se não houver entrada | Quantidade de repetições de 0 a 5. |
Entradas e saídas
| Conexão | Comportamento |
|---|---|
| Opção Inválida | Usada quando a lista está vazia ou não há escolha válida após as tentativas. |
| Opção Selecionada | Usada quando um item é escolhido e salvo. |
Exemplo prático
- Use uma integração para salvar horários disponíveis em
horarios. - Informe
horariosem Variável com Lista e{{index}} para {{label}}no template. - Salve a escolha em
horarioSelecionadoe use-a no agendamento seguinte.
Boas práticas e cuidados
- A variável de origem precisa conter uma lista com ao menos um item.
- Use um campo realmente existente em todos os itens do template.
- Mantenha a lista curta para não criar um áudio cansativo.
- A variável de saída recebe o item selecionado, não apenas o número digitado.
Como testar
- Teste uma lista com valores simples e outra com objetos.
- Escolha uma opção válida e confira o conteúdo salvo.
- Teste lista vazia, timeout e número fora das opções.
Faça os testes em uma chamada controlada antes de vincular ou publicar o fluxo em um número de produção.