> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Pré-requisitos para ligações pelo WhatsApp na Groner

# Pré-requisitos para ligações pelo WhatsApp na Groner

Saiba o que seu número precisa ter para receber e atender chamadas de voz do WhatsApp pela Groner.

**Atualizado em 6 de outubro de 2026.**

Este artigo trata da conexão oficial do WhatsApp, pela **Cloud API da Meta**. Conexões por outros provedores têm recursos e condições diferentes.

## O que está disponível hoje?

Na integração oficial da Meta, a Groner permite **atender chamadas de voz iniciadas pelo cliente**, com áudio pelo navegador.

**Iniciar uma chamada de voz para o cliente pela conexão oficial da Meta ainda não está disponível na implementação atual da Groner.** A documentação da Meta descreve também chamadas iniciadas pela empresa, mas habilitar o número não libera automaticamente essa função na Groner.

## 1. Ter um número conectado à Cloud API da Meta

O número da empresa precisa estar cadastrado e conectado à Groner pela **API oficial da Meta**.

Ter o aplicativo WhatsApp Business instalado ou conseguir enviar mensagens por outra modalidade de conexão não significa que o número atende aos requisitos da Calling API.

Se você não souber qual conexão utiliza, confira as configurações do número no GronerZap ou peça essa confirmação ao suporte.

## 2. O número não pode estar em coexistência

Para esse recurso, o número precisa estar em **uso dedicado à Cloud API**, sem continuar vinculado ao aplicativo WhatsApp Business do celular.

O modo **coexistência** permite usar mensagens pelo aplicativo e pela API com o mesmo número. Porém, esse modo não atende ao pré-requisito de chamadas considerado pela integração atual da Groner.

Quando a Groner identifica coexistência, a opção de habilitar ligações fica desabilitada e apresenta o motivo.

**Não basta ativar uma opção na tela para sair da coexistência.** É necessário avaliar a migração do número para o modo dedicado. Essa mudança afeta o uso do WhatsApp Business no celular; alinhe o procedimento com o suporte antes de alterar o cadastro do número.

## 3. Ter limite de mensagens de pelo menos 2.000 destinatários únicos por dia

A Meta exige que a empresa tenha um **limite diário de mensagens de, no mínimo, 2.000 destinatários únicos** para habilitar a Calling API.

Esse requisito se refere à **capacidade de envio liberada pela Meta**:

- Não significa que você precisa enviar 2.000 mensagens por dia.
- Não significa ter 2.000 contatos cadastrados na Groner.
- Não é uma franquia de 2.000 ligações.

Confira o limite da empresa no gerenciamento do WhatsApp na Meta. Se estiver abaixo do mínimo, será necessário atender às condições da Meta para ampliar essa capacidade. A Groner não altera esse limite por conta própria.

## 4. Habilitar ligações no número

As chamadas **não ficam habilitadas automaticamente** apenas porque o número já envia e recebe mensagens.

Na Groner:

1. Abra o GronerZap e acesse as configurações do número conectado pela Meta.
2. Localize a seção **Ligações**.
3. Ative **Habilitar ligações neste número**.
4. Aguarde a confirmação de que as ligações foram habilitadas.

Se a ativação falhar, verifique a mensagem exibida. Coexistência ou falta de elegibilidade na Meta não são resolvidas repetindo a tentativa.

## 5. Ter as permissões e os eventos da Meta configurados

Além da ativação do número, a integração técnica precisa estar preparada para receber as chamadas. O aplicativo da Meta utilizado na conexão deve:

- Estar inscrito na conta do WhatsApp Business à qual o número pertence.
- Ter a permissão **`whatsapp_business_messaging`** para o número.
- Estar inscrito no campo **`calls`** dos webhooks, utilizado pela integração da Groner para receber os eventos de chamadas.

**Ativar ligações no número e configurar os eventos são etapas diferentes.** O número pode estar habilitado, mas a chamada não aparecer na Groner se os eventos não estiverem configurados corretamente.

Essa verificação deve ser feita por quem administra a integração com a Meta. Se você não tem acesso a essa configuração, solicite ajuda ao suporte da Groner.

## 6. Preparar o navegador e o áudio do atendente

Para atender pelo computador, confira se:

- O GronerZap está aberto e conectado à conta correta.
- O computador tem microfone e saída de áudio funcionando.
- O navegador tem permissão para usar o microfone no endereço da Groner.
- A conexão de internet está estável.

Recomendamos utilizar um headset para reduzir eco e ruído. Ao receber a chamada, clique em **Atender** e autorize o acesso ao microfone, se o navegador solicitar.

Se a empresa utiliza restrições de rede, a equipe de TI pode precisar verificar se a comunicação de áudio pelo navegador está sendo bloqueada.

## Checklist antes de testar

- [ ] O número utiliza a conexão oficial da Meta na Groner.
- [ ] O número está no modo dedicado à Cloud API, sem coexistência.
- [ ] A empresa tem limite de mensagens de pelo menos 2.000 destinatários únicos por dia na Meta.
- [ ] As ligações estão habilitadas nas configurações do número.
- [ ] As permissões e a inscrição nos eventos `calls` foram conferidas.
- [ ] O atendente está com o GronerZap aberto, microfone permitido e áudio funcionando.

Com tudo pronto, peça a um contato para **ligar pelo WhatsApp para o número da empresa** e teste o atendimento na Groner.

## Dúvidas frequentes

### Meu número envia mensagens normalmente. Por que não recebe ligações na Groner?

Mensagens e chamadas têm requisitos diferentes. Confira a modalidade de conexão, a coexistência, o limite de mensagens, a habilitação de ligações e os eventos da Meta.

### Preciso sair do WhatsApp Business do celular?

Para utilizar este fluxo de chamadas da API oficial, o número precisa estar dedicado à Cloud API. Se ele está em coexistência, peça ao suporte orientação sobre a migração e seus impactos antes de fazer qualquer mudança.

### Já habilitei, mas a chamada não aparece. O que verificar?

Confirme a inscrição no evento `calls`, a associação do aplicativo à conta WhatsApp Business e as permissões da integração. Essas configurações são separadas da opção **Habilitar ligações**.

### A chamada aparece, mas não tem áudio. O que verificar?

Confira a permissão de microfone, o dispositivo de áudio selecionado, o volume e a conexão de internet. Se persistir, informe ao suporte o navegador utilizado, o horário da tentativa e se o problema acontece para ouvir, falar ou ambos.

### Posso usar a documentação da Meta para liberar chamadas de saída na Groner?

A Meta oferece recursos que dependem de implementação na plataforma utilizada. Na Groner, o fluxo atual da conexão oficial contempla o atendimento de chamadas recebidas; a discagem de chamadas de voz por essa conexão ainda não está disponível.

## Precisa de ajuda?

Envie ao suporte da Groner o nome da conta, o número conectado, a modalidade de conexão e a mensagem de erro exibida. Se possível, inclua uma captura da seção **Ligações** e o horário da tentativa.

Não envie senhas nem tokens de acesso.

## Documentação de referência

- [Meta — Calling API: pré-requisitos](https://developers.facebook.com/documentation/business-messaging/whatsapp/calling#step-1--prerequisites)
- [Meta — Configurações de chamadas](https://developers.facebook.com/documentation/business-messaging/whatsapp/calling/call-settings)
- [Meta — Limites de mensagens](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)

<!-- groner-suporte:veja-tambem:inicio -->

## Veja também

- [Como ativar o Gronerzap (Novo)](https://ajuda.groner.app/pt-br/article/como-ativar-o-gronerzap-novo-3pd7wj/)
- [Guia do GronerZap: API oficial do WhatsApp e conexão por QR Code](https://ajuda.groner.app/pt-br/article/guia-do-gronerzap-api-oficial-do-whatsapp-e-conexao-por-qr-code-775y6e/)
- [Por que a API da Meta informa que o número conectado é inválido?](https://ajuda.groner.app/pt-br/article/por-que-a-api-da-meta-informa-que-o-numero-conectado-e-invalido-1r84qp9/)

<!-- groner-suporte:veja-tambem:fim -->