WhatsApp API Oficial (Meta)

O que e

O ConvertaFlow suporta a API Oficial do WhatsApp Business da Meta. 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 entra como mais uma conexão WhatsApp do seu plano.

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	Credenciais da sua conta Meta Business
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 registrado na API Oficial (não pode estar em uso no WhatsApp normal)
Uma forma de pagamento cadastrada no painel da Meta — é onde a Meta cobra as conversas
As credenciais de acesso: WABA ID, Phone Number ID, Token de acesso e Business ID

Como conectar

Acesse Integrações > Conexões
Clique em "Nova Conexão"
Selecione WhatsApp como canal
Dê um nome para a conexão
Escolha o modo "WhatsApp Oficial (Meta)"
Preencha os campos de credenciais:
- WABA ID — identificador da sua conta WhatsApp Business
- Phone Number ID — identificador do número registrado
- Token de Acesso — token permanente gerado no painel da Meta
- Business ID — identificador da sua conta Meta Business
Clique em "Criar Conexão"
O sistema valida as credenciais e ativa a conexão

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? Não. Um número registrado na API Oficial não pode ser usado simultaneamente no aplicativo WhatsApp 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. Cada conexão entra no limite de conexões do seu plano.