Skip to main content

​
Visão geral

A Meta ganha dinheiro com o uso da API Oficial e não incentiva o uso de APIs não oficiais. O problema é que a API Oficial carrega consigo alguns desafios:
  • Requer mais compliance
  • É mais cara (custo por mensagem)
  • É mais limitada (templates precisam de aprovação; não há como editar ou apagar mensagens já enviadas)
Vamos destrinchar isso neste documento. Confira o comparativo completo em . Se você usa API Não Oficial e vê o número do contato borrado em alguns casos, saiba que é por regras de privacidade da Meta (LID); detalhes em LID e número do contato borrado.

​
Etapa 1: Criar sua Business Manager (BM)

A primeira etapa para providenciar sua API Oficial é configurar seu Portfólio Empresarial (também chamado de Business Manager ou BM).
Se você já roda tráfego pago (Facebook Ads, Instagram Ads), certamente você já tem uma BM criada e validada. Nesse caso, pule para a Etapa 3.
Acesse business.facebook.com e crie sua BM.

​
Etapa 2: Validar sua Business Manager

Acesse a Central de Segurança da sua BM e preencha os dados solicitados.
Central de Segurança - início da validação
Nesta etapa, você vai precisar:
  • Fazer autenticação de dois fatores
  • Completar a verificação da empresa
  • Podem te solicitar um CNPJ, site e outros documentos
Se você já tem um CNPJ, essa etapa não deve ser um problema para você.
Processo de validação da Business Manager
Central de Segurança da Business Manager - BM validada
O botão de verificação não apareceu na sua Central de Segurança? Leia abaixo.
A Meta só exibe o botão de verificação quando a sua BM tem pelo menos um ativo vinculado (como um app, uma WABA ou uma Página). Se você acabou de criar a BM e ainda não tem nenhum desses ativos, o botão simplesmente não aparece.Uma forma rápida de contornar isso é vincular sua Página ao recurso de Páginas de notícias da BM. Isso cria um vínculo que força o sistema a exibir o botão.
1

Acesse Páginas de notícias

No menu lateral das Configurações da BM, clique em Páginas de notícias.
2

Clique em Selecionar Páginas

No canto superior direito, clique no botão Selecionar Páginas.
3

Pesquise e selecione sua Página

Na janela que abrir, use o campo Pesquisar Páginas para encontrar sua Página e selecione-a. Clique em Concluir.
Isso não afeta sua Página de nenhuma forma. É apenas um vínculo técnico para desbloquear o botão de verificação.
4

Atualize a página e volte para a Central de Segurança

Atualize o navegador e acesse Informações da empresa → Ver detalhes. O botão de verificação vai aparecer normalmente.
Depois de validar, adicione um meio de pagamento (cartão de crédito). A Meta cobra por mensagem na API Oficial.

​
Etapa 3: Providenciar um WABA

Depois que você tiver uma Business Manager validada, você precisa providenciar um WABA (WhatsApp Business Account).
WABA é o termo técnico para “WhatsApp válido na API Oficial”.
Nesta etapa, você pode fazer isso pela LíderHub ou pelo Facebook.

Criar WABA do zero

Chip novo, sem histórico, via Cloud API.

Importar WABA

Já tem um WABA ativo e quer conectá-lo à LíderHub.

WABA - Coexistência

Transforme seu WhatsApp existente em WABA.

​
Etapa 4: Integração WABA e LíderHub

Agora que você já tem um WABA (ou vai criar um), é hora de integrá-lo à LíderHub. Este fluxo é conhecido também como Embedded Signup — você vai conectar sua conta Facebook e Meta à LíderHub.
1

Iniciar nova conexão

Na LíderHub, acesse Conexões > Nova Conexão e selecione API Oficial:
Seleção do tipo de conexão API Oficial na LíderHub
2

Aceite os termos de uso

Leia e aceite os termos de uso da Meta para prosseguir com a integração.
Termos de uso da Meta para integração com a LíderHub
3

Finalize o processo na Meta

Você tem 3 caminhos principais, de acordo com a Etapa 3: Providenciar um WABA:
Seleção de ativos de negócios para compartilhar com a LíderHub
Selecione seu Portfólio Empresarial. Note que neste momento já é necessário que sua BM esteja verificada (veja a Etapa 2: Validar sua Business Manager).
Seleção do Portfólio Empresarial verificado
Selecione uma das 3 opções para prosseguir:
Seleção do WABA para coexistência na LíderHub

