# 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:50.771Z

## Página

- Título: Gerar Protocolo no fluxo de voz
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-de-voz/gerar-protocolo
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Gere um protocolo para a chamada e reutilize-o em mensagens, integrações e atendimento.

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

# Gerar Protocolo no fluxo de voz

O node **Gerar Protocolo** cria um código numérico e o associa à chamada. Se a ligação já possui um protocolo gerado, o mesmo valor é reutilizado para manter a identificação consistente ao longo da jornada.

## Quando usar

- informar um identificador ao cliente;
- mostrar o protocolo ao atendente antes da transferência;
- enviar o código para CRM, WhatsApp ou uma integração.

## 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 **Gerar Protocolo** no grupo **Dados e integrações**, arraste o item para o canvas e abra sua configuração.

## Visão da configuração

![Configuração do node Gerar Protocolo no fluxo de voz](/docs/screenshots/config-fluxo-voz-node-gerar-protocolo.png)

## Campos de configuração

| Campo | Como usar |
| --- | --- |
| Variável de saída | Nome usado para guardar o protocolo. O padrão é `PROTO_NUMBER`. |
| Tamanho do protocolo | Defina de 8 a 32 dígitos. O padrão é 12. |

## Entradas e saídas

| Conexão | Comportamento |
| --- | --- |
| Entrada | Recebe a chamada do node anterior. |
| Gerado | Segue depois de gerar ou recuperar o protocolo da chamada. |

## Exemplo prático

1. Adicione **Gerar Protocolo** antes da transferência.
2. Mantenha `PROTO_NUMBER` como variável de saída.
3. Use **Reproduzir Áudio (TTS)** para falar `Seu protocolo é {{PROTO_NUMBER}}`.
4. Use **Destacar Variável na Interface** para exibir o mesmo código ao atendente.

## Boas práticas e cuidados

- Use o mesmo nome de variável em todos os pontos que precisam do protocolo.
- Evite gerar códigos excessivamente longos para reprodução por voz.
- Executar o node novamente na mesma chamada reaproveita o protocolo existente.

## Como testar

1. Faça uma chamada e confirme a quantidade de dígitos.
2. Reproduza ou destaque a variável em um node posterior.
3. Passe pelo node duas vezes e confirme que o código não muda na mesma ligação.

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)