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:
Token inválido, expirado ou sem escopos obrigatórios
Usuário sem controle total do WABA
Usuário sem controle total do Business Manager (inclusive financeiro)
Conflito por troca de provedor sem desconectar o anterior
Parceiro SprintHub sem permissões completas concedidas no BM
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: ✔ Controle total
🟩 B) Controle total no Business Manager (incluindo financeiro)
Caminho: Configurações de Negócio → Usuários → Pessoas → Permissões do BM
Permissão exigida: ✔ 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.
✔️ 3. Permissões do Aplicativo do WhatsApp API
O app que você está usando para gerar o token deve ter:
whatsapp_business_messagingwhatsapp_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:
Entrar com outro usuário que já é Administrador do BM
Gerar um token novo
Conectar na SprintHub
Isso resolve na hora, sem depender de permissões extras.
✅ Passo a passo para resolver definitivamente
Verifique o provedor na SprintHub Configurações do sistema → Integrações → WhatsApp API
Gere um token novo com as permissões obrigatórias
Confirme que o usuário tem:
Controle total no WABA
Controle total no Business Manager (incluindo financeiro)
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
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
Atualizado
Isto foi útil?