Criar uma conta do WhatsApp Business

Crie uma nova conta do zero, novo WhatsApp, sem telefone, via Cloud API.

Conectar um app do WhatsApp Business

Transforme seu WhatsApp Business existente em WABA via coexistência.

Selecione outros

Números WABA que você já compartilhou com a LíderHub vão aparecer aqui.
Escolha o Catálogo, a Conta de Anúncios e a Página que deseja vincular à sua conexão.

​
Custos

A API Oficial tem custos cobrados pela Meta, não pela LíderHub. Você paga direto na Meta, com o cartão de crédito cadastrado na sua Business Manager.
O que mudou em outubro de 2026Até setembro, responder um cliente que tinha te chamado era sempre grátis. Agora:
  • As primeiras 1.000 mensagens de serviço do mês continuam grátis, para cada número de WhatsApp.
  • Da 1.001ª em diante, cada mensagem de serviço custa USD 0.0068 (o mesmo preço de uma mensagem de utilidade).
  • Conversas que começam por um anúncio Click-to-WhatsApp ganham uma janela de até 7 dias em que nenhuma mensagem é cobrada. Veja em Janela de Ponto de Entrada Gratuito.
Abaixo estão os tipos de mensagem e os preços para o Brasil:
Os custos da API Oficial variam por país e são cobrados pela Meta. Consulte a tabela de preços atualizada para mais detalhes.
Mensagens de serviço são as respostas que você envia quando o cliente te chamou primeiro, dentro da janela de 24 horas. Estas são as mensagens mais comuns.Isso inclui as respostas do seu agente de IA na LíderHub. Se o agente respondeu o cliente, foi uma mensagem de serviço.
  • Da 1ª à 1.000ª mensagem do mês: grátis
  • Da 1.001ª em diante: USD 0.0068 por mensagem
  • A cota de 1.000 é por número de WhatsApp. Se o seu escritório tem 2 números conectados na API Oficial, cada um tem as suas 1.000 mensagens grátis.
  • A contagem recomeça todo mês. Mensagens grátis que sobraram não passam para o mês seguinte.
Quando a janela de conversação está aberta, as mensagens que você envia estão dentro das 24h.
Mensagens de autenticação são usadas para enviar códigos de verificação, como OTPs (senhas de uso único) para login ou confirmação de identidade.
A LíderHub não oferece suporte para este tipo de mensagem, porque entendemos que não há aplicações práticas do seu escritório enviar este tipo de conteúdo para seus leads ou clientes.
Mensagens de utilidade são notificações transacionais, como confirmações de pedido, atualizações de entrega, lembretes de agendamento, entre outros.
Na LíderHub, mensagens de utilidade são úteis para atualização de status do processo do cliente.
Mensagens de marketing são promoções, ofertas, campanhas e mensagens comerciais enviadas aos contatos.
Na LíderHub, mensagens de template de Marketing são utilizadas principalmente como Follow Up no processo comercial.

​
Quanto isso custa na prática?

Imagine um escritório com um número de WhatsApp que enviou 5.000 mensagens de serviço num mês, todas em conversas que não vieram de anúncio: Se parte dessas conversas tivesse começado por um anúncio Click-to-WhatsApp, nenhuma mensagem dessas conversas seria cobrada durante a janela de até 7 dias.

​
Janela de Atendimento

Pense na janela como uma porta que o cliente abre quando te manda mensagem. Enquanto ela está aberta, você conversa à vontade. Quando ela fecha, você só pode “bater na porta” com um template aprovado pela Meta. Na API Oficial, essa porta fica aberta por 24 horas. A janela abre quando o cliente envia uma mensagem para você, e a partir desse momento você pode responder livremente por 24 horas com mensagens de serviço (texto, áudio, imagem, vídeo, documento). Após as 24 horas, a janela se fecha. Para continuar a conversa, existem 2 condições:
  • Para enviar mensagem com janela fechada: você só pode usar um template pré-aprovado pela Meta (autenticação, utilidade ou marketing), o que gera custo por mensagem.
  • Para voltar a enviar mensagens de serviço: a janela precisa ser reaberta. Isso só acontece quando o cliente responde à sua mensagem de template. Enviar o template sozinho não reabre a janela.

