> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/avancado-recursos-tecnicos/erro-de-autenticacao-no-app-whatsapp-oauth.md).

# Erro de Autenticação no app Whatsapp Oauth

Se ao conectar um número WhatsApp pela API Oficial (via App Techprovider/compartilhado da ZDG) você recebeu a tela de erro **"Erro na autenticação"** com o código `ERR_NO_PERMISSION_CONNECTIONS_LIMIT`, siga este checklist na ordem abaixo.

<figure><img src="/files/GYknE5q0gH88J2ASdhOx" alt="" width="375"><figcaption></figcaption></figure>

***

### Como funciona

Esse erro aparece na etapa de autenticação OAuth, quando o Z-PRO tenta conectar um número à API Oficial usando o **Login Incorporado (Oauth)**. O nome do erro indica uma restrição de **conexões**, não necessariamente uma permissão isolada faltando.

[**Saiba mais sobre o cálculo de Score do APP Tech Provider Compartilhado**](/configuracao-superadmin/tenants-e-licenca/gerenciar-licenca-z-pro/score-do-app-tech-provider.md)

***

### Caso esteja usando o App Tech Provider ZDG: Verifique seu Score (causa mais comum no modo compartilhado)

Quando uma licença acumula números de baixa reputação (amarelos/vermelhos) no App compartilhado da ZDG, ela **perde a permissão de conectar novos números** por esse App — o que gera exatamente um erro de "sem permissão" por limite de conexões.

1. Acesse **Superadmin → Tenants e Licença → Gerenciar Licença → Score do App Tech Provider**.
2. Verifique se a licença está com o **score baixo** (faixa "Alerta" ou "Crítico") ou se aparece algum aviso de **bloqueio de conexão de novos números**.
3. Se estiver bloqueada, siga os passos de **limpeza dos números ruins** e **desbloqueio (cortesia ou manual)** descritos no artigo completo: 👉 Score do App Tech Provider

{% hint style="warning" %}
Se a sua licença estiver saudável (score 90-100, sem bloqueio ativo), esse **não** é o seu caso — siga para a Etapa 2.
{% endhint %}

***

### Caso esteja usando App Próprio: Verifique as permissões do Meta App

Se a licença está com o Score saudável e o erro persiste, confirme a configuração do lado da Meta:

1. Acesse o **Painel do Meta for Developers**, selecione o seu App.
2. Confirme que o **Usuário do Sistema** (ou token) tem, explicitamente, as permissões:
   * `whatsapp_business_management`
   * `whatsapp_business_messaging`

#### Desconecte e reconecte

1. No Z-PRO, desconecte o canal do WhatsApp Cloud afetado.
2. Limpe o cache do navegador.
3. Reautorize a conexão (Cadastro Incorporado / OAuth) do zero, para renovar os tokens e garantir que as permissões acima sejam herdadas corretamente.

#### Verifique o status da WABA

1. Acesse o **Meta Business Suite → WhatsApp Manager**.
2. Confirme que a conta está **verificada**, o número está **ativo** (não restrito/banido) e há um **cartão de crédito válido** vinculado para cobrança das mensagens.

***

### Possíveis Erros e Soluções

#### `ERR_NO_PERMISSION_CONNECTIONS_LIMIT` com licença que já teve números banidos/vermelhos

**Causa:** gate de proteção do Score do App Tech Provider ativo. **Solução:** siga a Etapa 1 — limpar números ruins e desbloquear a licença antes de tentar conectar o número novo novamente.


---

# 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://ajuda.zdg.com.br/avancado-recursos-tecnicos/erro-de-autenticacao-no-app-whatsapp-oauth.md?ask=<question>&goal=<endgoal>
```

`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.