# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-09-04T17:56:28.073Z

## Página

- Título: Menu de Opções por Variáveis no fluxo de voz
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-de-voz/menu-de-opcoes-por-variaveis
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Monte um menu de voz a partir de uma lista variável e salve o item escolhido.

## Seções

- Quando usar
- Onde configurar
- Visão da configuração
- Campos de configuração
- Entradas e saídas
- Exemplo prático
- Boas práticas e cuidados
- Como testar

## Conteúdo da página

# 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 :ScreenEntry{href="https://my.agilize.app/voice/flow" label="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

![Configuração do node Menu de Opções por Variáveis no fluxo de voz](/docs/screenshots/config-fluxo-voz-node-menu-de-opcoes-por-variaveis.png)

## 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

1. Use uma integração para salvar horários disponíveis em `horarios`.
2. Informe `horarios` em **Variável com Lista** e `{{index}} para {{label}}` no template.
3. Salve a escolha em `horarioSelecionado` e 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

1. Teste uma lista com valores simples e outra com objetos.
2. Escolha uma opção válida e confira o conteúdo salvo.
3. 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.

## Guias relacionados

- [Nodes de fluxos de voz](/docs/configuracao/referencias/nodes-fluxos-de-voz)
- [Telefonia](/docs/configuracao/telefonia)
- [Vínculo do fluxo de telefonia no número de entrada](/docs/configuracao/telefonia/vinculo-fluxo-telefonia-numero-entrada)