Guia Completo: Meta Provedor
Documentação oficial Meta explicada tópico a tópico. Do ecossistema ao programa de parceria oficial.
Ecossistema Meta
A Meta (antiga Facebook Inc.) é dona de 4 plataformas principais de comunicação, cada uma com bilhões de usuários:
A Meta oferece um conjunto de ferramentas business que conectam tudo:
A Meta tem 3 produtos de mensageria para empresas, cada um com API própria:
| Produto | API | Uso Principal |
|---|---|---|
| WhatsApp Business Platform | Cloud API / On-Premise API | Atendimento, notificações, marketing, autenticação |
| Messenger Platform | Send API / Handover Protocol | Bots no Facebook Messenger, atendimento |
| Instagram Messaging API | Instagram Graph API | DMs do Instagram, automação de respostas |
A Meta organiza tudo em uma hierarquia. Entender isso é fundamental pra não se perder:
Meta Business Manager
O Meta Business Manager (agora chamado "Meta Business Portfolio") é a ferramenta central para gerenciar todos os ativos business da Meta. É como o "painel de controle" da sua operação.
Dentro dele você gerencia:
URL: business.facebook.com
Passo a passo para criar o Business Manager da sua empresa:
No Business Manager, tudo são "ativos" (assets) que você pode gerenciar, compartilhar ou receber de outros BMs:
| Ativo | Descrição | Limite |
|---|---|---|
| Páginas | Páginas do Facebook | Sem limite |
| Contas de Anúncio | Para rodar ads | Até 25 por BM |
| WABAs | WhatsApp Business Accounts | Depende do nível de verificação |
| Apps | Aplicações no Meta Developers | Sem limite |
| Pixels | Tracking de conversão | Até 100 por BM |
| Catálogos | Produtos para Commerce | Sem limite |
Compartilhamento de ativos: Um provedor pode receber acesso a ativos de clientes (ex: o cliente compartilha a WABA com o provedor, sem transferir propriedade).
O Business Manager tem um sistema robusto de permissões:
| Cargo | Pode fazer |
|---|---|
| Admin | Tudo: adicionar pessoas, gerenciar ativos, verificar empresa, configurar pagamentos |
| Employee | Acessar ativos atribuídos, trabalhar nas tarefas designadas |
Além do cargo no BM, cada ativo tem permissões próprias:
Configurações importantes que todo provedor precisa conhecer:
Verificação de Empresa na Meta
A Meta Business Verification é o processo que confirma que sua empresa é real e legítima dentro do ecossistema Meta. É obrigatória para:
Existem 3 caminhos para verificar uma empresa na Meta:
| Método | Escopo | Quando Usar | Tempo |
|---|---|---|---|
| Partner-Led Business Verification (PLBV) | Só WhatsApp | Provedor verifica o cliente diretamente | 5 min a 48h |
| Standard Business Verification | Facebook + Instagram + WhatsApp | Verificação completa, feita pelo próprio BM | Até 14 dias úteis |
| Meta Verified for Business | Todas plataformas | Assinatura paga com selo verificado + suporte premium | 1-3 dias úteis |
A Meta aceita documentos específicos por país. No Brasil, os documentos aceitos são:
• O nome no documento é EXATAMENTE igual ao do Business Manager?
• O endereço bate com o cadastrado?
• O documento está legível e atualizado (menos de 12 meses)?
• O CNPJ está ativo na Receita Federal?
• O documento está em PDF claro, sem cortes?
Fluxo completo da Standard Business Verification:
Os 10 motivos mais comuns de rejeição na verificação:
Nova opção da Meta (lançada em 2024): assinatura paga que oferece:
Aprovação em 1-3 dias úteis. Custo mensal varia por região. É diferente da verificação gratuita — é um upgrade opcional.
WhatsApp Business Platform
A WhatsApp Business Platform é a solução empresarial da Meta para comunicação em escala via WhatsApp. Diferente do app WhatsApp Business (gratuito, para pequenos negócios), a plataforma é para:
Componentes principais:
| Componente | Função |
|---|---|
| Cloud API | API hospedada pela Meta — enviar/receber mensagens |
| Business Management API | Gerenciar WABAs, templates, números |
| Webhooks | Receber notificações de mensagens e status |
| Flows | Formulários interativos dentro do WhatsApp |
A Meta oferece duas formas de acessar a API do WhatsApp:
| Aspecto | Cloud API ☁️ | On-Premise API 🖥️ |
|---|---|---|
| Hospedagem | Servidores da Meta | Seu próprio servidor |
| Custo de infra | Zero (Meta hospeda) | Você paga servidor |
| Setup | Minutos | Horas/dias |
| Escalabilidade | Automática (Meta cuida) | Manual (você escala) |
| Throughput | 80 msgs/segundo | Até 500+ msgs/segundo |
| Mídia | Até 100MB | Até 64MB |
| Status | ✅ Recomendada pela Meta | ⚠️ Em descontinuação |
Passo a passo para começar com a Cloud API:
Existem 3 tipos de token na API do WhatsApp:
| Tipo | Duração | Uso |
|---|---|---|
| Temporary Token | 24 horas | Teste rápido no API Explorer |
| System User Token | Permanente (até revogar) | Produção — o que você vai usar |
| User Token | Variável | Login do desenvolvedor — não usar em produção |
Como gerar o token permanente:
Todas as mensagens são enviadas via POST para o endpoint:
POST https://graph.facebook.com/v21.0/{phone_number_id}/messages
Headers obrigatórios:
Authorization: Bearer {token}Content-Type: application/jsonO corpo da mensagem varia por tipo — texto, imagem, template, botão, lista, etc.
A Cloud API suporta diversos tipos de conteúdo:
| Tipo | Descrição | Quando usar |
|---|---|---|
| text | Mensagem de texto simples | Respostas, informações |
| image | Imagem (JPEG, PNG) | Fotos de produto, comprovantes |
| document | Documento (PDF, DOC) | Contratos, boletos, NF |
| audio | Áudio (MP3, OGG) | Mensagens de voz |
| video | Vídeo (MP4) | Tutoriais, demos |
| location | Localização (lat/long) | Endereço de loja |
| contacts | Cartão de contato | Compartilhar dados |
| interactive | Botões e listas | Menus, opções |
| template | Templates pré-aprovados | Iniciar conversa, marketing |
| reaction | Reação com emoji | Reagir a mensagem |
| sticker | Figurinha (WebP) | Interação visual |
Templates de Mensagem
Templates são mensagens pré-aprovadas pela Meta que permitem à empresa iniciar uma conversa com o cliente. São obrigatórios para:
A Meta classifica templates em 3 categorias (cada uma com preço diferente):
| Categoria | Descrição | Exemplos | Preço BR (aprox.) |
|---|---|---|---|
| 🟢 Utility | Relacionado a transação existente | Confirmação de pedido, status de entrega, recibo | ~R$ 0,05/msg |
| 🟡 Authentication | Verificação de identidade | Código OTP, verificação de login, 2FA | ~R$ 0,04/msg |
| 🔴 Marketing | Promoções e engajamento | Ofertas, cupons, carrinho abandonado, novidades | ~R$ 0,10/msg |
Fluxo para criar um template:
Tempo de aprovação: Geralmente minutos a algumas horas. Em casos raros, até 24h. Templates rejeitados podem ser editados e resubmetidos.
Templates suportam variáveis dinâmicas — placeholders que você preenche na hora do envio:
Componentes do template:
| Componente | Obrigatório | Tipos |
|---|---|---|
| Header | Não | Texto, Imagem, Vídeo, Documento |
| Body | Sim | Texto (com variáveis) |
| Footer | Não | Texto pequeno (máx 60 chars) |
| Buttons | Não | CTA (URL, telefone), Quick Reply (até 3) |
Webhooks e Eventos
Webhooks são URLs do seu servidor que a Meta chama automaticamente quando algo acontece (mensagem recebida, mensagem entregue, etc.).
É a forma como você "escuta" o WhatsApp — sem webhook, você envia mas não recebe.
Dois tipos principais de notificação via webhook:
| Tipo | Quando | Dados |
|---|---|---|
| messages | Cliente envia mensagem | Texto, imagem, áudio, vídeo, documento, localização, contato, reação, botão clicado |
| statuses | Status de mensagem enviada | sent, delivered, read, failed + pricing info |
Quando você envia uma mensagem, recebe callbacks de status progressivos:
Cada status vem com o message ID original, permitindo rastrear cada mensagem.
A Meta assina cada webhook com um X-Hub-Signature-256 header. Você deve:
Modelo de Pricing da Meta
Desde julho de 2025, a Meta cobra por mensagem individual (não mais por conversa de 24h). Cada template enviado = 1 cobrança.
| Categoria | Preço por Mensagem (BRL aprox.) | Quando cobrado |
|---|---|---|
| 🟢 Service | GRÁTIS | Dentro da janela 24h, em resposta ao cliente |
| 🔵 Utility | ~R$ 0,05 | Cada template utility enviado e entregue |
| 🟡 Authentication | ~R$ 0,04 | Cada OTP/código enviado e entregue |
| 🔴 Marketing | ~R$ 0,10 | Cada template marketing enviado e entregue |
A Meta oferece janelas gratuitas de 72 horas quando o cliente vem de um "free entry point":
Quando o cliente clica e envia a primeira mensagem:
Quando um cliente envia uma mensagem pra sua empresa, abre uma janela de serviço de 24 horas:
Principais mudanças desde 1º de julho de 2025:
Quality Rating e Messaging Tiers
A Meta atribui um quality rating (nota de qualidade) a cada número de telefone. É baseado no feedback dos últimos 24h:
| Rating | Significado | Impacto |
|---|---|---|
| 🟢 Green (High) | Usuários não reportam spam | Pode subir de tier |
| 🟡 Yellow (Medium) | Alguns reports de spam | Não sobe de tier, atenção |
| 🔴 Red (Low) | Muitos blocks/reports | Impede subida, pode restringir |
Como a Meta mede: As mensagens são criptografadas, então a Meta usa sinais indiretos: "reportar spam", "bloquear número", taxa de resposta dos destinatários.
Cada número pode estar em um de dois estados:
O número de templates que você pode enviar por dia é limitado por tiers:
| Tier | Limite Diário | Quando |
|---|---|---|
| TIER_250 | 250 contatos únicos/dia | Início (número novo, não verificado) |
| TIER_1K | 1.000 contatos únicos/dia | Após verificação + volume consistente |
| TIER_10K | 10.000 contatos únicos/dia | Escalando automaticamente |
| TIER_100K | 100.000 contatos únicos/dia | Alto volume, quality alto |
| TIER_UNLIMITED | Sem limite | Máximo nível |
250 → 1.000: Requer verificação da empresa (Business Verification)
1.000 → acima: A Meta escala automaticamente quando:
Exemplo de escala:
Desde outubro 2025, os limites são por portfolio (WABA), não mais por número individual:
Tech Provider Program
O Tech Provider Program é o programa da Meta para ISVs (Independent Software Vendors) que integram WhatsApp em seus produtos e oferecem para clientes.
Se você constrói uma plataforma que conecta empresas ao WhatsApp, você é um Tech Provider.
O Embedded Signup é o fluxo que permite seus clientes conectarem o WhatsApp direto dentro da sua plataforma, sem sair pro Business Manager:
Como provedor, o fluxo de onboarding de um novo cliente é:
Como Tech Provider verificado:
Parceiro Oficial Meta (Performance Accelerator)
O Performance Accelerator é o programa oficial de parceria da Meta para empresas de mensageria business. É o nível acima de Tech Provider:
Parceiros têm acesso ao Meta Partner Portal — plataforma exclusiva com:
A Meta paga parceiros por performance. Os incentivos incluem:
Pagamento via transferência eletrônica, sujeito a câmbio (Bloomberg Rate) e impostos.
MDF são fundos que a Meta disponibiliza para o parceiro investir em marketing:
Regra: Toda atividade com MDF precisa de aprovação prévia da Meta (por escrito/email). Deve seguir o MDF Program Guide.
Como parceiro oficial Meta, você se compromete a: