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):

  1. Uma conta Meta Business verificada (business.facebook.com)
  2. Um WABA (WhatsApp Business Account) aprovado pela Meta
  3. Um número de telefone — que pode continuar no app WhatsApp Business do celular (modo Coexistência) ou ser exclusivo da API
  4. 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

  1. Acesse Integrações > Conexões (canais)
  2. Clique em "Nova Conexão"
  3. Selecione WhatsApp Oficial (marcado como Beta)
  4. Dê um nome para a conexão
  5. 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.
  6. Clique em "Conectar WhatsApp Oficial" e autorize tudo no popup da Meta, com a sua conta do Facebook
  7. 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

  1. Acesse Templates no menu lateral
  2. Selecione a conexão Meta ativa
  3. 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.

Última atualização 31/10/2026 · Versão 2 · ref d3a2417a7d4a