Confira mais detalhes sobre mensagens de Template na LíderHub em Gerenciar Mensagens.

Saiba mais na documentação oficial sobre janela de atendimento. As mensagens de template na API Oficial devem ser pré-aprovadas pela Meta. Confira mais sobre o processo em Solicitar Aprovação Meta.

​
Janela de Ponto de Entrada Gratuito

Quando o cliente chega até você por um anúncio do Facebook ou Instagram (Click-to-WhatsApp, ou CTWA) ou por um botão de ação em uma Página do Facebook, a Meta abre uma janela especial, maior e mais barata que a normal.
Comparação das janelas: conversa normal de 24 horas, conversa de anúncio de 72 horas (antes) e de até 7 dias (agora)

A janela de uma conversa que veio de anúncio passou de 72 horas para até 7 dias, e nela nenhuma mensagem é cobrada.

Desde 28 de setembro de 2026, uma conversa que começa por anúncio ganha uma janela de até 7 dias.
  • Enquanto a janela está aberta, nenhuma mensagem é cobrada: mensagens de serviço, templates de utilidade e de marketing, qualquer tipo.
  • Na prática: o lead clicou no anúncio, e você e o seu agente de IA podem conversar com ele por até uma semana sem pagar nada à Meta pelas mensagens.
  • Para a janela abrir, você precisa responder o cliente dentro de 24 horas depois da primeira mensagem dele. Essa primeira resposta também é grátis, e os 7 dias contam a partir dela.
  • Vale para quem clicou no anúncio pelo celular (Android ou iPhone). Cliques feitos pelo WhatsApp no computador não abrem essa janela.
  • A janela de atendimento de 24 horas continua funcionando normalmente.
Por que isso importa para o seu escritório: se você atende muito pelo WhatsApp e passa das 1.000 mensagens de serviço por mês em um número, trazer clientes por anúncios Click-to-WhatsApp zera o custo das mensagens dessas conversas por até 7 dias e ainda aumenta o número de leads para o seu agente atender. Se quiser ajuda com anúncios, fale com o seu gerente de conta.
Saiba mais na documentação oficial sobre ponto de entrada gratuito e no registro de mudanças da Meta. Para capturar o identificador de atribuição do anúncio (ctwaClid) e devolvê-lo à Meta para otimização de campanhas, consulte .

​
Perguntas comuns sobre a cobrança

A Meta. A cobrança vai para o cartão cadastrado na sua Business Manager. Isso é separado dos créditos do seu plano LíderHub.
Sim. Qualquer resposta livre enviada dentro da janela de 24 horas é mensagem de serviço, seja de uma pessoa ou do agente.
Não. A cota é por número. Cada número conectado na API Oficial tem as suas próprias 1.000 mensagens de serviço grátis por mês.
Não. A contagem recomeça todo mês, e o que sobrou não passa para o mês seguinte.
Não. A cobrança por mensagem é só da API Oficial. Veja o comparativo em API Oficial vs Não Oficial.

​
Editar ou excluir mensagens enviadas

A Cloud API da Meta não permite editar nem apagar mensagens depois do envio.
A Message API da Meta permite enviar mensagens, mas não oferece métodos para editar ou apagar mensagens já enviadas. Isso vale para qualquer conexão via API Oficial na LíderHub - não é uma limitação da LíderHub, e sim da própria Meta.
Se a mensagem saiu errada, envie uma nova mensagem corrigindo o conteúdo. Revise o texto antes do envio, especialmente em automações, follow-ups e templates.
Veja também o comparativo completo em e os detalhes de coexistência em .

​
Deixe uma sugestão

Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse Obtenha suporte.

​
Dúvidas Frequentes

Sim. A Meta exige verificação de empresa no Business Manager, que requer CNPJ ou documento equivalente.
O processo completo pode levar de 3 a 10 dias úteis, dependendo da aprovação da Meta.
Sim, em números diferentes. Cada conexão na LíderHub pode usar um tipo diferente de API.
Sim, você pode fazer isso via coexistência. O histórico de até 6 meses pode ser importado na primeira conexão.
Não. A Cloud API da Meta não possui endpoints para editar ou excluir mensagens depois do envio. Se você enviou uma mensagem errada, envie uma nova mensagem corrigindo o conteúdo - não há como apagar ou alterar a mensagem original via API.
Última modificação em 17 de junho de 2026