# 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="/files/ic9sgxYwTR6qBG0aAWT6" 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="/files/4gbTp1HZ9MwN6zRxqsJz" 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


---

# Agent Instructions: 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:

```
GET https://docs.sprinthub.com/topicos/configuracoes/configuracoes-de-contas/whatsapp-api/erros-whatsapp-api-oficial/erro-200-you-do-not-have-the-necessary-permissions-to-send-messages-on-behalf-of-this-whatsapp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.