API Oficial do WhatsApp (WABA)
API Oficial WABA
Tudo sobre a API Oficial do WhatsApp (WABA) no sistema: como funciona, formas de conectar, templates HSM, custos Meta e recursos exclusivos.
O sistema possui integração nativa com a API Oficial do WhatsApp (WABA), mantida e homologada pela Meta. O sistema é um Tech Provider certificado pela Meta, o que permite que assinantes conectem números de WhatsApp Business por meio do aplicativo oficial da plataforma, sem necessidade de criar um App próprio.
Para quem já possui um App aprovado no Facebook Developers, o sistema também oferece suporte à integração via App próprio.
Para ver o que o status de Tech Provider muda na prática e a comprovação na Central de Parceiros da Meta, acesse sistema é Tech Provider oficial da Meta.
Custos da API Oficial: os custos de uso da API Oficial (cobranças por conversas fora da janela de 24 horas) são faturados diretamente pela Meta na Business Manager (BM) do número conectado. O pagamento dessas taxas é responsabilidade do assinante. O sistema cobra exclusivamente a licença do software. Veja mais em Cobranças da Meta.
Risco de bloqueio: o uso da API Oficial elimina o risco de banimento por uso de software não autorizado. No entanto, o número ainda está sujeito às avaliações de qualidade da Meta — bloqueios por envio de spam ou violação das políticas de mensageria são de responsabilidade do operador, independentemente da ferramenta utilizada. Siga sempre as diretrizes da Meta.
Como o sistema conecta na API Oficial
Ao conectar pela API Oficial, o número passa a operar em modo de coexistência: funciona simultaneamente no aplicativo WhatsApp Business do celular e no painel do sistema. A conexão utiliza a arquitetura de "Dispositivos Conectados" da Meta — o processo inclui leitura de QR Code no celular, de forma semelhante ao WhatsApp Web.
Há duas opções de integração disponíveis:
Opção 1 — Via App sistema (usando o App oficial da plataforma como Tech Provider)
O sistema disponibiliza seu próprio App (aprovado como Tech Provider na Meta) para que assinantes façam a conexão OAuth diretamente pelo painel, sem precisar de um App próprio.
Como funciona:
- No painel, acesse Canais → Adicionar Canal → WhatsApp OAuth
- Selecione o aplicativo oficial da plataforma
- Faça login com o Facebook, selecione a conta WhatsApp Business e escaneie o QR Code no celular
- O número fica conectado em modo de coexistência
Ao conectar pelo App oficial da plataforma, a permissão de ligações de voz (calls) já está aprovada automaticamente.
Números com alto índice de denúncias (status Red na Meta) podem ser desconectados do App compartilhado da plataforma para proteger os demais assinantes. Veja: Score do App Tech Provider
Tutorial completo: WhatsApp Oficial OAuth (login)
Opção 2 — Via App Próprio (para quem já tem um App aprovado na Meta)
Assinantes que já possuem um App aprovado no Facebook Developers — ou que desejam criar um — podem integrar o sistema usando as próprias credenciais. Nesse caso, o login incorporado exibe a marca do assinante (não a da plataforma) para os usuários finais.
O que é necessário:
- App criado e aprovado no Facebook Developers com status de Tech Provider
- Configuração do App no painel Super Admin
O processo de App Review da Meta exige envio de documentos e vídeos demonstrativos. O suporte do sistema não realiza esse processo, mas pode indicar profissionais especializados.
Tutorial completo: Cadastro Incorporado e Coexistência com App Próprio
Configuração no Super Admin: Facebook — Login Incorporado WABA, Instagram e Messenger
Vocabulário essencial
| Termo | O que significa |
|---|---|
| WABA | WhatsApp Business API — a API Oficial mantida e homologada pela Meta |
| Tech Provider | Empresa certificada pela Meta para fornecer soluções WABA a terceiros. O sistema tem esse status |
| OAuth / Cadastro Incorporado | Tecnologia de conexão via login do Facebook — vincula o número ao sistema sem configuração manual de webhooks |
| Coexistência | O número funciona simultaneamente no app do celular e no painel do sistema |
| Business Manager (BM) | Painel da Meta onde a empresa gerencia contas, ativos e métodos de pagamento |
| Template (HSM) | Mensagem pré-aprovada pela Meta para iniciar conversas fora da janela de 24 horas |
APIs não oficiais também são suportadas. O sistema permite conexão via QR Code por APIs não oficiais (Baileys, Evolution API, Z-API, entre outras). Cada modalidade tem características e riscos distintos. Veja: API Oficial vs. APIs Não Oficiais
Documentação por área
Conectar e gerenciar o canal
- WhatsApp Oficial OAuth (login com coexistência): passo a passo para conectar um número em modo de coexistência usando o App oficial da plataforma
- Integrações Meta — configurações do canal: painel de configurações do canal após a conexão: webhook, roteamento de chamadas, número de teste e outras opções
- Contas WhatsApp na Meta — visualização e gestão dos números WABA vinculados à Business Manager
Templates e disparos
- Gerenciar Templates HSM — criação, edição e aprovação de templates de mensagem na Meta diretamente pelo painel
- Envio em Massa — Template API Oficial — disparo em massa usando um template fixo para uma lista de contatos
- Envio em Massa — Template com Variáveis — disparo em massa com preenchimento dinâmico de variáveis do template por contato
Atendimento com canal WABA
- Painel de atendimento — recursos exclusivos WABA — funcionalidades disponíveis na tela de atendimento para canais API Oficial: reações, edição de mensagens, templates e ligações
Ligações de voz
- Ligações de voz na API Oficial (WABA) — como ativar o recebimento de chamadas WebRTC, solicitar permissão de chamada para ligar, e configurar o roteamento entre atendentes
Rastreamento e integrações avançadas
- Rastreamento de Conversões (Meta Pixel) — integração com o Meta Pixel para rastrear eventos de conversão originados em atendimentos via WABA
- Exemplo de fluxo N8N + API sistema + WABA — exemplo prático de automação integrando N8N com a API do sistema em canais WABA
Cobrança da Meta
- Como funciona a cobrança de mensagens na Meta — modelo de precificação por categorias de conversa, janela de 24 horas e como gerenciar o faturamento na Business Manager
Perguntas frequentes
O sistema cobra taxa por mensagem na API Oficial? Não. O sistema cobra a licença do software. Os custos de uso do WhatsApp são faturados pela Meta diretamente na Business Manager do número conectado.
A API Oficial elimina completamente o risco de bloqueio? Elimina bloqueios por uso de software não autorizado. O número permanece sujeito às avaliações de qualidade da Meta: spam, violação de políticas e acúmulo de denúncias podem resultar em penalidades — independentemente da API utilizada.
Posso manter o celular ativo e usar o sistema ao mesmo tempo? Sim. O modo de coexistência permite que o número opere simultaneamente no app WhatsApp Business e no painel do sistema.
Como oferecer a conexão WABA para os clientes da minha revenda com a minha marca? É necessário criar e aprovar um App próprio no Facebook Developers. Veja a Opção 2 acima.