# 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-05-28T23:48:05.983Z

## Página

- Título: Vínculo do Fluxo de Telefonia no Número de Entrada
- URL humana: https://agilize.app/docs/configuracao/telefonia/vinculo-fluxo-telefonia-numero-entrada
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como definir o destino de um número de entrada para executar fluxo avançado, fila, ramal, URA ou outro caminho de telefonia.

## Seções

- Onde configurar
- Campos do número de entrada
- Tipos de destino disponíveis
- Quando escolher fluxo avançado
- Sequência recomendada
- Cuidados antes de salvar
- Teste recomendado
- Problemas comuns

## Conteúdo da página

# Vínculo do Fluxo de Telefonia no Número de Entrada

O número de entrada é a porta por onde a chamada chega à operação. O destino configurado nele define qual regra será executada primeiro: um fluxo avançado, uma fila, uma URA, um ramal ou outro destino de telefonia.

Esse vínculo é crítico. Um número com destino errado pode mandar clientes para a fila incorreta, pular uma URA, ignorar regras de horário ou executar um fluxo antigo.

---
title: "Entrada da chamada"
caption: "O número recebe a ligação e envia para o primeiro destino configurado."
definition: |
  flowchart LR
    A[Cliente liga para o número] --> B[Número de entrada]
    B --> C{Destino configurado}
    C -->|Fluxo avançado| D[Executar regras do fluxo de voz]
    C -->|Fila| E[Distribuir para ramais da fila]
    C -->|URA| F[Tocar menu e aguardar opção]
    C -->|Ramal| G[Chamar pessoa ou posição específica]
    D --> H[Encaminhar, coletar opção, gerar protocolo ou encerrar]
    E --> I[Monitoramento e atendimento]
    F --> I
    G --> I
---

## Onde configurar

Acesse [https://my.agilize.app/voice/did](https://my.agilize.app/voice/did).

Para criar ou ajustar o fluxo avançado que será usado como destino, acesse [https://my.agilize.app/voice/flow](https://my.agilize.app/voice/flow).

## Campos do número de entrada

| Campo | Como usar |
| --- | --- |
| Número de Entrada | Número telefônico que recebe chamadas. |
| Destino Ligação de Entrada | Primeiro destino executado quando alguém liga para o número. |

O destino é escolhido em dois passos: tipo de destino e item específico. Depois de salvar, a chamada recebida passa a seguir esse destino.

## Tipos de destino disponíveis

| Tipo | Quando usar |
| --- | --- |
| Ramal | Direcionar todas as chamadas para uma pessoa ou posição específica. |
| Fila | Distribuir chamadas entre vários agentes. |
| URA | Tocar um menu simples por opções de teclado. |
| Horário de Funcionamento | Separar comportamento dentro e fora do expediente. |
| Telefone Rede Telefonia | Encaminhar para outro destino telefônico cadastrado. |
| Sala de Conferência | Enviar para uma conferência. |
| Terminar Ligação | Encerrar a chamada de forma controlada. |
| Fluxo Avançado | Executar uma jornada de telefonia com regras, nós, URA, filas, condições e integrações. |

## Quando escolher fluxo avançado

Escolha **Fluxo Avançado** quando a entrada precisa de mais do que um encaminhamento direto.

Exemplos:

- tocar mensagem inicial e avaliar horário;
- oferecer URA por opções;
- encaminhar para filas diferentes por escolha do cliente;
- gerar protocolo;
- chamar webhook;
- normalizar telefone;
- criar ou atualizar entidade;
- enviar mensagem WhatsApp depois de uma ligação;
- encerrar com mensagem falada.

Fluxo avançado é o melhor caminho quando a chamada precisa de uma jornada. Fila ou ramal são melhores quando o destino é simples e direto.

## Sequência recomendada

1. Crie ou revise ramais em [https://my.agilize.app/voice/pbx/extension](https://my.agilize.app/voice/pbx/extension).
2. Crie as filas necessárias em [https://my.agilize.app/voice/pbx/queue](https://my.agilize.app/voice/pbx/queue).
3. Crie URAs simples quando precisar de menus diretos em [https://my.agilize.app/voice/pbx/ivr](https://my.agilize.app/voice/pbx/ivr).
4. Crie o fluxo avançado em [https://my.agilize.app/voice/flow](https://my.agilize.app/voice/flow), quando a entrada precisar de regras.
5. Abra o número em [https://my.agilize.app/voice/did](https://my.agilize.app/voice/did).
6. Selecione o destino correto.
7. Salve e faça chamada de teste.
8. Valide o caminho no [Monitoramento de Telefonia](/docs/usuarios/transmissoes-e-telefonia/monitoramento-de-telefonia).

## Cuidados antes de salvar

- Confirme se o destino selecionado está ativo e foi testado.
- Evite apontar número de produção para fluxo em rascunho.
- Revise nomes parecidos de filas, URAs e fluxos.
- Confirme o comportamento fora do horário de atendimento.
- Valide se o destino de timeout existe.
- Tenha um plano de reversão para voltar ao destino anterior se o teste falhar.

## Teste recomendado

Faça pelo menos estes testes:

| Teste | Resultado esperado |
| --- | --- |
| Ligação normal | A chamada entra no destino escolhido. |
| Opção principal | O cliente chega à fila, ramal ou caminho correto. |
| Sem digitar opção | O timeout segue para o destino configurado. |
| Fora do horário | O fluxo aplica a regra esperada, quando houver. |
| Fila sem agente | A chamada segue a regra de fila e destino de exceção. |
| Monitoramento | A chamada aparece na fila ou ramal esperado. |

## Problemas comuns

| Sintoma | Causa provável | Como corrigir |
| --- | --- | --- |
| Número toca, mas não chega à fila correta | Destino de entrada antigo ou fila errada selecionada. | Edite o número e revise o destino. |
| URA não toca | Número aponta para fila ou ramal, não para URA/fluxo. | Ajuste o destino do número. |
| Fluxo não executa caminho esperado | Fluxo escolhido não é o correto ou está incompleto. | Revise o fluxo avançado e faça novo teste. |
| Chamada fica sem saída | Timeout ou destino de remoção não configurado. | Configure destino de exceção no fluxo, URA ou fila. |

## Guias relacionados

- [Cadastro de filas de telefonia](/docs/configuracao/telefonia/cadastro-de-filas-telefonia)
- [Cadastro de ramais](/docs/configuracao/telefonia/cadastro-de-ramais)
- [Cadastro de URA](/docs/configuracao/telefonia/cadastro-de-ura)
- [Monitoramento de Telefonia](/docs/usuarios/transmissoes-e-telefonia/monitoramento-de-telefonia)