WhatsApp API Oficial (Meta)
6 min de leitura
O que e
O ConvertaFlow suporta a API Oficial do WhatsApp Business da Meta — no catálogo de conexões, WhatsApp Oficial, hoje liberado em Beta. Com ela, você tem acesso ao selo verde de verificação, envio de templates aprovados, botões nativos e alta capacidade de envio. É a opção ideal para empresas que precisam de confiabilidade máxima e conformidade com as políticas do WhatsApp.
Quem paga a Meta? Você, direto (modelo "traga sua própria conta")
Este é o ponto mais importante de entender antes de conectar:
A API Oficial funciona no modelo BYOA ("Bring Your Own Account", ou "traga sua própria conta"). Na prática, isso significa:
- A conta WhatsApp Business é sua. Você cria e mantém o seu próprio WABA (WhatsApp Business Account) no painel da Meta.
- A Meta cobra você diretamente. As tarifas por conversa são faturadas pela Meta na conta de cobrança que você cadastrou no painel dela. O ConvertaFlow não fica no meio dessa cobrança.
- O ConvertaFlow não assume nenhum custo da Meta, não inclui pacotes de conversas, não revende conversas e não aplica margem ou taxa sobre o que a Meta cobra. Você paga a Meta o que a Meta cobrar, sem intermediação.
- O ConvertaFlow cobra apenas a sua assinatura da plataforma (o plano que você contratou). A conexão da API Oficial tem um limite próprio no seu plano, separado do limite das conexões WhatsApp Lite (QR Code).
Resumindo: a plataforma é onde você atende, automatiza e gerencia tudo numa tela só. A relação financeira pelas conversas é entre você e a Meta.
Diferença entre conexão por QR Code e API Oficial
| Característica | QR Code | API Oficial (Meta) |
|---|---|---|
| Conexão | Escaneamento de QR Code | Login na sua conta Meta (Facebook), em 1 clique |
| Selo verde | Não disponível | Disponível após verificação |
| Templates | Não obrigatório | Obrigatório para iniciar conversa |
| Botões nativos | Parcial (depende do modo) | Suporte completo |
| Capacidade de envio | Moderada | Alta (até 80 mensagens por segundo) |
| Custo das conversas | Nenhum custo da Meta | Cobrado pela Meta diretamente de você |
| Requisito | Celular com WhatsApp | Conta Meta Business verificada (sua) |
Requisitos para usar a API Oficial
Antes de conectar, você precisa ter (tudo no seu nome, na sua conta Meta):
- Uma conta Meta Business verificada (
business.facebook.com) - Um WABA (WhatsApp Business Account) aprovado pela Meta
- Um número de telefone — que pode continuar no app WhatsApp Business do celular (modo Coexistência) ou ser exclusivo da API
- Uma forma de pagamento cadastrada no painel da Meta — é onde a Meta cobra as conversas
Você não precisa copiar nenhum ID nem token: a autorização é feita direto no popup da Meta.
Como conectar
- Acesse Integrações > Conexões (canais)
- Clique em "Nova Conexão"
- Selecione WhatsApp Oficial (marcado como Beta)
- Dê um nome para a conexão
- Responda "Como você quer usar este número?":
- Coexistência (recomendado) — o número continua funcionando no app WhatsApp Business do celular e também aqui; as conversas aparecem nos dois lugares e as recentes são importadas. Requer o app WhatsApp Business ativo no número (quem usa o WhatsApp comum migra grátis pelo próprio celular). Abra o app pelo menos a cada 14 dias para a conexão seguir ativa.
- API Oficial dedicada — para número novo ou chip dedicado: o número vira 100% API oficial e deixa de funcionar no app do celular. O número não pode ter uma conta WhatsApp ativa.
- Clique em "Conectar WhatsApp Oficial" e autorize tudo no popup da Meta, com a sua conta do Facebook
- Ao concluir, a conexão aparece na tela de Conexões, no grupo WhatsApp Oficial
Templates de mensagem
Com a API Oficial, você precisa usar templates aprovados para iniciar conversas com clientes que não entraram em contato nas últimas 24 horas. Templates também são usados no módulo de Campanhas e Marketing.
Gerenciar templates
- Acesse Templates no menu lateral
- Selecione a conexão Meta ativa
- Você pode:
- Ver todos os templates sincronizados da sua conta Meta
- Criar novos templates diretamente pelo ConvertaFlow
- Excluir templates que não são mais necessários
- Filtrar por status (Aprovado, Pendente, Rejeitado) e categoria
Categorias de templates
- Marketing — promoções, ofertas, novidades
- Utilidade — confirmações de pedido, atualizações, lembretes
- Autenticação — códigos de verificação, confirmação de identidade
Status dos templates
- Aprovado — pronto para uso
- Pendente — em análise pela Meta (pode levar até 24 horas)
- Rejeitado — não atende às políticas da Meta; edite e reenvie
- Pausado — temporariamente suspenso pela Meta por baixa qualidade
Qualidade da conexão
A Meta atribui uma nota de qualidade ao seu número. No ConvertaFlow, você pode acompanhar essa informação diretamente na tela de conexões. Qualidade baixa pode limitar o volume de envios.
Para manter boa qualidade:
- Envie mensagens relevantes e solicitadas
- Evite altas taxas de bloqueio ou denúncia
- Use templates aprovados corretamente
- Respeite o opt-in dos contatos
Perguntas frequentes
Quem paga as conversas da API Oficial: eu ou o ConvertaFlow? Você paga a Meta, diretamente. A API Oficial é no modelo "traga sua própria conta": o WABA é seu e a Meta cobra as conversas na forma de pagamento que você cadastrou no painel dela. O ConvertaFlow não entra nessa cobrança, não inclui conversas e não cobra nada a mais por elas. Você continua pagando apenas a sua assinatura da plataforma.
O ConvertaFlow cobra alguma taxa sobre a API Oficial? Não. Nenhuma taxa, markup ou comissão sobre as conversas. A única cobrança do ConvertaFlow é o seu plano. As tarifas por conversa são definidas e cobradas pela Meta. Consulte a tabela de preços da Meta para a sua região.
Posso usar o mesmo número no WhatsApp do celular e na API Oficial? Sim, no modo Coexistência (o recomendado): o número segue no app WhatsApp Business do celular e também na plataforma, com as conversas nos dois lugares. Só no modo API Oficial dedicada o número deixa de funcionar no app do celular.
Quanto tempo demora a aprovação de um template? Normalmente até 24 horas. Em alguns casos pode ser mais rápido (minutos). Templates rejeitados podem ser editados e reenviados.
Posso enviar mensagens sem template? Sim, mas apenas dentro da janela de 24 horas após o cliente enviar uma mensagem para você. Fora dessa janela, é obrigatório usar um template aprovado.
O que é o selo verde? É o selo de verificação oficial do WhatsApp Business. Ele aparece ao lado do nome da empresa no perfil, transmitindo confiança. Para obtê-lo, sua conta Meta Business precisa estar verificada.
Posso ter conexões por QR Code e API Oficial ao mesmo tempo? Sim. O ConvertaFlow permite misturar diferentes modos de conexão. Você pode ter alguns números via QR Code e outros via API Oficial, todos na mesma tela. As conexões por QR Code (WhatsApp Lite) e as da API Oficial têm limites separados no seu plano.