# Erro (#200): “You do not have the necessary permissions to send messages on behalf of this WhatsApp

Esse erro acontece quando a SprintHub tenta enviar mensagens pelo **WhatsApp API**, mas o usuário, o app ou o próprio Business Manager **não possuem todas as permississões exigidas pelo Meta**.

A seguir, todas as causas, soluções e **atribuições necessárias do parceiro SprintHub** para garantir que tudo funcione sem erros.

***

## 🚨 Por que o erro (#200) aparece?

O Meta bloqueia o envio quando qualquer uma dessas permissões está faltando:

1. **Token inválido, expirado ou sem escopos obrigatórios**
2. **Usuário sem controle total do WABA**
3. **Usuário sem controle total do Business Manager (inclusive financeiro)**
4. **Conflito por troca de provedor sem desconectar o anterior**
5. **Parceiro SprintHub sem permissões completas concedidas no BM**
6. **App do WhatsApp API não autorizado na conta**

***

## 🔐 Permissões obrigatórias para tudo funcionar

A integração do WhatsApp API exige **três níveis de permissão**:

***

## ✔️ 1. Permissões do Usuário (que faz a integração)

O usuário que gera o token e conecta o WhatsApp API deve ter:

#### 🟩 **A) Controle total na Conta do WhatsApp (WABA)**

Caminho:\
**Configurações de Negócio → Contas → Contas do WhatsApp → Pessoas**

Permissão exigida:\
\&#xNAN;**✔ Controle total**

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2F7pZhdudQWLnX5139NUGw%2Fimage.png?alt=media&#x26;token=ff69ec91-77ae-4d4c-bbf5-7a3734f05bde" alt=""><figcaption></figcaption></figure>

***

#### 🟩 **B) Controle total no Business Manager (incluindo financeiro)**

Caminho:\
**Configurações de Negócio → Usuários → Pessoas → Permissões do BM**

Permissão exigida:\
\&#xNAN;**✔ Acesso de administrador do Business Manager**\
(incluindo área financeira)

Sem isso, o Meta não autoriza:

* Geração de tokens válidos
* Configuração de provedores
* Permissões avançadas de API
* Gerenciamento do WABA

***

## ✔️ 2. Permissões do Parceiro SprintHub (fundamental!)

A SprintHub é adicionada como **parceira** no Business Manager do cliente.\
Para que a integração funcione sem erro, o parceiro precisa ter as permissões **completas**.

No BM do cliente:

Caminho:\
**Configurações de Negócio → Contas → Parceiros**

Selecione o **parceiro SprintHub** e habilite:

#### 🟦 Permissões obrigatórias do parceiro:

**✔ Controle total sobre a conta do WhatsApp**

* Gerenciar configurações
* Gerenciar números
* Gerenciar templates
* Gerenciar atribuições
* Enviar mensagens em nome do WABA

**✔ Acesso total ao Business Manager**

* Ativos
* Pixels
* Contas
* Integrações
* Itens financeiros necessários para o WABA

**✔ Acesso administrativo aos ativos vinculados**

* Contas do WhatsApp
* Apps vinculados
* Catálogos (se utilizados)

> 🔎 **Importante:**\
> Se o parceiro SprintHub não tiver todas essas permissões, a API simplesmente **não autoriza os envios**, mesmo que o usuário local tenha controle total.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FzX7Syh68nEW16crBNZIO%2Fimage.png?alt=media&#x26;token=32e7dd77-fd74-4069-8bda-60b43ee55259" alt=""><figcaption></figcaption></figure>

***

## ✔️ 3. Permissões do Aplicativo do WhatsApp API

O app que você está usando para gerar o token deve ter:

* `whatsapp_business_messaging`
* `whatsapp_business_management`

E precisa estar autorizado dentro:

**Configurações de Negócio → Contas → Contas do WhatsApp → Aplicativos**

***

## 🔄 Solução rápida: integrar com outro usuário

Se o usuário atual não tem controle total no **BM + WABA**, você pode:

1. Entrar com outro usuário que já é **Administrador do BM**
2. Gerar um token novo
3. Conectar na SprintHub

Isso resolve **na hora**, sem depender de permissões extras.

***

## ✅ Passo a passo para resolver definitivamente

1. **Verifique o provedor na SprintHub**\
   Configurações do sistema → Integrações → WhatsApp API
2. **Gere um token novo com as permissões obrigatórias**
3. **Confirme que o usuário tem:**
   * Controle total no WABA
   * Controle total no Business Manager (incluindo financeiro)
4. **Confirme que o parceiro SprintHub tem TODAS as permissões**
   * Controle total na conta do WhatsApp
   * Acesso total ao Business Manager
   * Acesso administrativo aos ativos
5. **Se houver troca de provedor**
   * Remova completamente o número do provedor antigo antes de integrar o novo.

***

## Teste final

Envie uma mensagem de teste no SAC 360º, com um template aprovado.

Se não aparecer erro → integração 100% funcionando