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
✔️ 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
Enviar mensagens em nome do WABA
✔ Acesso total ao Business Manager
Itens financeiros necessários para o WABA
✔ Acesso administrativo aos ativos 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_messaging
whatsapp_business_management
E precisa estar autorizado dentro:
Configurações de Negócio → Contas → Contas do WhatsApp → Aplicativos
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
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 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.
Envie uma mensagem de teste no SAC 360º, com um template aprovado.
Se não aparecer erro → integração 100% funcionando
