> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-voz/configurando-o-whatsapp-calling-dentro-do-voz.md).
# Configurando o WhatsApp Calling dentro do Voz
Dentro do ecossistema de voz, a sua primeira ação estratégica para habilitar o recebimento de chamadas é estruturar os caminhos de entrada e saída telefônica por meio do cadastro de uma operadora dedicada.
## Configuração de Rotas
### Cadastro de operadora
Para iniciar o mapeamento, você deve clicar na opção **"Rotas"** localizada no menu lateral esquerdo da plataforma, conforme indicado na imagem. Na área central, role a página até encontrar a aba inferior chamada **"Operadoras"**.
Para abrir o formulário de cadastro, vá até a extremidade direita dessa mesma seção e clique no ícone de **“+”**.
Ao acessar a tela de cadastro, a plataforma exibirá o painel para adicionar a operadora. Você deve preencher as informações exigidas interagindo com os seguintes campos estruturados:
**Nome**: Defina um nome identificador de sua preferência para registrar a operadora no sistema (campo livre).
**Protocolo**: Clique no menu suspenso (dropdown) e selecione especificamente a opção **WhatsApp Calling**. Ao realizar essa marcação, a interface se adaptará automaticamente, ocultando parâmetros desnecessários e mantendo visíveis apenas os campos obrigatórios para o fluxo de telefonia da Meta.
**Número de telefone**: Digite o número de telefone exato que foi configurado e validado no WhatsApp da sua empresa direto pelo painel do Channel Connect.
**Senha**: Insira a mesma senha de autenticação que foi gerada e estabelecida no Channel Connect para o respectivo número de telefone.
Após preencher os campos, clique em Salvar para concluir o cadastro da operadora.
### Rotas de entrada
Para garantir que as ligações telefônicas iniciadas pelos clientes no WhatsApp sejam corretamente interceptadas e encaminhadas pelo Voz, você deve estruturar uma rota de entrada dedicada. Essa configuração dita para onde a chamada será direcionada assim que atingir a plataforma.
Para acessar este painel, permaneça na tela **"Rotas"** (menu lateral esquerdo). Localize o primeiro bloco superior do gerenciador, chamado **"Entrada"**. Na extremidade direita dessa divisória, clique no botão de adição **(“+”)** para abrir a gaveta lateral de cadastro.
A interface abrirá o formulário **"Adicionar rota de entrada"**, você deve preencher os campos estruturados de forma sequencial:
**Nome:** Digite uma identificação livre e clara para documentar o propósito dessa rota de entrada no painel (*Ex: Entrada\_Calling\_WhatsApp*).
**Operadora**: Abra o menu suspenso e selecione a operadora do tipo WhatsApp Calling que você cadastrou no passo anterior do manual.
**Priorização de agente (opcional)**: Ative esta opção caso deseje priorizar o direcionamento das chamadas para um agente específico ou seguir a estratégia de distribuição configurada para a operação. Quando desabilitada, o sistema utilizará o fluxo padrão de distribuição definido para a equipe. Essa configuração é opcional e deve ser utilizada apenas quando houver necessidade de personalizar a entrega das chamadas.
**DDR:** Informe o número de telefone completo vinculado ao WhatsApp da sua empresa. Utilize o mesmo número homologado e configurado no **Channel Connect** para utilização do **WhatsApp Calling).**
**Tipo de destino**: Escolha para qual destino a chamada telefônica receptiva será entregue. Para direcionar o fluxo de áudio diretamente para a sua operação viva, mude o seletor para a opção "**Equipe**".
**Seleção de destino (grade de pesquisa)**: Caso tenha escolhido o destino por Equipe, utilize a barra de pesquisa interna que será exibida para localizar e marcar a caixa de seleção correspondente à equipe de atendimento responsável por receber as ligações desse número.
**Mensagem de áudio / TAGs**: Campos avançados para vincular arquivos de áudio de atendimento ou aplicar marcadores de controle nos logs internos.
Após a validação visual de todos os campos do formulário contextualizado, clique no botão azul **"Salvar"** no canto inferior direito para ativar as diretrizes de recebimento e gravar a rota de entrada no banco de dados.
### Rotas de saída
Para permitir a realização de chamadas ativas ou disparar contatos através do recurso de chamadas integradas, torna-se obrigatório parametrizar uma rota de saída no sistema. Esta configuração determina os critérios e formatos de discagem aceitos para direcionar o tráfego outbound de voz para a operadora correta.
Para acessar este painel de infraestrutura, permaneça no menu principal **"Rotas"**, localizado na barra lateral esquerda da interface. Role a tela até localizar a seção **"Saída".** Na extremidade direita dessa seção, clique no ícone de **adição ("+")** para abrir o formulário de cadastro da rota de saída.
A interface carregará a tela **"Adicionar rota de saída"**, detalhada na imagem abaixo.
Preencha os parâmetros respeitando os seguintes critérios de campo:
**Nome**: Forneça um termo identificador claro para o mapeamento da rota no painel (campo livre, ex: *Saida\_Calling\_WhatsApp*).
**Origem:** Defina quais ramais ou agentes podem iniciar chamadas por este canal. O preenchimento padrão com a expressão universal X. indica liberação para qualquer ramal interno da conta efetuar chamadas.
**Formato do número**: Estabeleça a máscara de discagem e o padrão numérico aceito para o roteamento. Para o tráfego móvel direcionado ao WhatsApp Calling, o formato deve seguir a estrutura de numeração internacional 55XX9XXXXXXXX.
{% hint style="info" %}
**## Informação**
\
Os campos **Origem** e **Formato** do número precisam seguir as Regras de Discagem. Essas regras são utilizadas pela plataforma para criar expressões regulares (padrões lógicos) de telefonia baseadas no padrão Asterisk/PBX.
Elas servem para validar quais números de ramal ou padrões de telefone de destino estão autorizados a usar essa rota. Aqui está a explicação prática de cada uma das três regras descritas na imagem:
#### Explicação Prática das Regras
\
**X : Permite dígitos entre 0-9.**
\
**O que significa:** A letra X é um caractere universal (placeholder) que representa **um único dígito numérico** qualquer de 0 a 9.
**Exemplo**: Se no campo de origem você configurar 10X, a rota aceitará qualquer ramal de 100 a 109. No caso do preenchimento padrão X. que vimos no tutorial, ele indica o uso desse padrão numérico associado ao sequenciador.\
\
**\[1237-9]: Permite os números "1, 2, 3, 7, 8 e 9".**
**O que significa**: Os colchetes \[ ] definem um **conjunto ou intervalo fechado** de opções válidas para uma única posição do número. Os números listados individualmente (123) são lidos de forma literal, e o hífen (7-9) estipula o intervalo sequencial (7, 8 e 9).
**Exemplo:** Se a sua empresa só permite que ramais iniciados com 1, 2, 3, 7, 8 ou 9 façam ligações ativas para o WhatsApp, você usaria essa estrutura para bloquear os ramais iniciados com 4, 5 ou 6.
\
**. (Ponto): Permite um ou mais dígitos.**
**O que significa:** O ponto funciona como um caractere curinga de **continuidade**. Ele diz ao sistema: "não importa quantos dígitos venham a partir daqui, se houver um ou mais números na sequência, a rota está autorizada".
\
**Exemplo prático do X**.: Ao preencher a origem apenas com X., você está dizendo que a rota aceita qualquer ramal de **qualquer tamanho** (pois exige um dígito inicial X de 0-9 seguido por qualquer quantidade de números.).
{% endhint %}
**Grupo de horário**: Menu suspenso opcional para associar a atividade da rota a uma tabela de janelas de atendimento cadastradas.
**Seletor de prioridade (Canal de Voz)**: No canto superior direito da tela, clique no seletor com o ícone de telefone para abrir a listagem de mídias e **selecione o ícone do WhatsApp**. Ativar esta marcação garante que a plataforma priorize esta rota de saída sempre que a operação acionar o recurso de Click to Call.
**Bloco Principal (Operadora**): Na linha identificada como "**PRINCIPAL**", acesse o menu de seleção de operadoras e marque a conexão de tipo *WhatsApp Calling* que você cadastrou inicialmente no início deste manual. Os campos adjacentes de remoção e inserção de dígitos iniciais servem para tratativas automáticas de prefixos telefônicos se houver necessidade de conversão de regras de discagem.
**Operadora**: Menu suspenso *(dropdown)* para selecionar a operadora por onde a chamada será escoada (no nosso fluxo, selecione a operadora *WhatsApp Calling*).
**Remover dígitos iniciais**: Quantidade de dígitos que o sistema deve apagar logo no começo do número discado.
**Posição inicial da remoção**: Indica a partir de qual posição da string o corte numérico começará a ser executado.
**Quantidade de dígitos a remover**: Quantidade de números que serão eliminados a partir da posição inicial definida.
**Adicionar dígitos antes**: Insere um prefixo ou código específico antes do número discado (útil para adicionar códigos de país ou operadora automaticamente).
**Adicionar dígitos depois:** Insere números ao final da string discada.
**Resultado:** Campo de leitura automatizado que exibe uma prévia visual de como o número final será entregue à operadora após aplicar todas as regras de manipulação descritas acima.
{% hint style="warning" icon="lightbulb-exclamation-on" %}
**## Dica**
Para garantir que a manipulação ocorra perfeitamente e o **Resultado** seja entregue como 5548999561378, os campos do Bloco Principal devem ser preenchidos da seguinte forma:
1. **Operadora**: \[*Selecione a sua Operadora WhatsApp Calling*]
2. **Remover dígitos iniciais:** 0 (*Não precisamos cortar nada do início caso o símbolo "+" seja tratado como caractere especial, mas se o agente discar o "+", configuramos o tratamento abaixo*).
3. **Posição inicial da remoção**: 1 (*O sistema começará a analisar a partir do primeiro caractere*).
4. **Quantidade de dígitos a remover**: 1 (*Se o agente discar o caractere "+", ele será removido nesta posição, deixando apenas a sequência numérica limpa*).
5. **Adicionar dígitos antes**: (*Deixe em branco, pois o número já possui o código do país 55 e o DDD 48*).
6. **Adicionar dígitos depois**: (*Deixe em branco)*.
7. **Resultado**: 5548999561378 (*O painel exibirá o número limpo e pronto para a Meta*).
{% endhint %}
Uma vez concluído o preenchimento dos campos lógicos e estruturada a linha principal da operadora Meta, clique no botão azul **"Salvar"**, localizado no canto inferior direito, para registrar a regra de saída e integrá-la ao sistema.
### Associando as rotas a equipe
O último passo dentro do módulo de Voz é conceder à equipe a permissão para utilizar a rota de saída criada. Essa associação é necessária para que os atendentes possam realizar **chamadas ativas** por meio do WhatsApp Calling. O recebimento de chamadas já foi definido durante a configuração da **rota de entrada**, no momento em que a equipe foi selecionada.
Clique na opção "**Equipes**" localizada no menu lateral esquerdo, conforme indicado na imagem.
A plataforma exibirá a listagem das equipes cadastradas em formato de cartões visuais (*cards*).
Identifique o card da equipe na qual deseja configurar o recurso (como a *Equipe de Vendas*). Vá até o canto superior direito desse cartão, clique no menu de opções (ícone de três linhas horizontais) e selecione o botão flutuante "**Editar**" (representado pelo ícone do lápis).
Ao clicar no botão de edição, o sistema carregará a tela "**Editar equipe**". Nesta área de gerenciamento, localize a terceira coluna interna, denominada "**Permissão de discagem**".
No canto superior direito desta seção específica, clique no **ícone do lápis** (Editar).
O sistema abrirá a janela modal suspensa "**Adicionar permissão de discagem**". Use o campo de texto "**Pesquisar**" ou navegue pela listagem para encontrar o nome da nova rota de saída criada para o *WhatsApp Calling*.
Ao localizar a rota correspondente, mude a chave de seleção (*toggle*) na coluna "**Ativar**" para a posição ligada (mudar a cor cinza padrão para o status ativo).
Clique no botão azul "**Salvar**", localizado no canto inferior direito do modal, para confirmar a alteração no banco de dados.
Por fim, após o fechamento do modal e o retorno à tela principal de edição de equipes, lembre-se de clicar no botão azul "**Salvar**" posicionado na extremidade inferior direita do painel geral. Esta ação consolida definitivamente as novas regras de discagem para o grupo, finalizando toda a esteira de configuração no módulo Fortics Voz.
### Resultado esperado
Ao concluir este procedimento você terá:
✔ Operadora cadastrada;
✔ Rota de entrada criada;
✔ Rota de saída criada;
✔ Equipe autorizada para realizar chamadas.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/fortics-voz/configurando-o-whatsapp-calling-dentro-do-voz.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.