# 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:54:57.783Z

## Página

- Título: Solicitar Informação (TTS) no fluxo de voz
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-de-voz/solicitar-informacao
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Faça uma pergunta por voz, capture os dígitos digitados e salve a resposta em uma variável.

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

# Solicitar Informação (TTS) no fluxo de voz

O node **Solicitar Informação** reproduz uma pergunta em voz, aguarda dígitos no teclado do telefone e salva a resposta em uma variável. Ele separa o caminho de valor capturado do caminho sem resposta.

## Quando usar

- coletar documento, código, número de pedido ou outra sequência numérica;
- usar a resposta em uma consulta, condição ou registro posterior;
- tratar ausência de resposta com repetição ou atendimento alternativo.

## 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 **Solicitar Informação (TTS)** no grupo **Coleta de dados**, arraste o item para o canvas e abra sua configuração.

## Visão da configuração

![Configuração do node Solicitar Informação (TTS) no fluxo de voz](/docs/screenshots/config-fluxo-voz-node-solicitar-informacao.png)

## Campos de configuração

| Campo | Como usar |
| --- | --- |
| Texto da solicitação | Mensagem convertida em voz para pedir o dado. |
| Variável de saída | Nome usado para guardar os dígitos capturados. |
| Máximo Dígitos | Quantidade máxima aceita, de 1 a 32. |
| Tempo de Espera Máx. (segundos) | Tempo para aguardar a digitação, de 1 a 60 segundos. |
| Máx. Tentativas (em caso de timeout) | Quantidade de novas tentativas sem resposta, de 1 a 10. |

## Entradas e saídas

| Conexão | Comportamento |
| --- | --- |
| Valor Capturado | Usada quando ao menos um dígito é recebido e salvo. |
| Sem Resposta | Usada quando as tentativas terminam sem captura. |

## Exemplo prático

1. Escreva `Digite o número do seu pedido`.
2. Use `numeroPedido` como variável de saída e limite a quantidade de dígitos esperada.
3. Conecte **Valor Capturado** a uma consulta e **Sem Resposta** a uma mensagem de ajuda.

## Boas práticas e cuidados

- O node captura teclas numéricas; não use para respostas faladas ou textos.
- Não colete dados sensíveis sem necessidade e sem política adequada de tratamento.
- Ajuste dígitos e espera ao formato real do dado para reduzir erros.

## Como testar

1. Digite uma resposta válida e confirme seu uso no próximo node.
2. Não digite nada para validar tentativas e a saída **Sem Resposta**.
3. Teste respostas no tamanho máximo configurado.

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)