Pular para o conteúdo
BlogIA aplicada com responsabilidade

Agente de IA no WhatsApp Business: o que é pago, o que é grátis e o que muda entre a API oficial e a não oficial

Pedro Cunha
Pedro Cunha
CTO da Epicora

Publicado em
atualizado em · 18 min de leitura

Escritório da Epicora: uma integrante da equipe sorri olhando para o lado, apoiada na mesa, enquanto um colega trabalha no notebook ao lado.
Em resumo

A escolha entre a API oficial do WhatsApp e uma não oficial, como a Baileys, não é só de preço: na oficial, as regras da Meta desenham o atendimento, com janela de 24 horas, modelo de mensagem aprovado, um número por integração e cobrança por mensagem; na não oficial, essas regras somem e fica o risco de o número ser banido, porque o uso viola os termos do WhatsApp. A oficial não é só a mais cara, já que cada número tem 1.000 respostas grátis por mês, e a não oficial não é de graça. Na plataforma de atendimento por WhatsApp que operamos, rodamos as duas e escolhemos cliente a cliente.

O que muda entre a API oficial e a não oficial do WhatsApp#

A API oficial é a WhatsApp Business Platform, que a Meta oferece às empresas: o número fica registrado na Meta, as mensagens chegam ao sistema por webhook e cada envio segue as regras e o preço que ela publica. A não oficial é uma biblioteca que imita o WhatsApp Web e entra no número como um aparelho conectado, sem contrato com a Meta.

Uma das mais conhecidas é a Baileys, de código aberto. O próprio projeto avisa, no README, que não tem ligação nem autorização do WhatsApp e desencoraja o uso para mensagem automática ou em massa. O pareamento é pelo código QR, como no WhatsApp Web, e o time da empresa continua usando o aplicativo no celular.

Para quem vai pôr IA no atendimento, a diferença não é só técnica nem só de preço. Na oficial, as regras da Meta decidem o que o atendimento pode fazer: quando a empresa pode escrever, com que texto, em que número e com que mídia. Na não oficial, essas regras somem, e no lugar delas fica o risco de o número ser bloqueado. Na plataforma de atendimento por WhatsApp que operamos para clientes, rodamos os dois caminhos e escolhemos um para cada cliente.

Quais regras da Meta desenham o atendimento na API oficial#

Três regras da Meta mudam o desenho de um atendimento com IA na API oficial: um número fica em uma integração por vez, o webhook é assinado por conta e não por número, e fora da janela de 24 horas só sai modelo de mensagem aprovado. Uma quarta é de formato: nota de voz só existe em OGG com Opus. Cada uma virou decisão de projeto na plataforma que operamos.

Linha do tempo da janela de atendimento da API oficial do WhatsApp: a mensagem da pessoa abre 24 horas em que a empresa responde com texto livre, como a resposta da IA ao lead; fora da janela, follow-up e aviso ao vendedor só saem por modelo de mensagem aprovado.
Quem abre a janela de 24 horas é a pessoa, e não a empresa
  1. Um número, uma integração. Para usar na API um número que já tem WhatsApp, a Meta pede para apagar a conta do aplicativo ou entrar por um parceiro que faça a coexistência com o app WhatsApp Business. Se o número já está na API oficial com outro fornecedor, a troca depende de onde ele está registrado: quando a conta do WhatsApp e o número estão no Meta Business da própria empresa, basta trocar a integração; quando estão na conta do fornecedor, o caminho costuma ser um número novo.
  2. O webhook é da conta, não do número. O aplicativo assina os webhooks de uma conta do WhatsApp Business, e a Meta entrega a todos os aplicativos assinados as mensagens de todos os números dela. Se o número entrasse na conta usada pelo fornecedor anterior, o sistema dele receberia as nossas conversas e poderia responder por cima. A saída planejada foi uma conta separada, só com o nosso aplicativo, ao custo de aprovar os modelos de novo.
  3. Fora da janela, só modelo. A janela de atendimento abre por 24 horas a cada mensagem da pessoa. A resposta da IA ao lead acontece dentro dela. O que a regra pega é o que a empresa inicia: o follow-up de quem parou de responder e o aviso ao vendedor de que chegou um lead, porque é o número do atendimento escrevendo para o número do vendedor, e ninguém abriu essa janela. Os dois passaram a sair por modelo aprovado, e a caixa de entrada troca o campo de texto pelo seletor de modelo quando a janela fecha. Como essa regra entra no planejamento dos avisos de qualquer sistema está no mapa de notificações.
  4. Voz em OGG com Opus. A Meta só trata como nota de voz o arquivo OGG com o codec Opus, marcado como voz. O navegador grava em outro formato, então o sistema converte o áudio gravado no painel antes de mandar. Antes dessa conversão, o áudio mandado pelo painel não tocava no iPhone.

Por que um modelo de mensagem aprovado ainda pode ser barrado#

Porque a aprovação diz que o texto pode ser usado, e não que a mensagem será entregue. A Meta classifica cada modelo por categoria e limita quantos modelos de marketing uma pessoa recebe, de todas as empresas, num período. Quando a mensagem cai nesse limite, volta o erro 131049, que a Meta descreve como mensagem não entregue para manter um engajamento saudável do ecossistema.

Foi o que aconteceu com o aviso de lead num dos números que operamos na API oficial. Num mesmo dia de outubro de 2026, a Meta barrou duas vezes o aviso para os dois números do time do cliente, já com o modelo aprovado. Horas antes, com o modelo ainda em análise, o erro era outro, o 131047, de mensagem fora da janela. O aviso estava sendo cobrado como marketing, a cerca de R$ 0,34 cada, e caía no limite de marketing.

A saída não foi reescrever o modelo, e sim usar a janela de 24 horas. Cada pessoa do time manda um "oi" para o número do atendimento, o que abre a janela dela, e responde aos avisos que recebe, o que a mantém aberta. Enquanto ela está aberta, o aviso sai como texto comum. O agente reconhece o número do time e não o atende como lead, e a tela da equipe mostra, pessoa por pessoa, se os avisos estão chegando.

Pela documentação da Meta, mensagem de marketing mandada com a janela aberta não conta para o limite, e quem recebe o 131049 deve esperar pelo menos 24 horas antes de reenviar.

A API oficial é só a versão mais cara?#

Não. Desde julho de 2025, a Meta cobra por mensagem entregue, com preço por categoria e por país, e parte do que um atendimento com IA manda não paga nada: cada número tem 1.000 respostas de atendimento grátis por mês, e quem chega por anúncio de clique para o WhatsApp abre uma janela de até 7 dias sem cobrança. O que pesa na conta é a mensagem que a empresa inicia.

Barras em escala com o que a Meta cobrou por mensagem num número na API oficial em outubro de 2026: cerca de R$ 0,34 por modelo cobrado como marketing, cerca de R$ 0,04 por resposta da IA depois das 1.000 grátis do mês, e nada pelas primeiras 1.000 respostas nem pela conversa vinda de anúncio de clique para o WhatsApp, por até 7 dias.
Na API oficial, o que pesa é a mensagem que a empresa inicia

O preço mudou de novo em 1º de outubro de 2026. As respostas livres dentro da janela, que a Meta chama de mensagens de serviço e que incluem as escritas por uma IA de terceiros, voltaram a ser cobradas a partir da 1.001ª do mês em cada número. Os modelos de utilidade mandados dentro da janela também passaram a ser cobrados. Para o Brasil, a Meta usa como referência 0,68 centavo de dólar por mensagem de utilidade e de autenticação.

Num dos números que operamos na API oficial, as 1.000 respostas grátis de outubro já tinham acabado no dia 22, e cada resposta da IA passou a custar cerca de R$ 0,04 de Meta. Um modelo cobrado como marketing saiu por cerca de R$ 0,34. A conta da Meta é do cliente, paga no cartão cadastrado na conta dele, e fica separada do custo da IA, que é por token e está em quanto custa pôr IA para trabalhar dentro do sistema. Desde julho de 2026, a própria Meta vende um agente de IA dela no WhatsApp, cobrado por token, que pela conta dela sai a 4 ou 5 centavos de dólar por mensagem.

O que a oficial cobra além do dinheiro é desenho. O follow-up vira modelo pago, o aviso ao time precisa da janela aberta e toda conversa iniciada pela empresa exige que a pessoa tenha aceitado receber mensagens, como manda a política do WhatsApp.

A API não oficial é de graça?#

Ela não paga a Meta, mas não é de graça. A não oficial usa o WhatsApp de um jeito que os termos de serviço proíbem: acesso por meios automatizados não autorizados e mensagem automática ou em massa. O custo aparece quando o número é bloqueado, e quem já usava o serviço fora dos termos não tem como contestar alegando uso legítimo.

Os termos do WhatsApp vedam mensagem em massa, automática e de discagem automática, e preveem desativar ou suspender a conta. Na API oficial, a Meta documenta um caminho gradual: aviso, restrição de envio por tempo crescente, bloqueio e, por fim, desativação, com pedido de revisão que costuma ser respondido em 24 a 48 horas. No escopo da nossa plataforma, o banimento na não oficial é tratado como permanente e sem recurso.

Por isso, os clientes que ficam na não oficial têm travas que existem só para proteger o número:

  • número dedicado ao atendimento, e não a linha principal da empresa, com o chip aquecido com conversa real antes de receber tráfego e nunca um número VoIP;
  • só responder a quem escreveu, sem disparo, campanha ou lista de transmissão;
  • um contêiner por cliente, para o bloqueio de um número não derrubar os outros;
  • parar quando o WhatsApp recusa a sessão, avisando o plantão em vez de tentar reconectar;
  • um termo de ciência do risco, assinado pelo cliente antes de ativar.

A trava de parar nasceu de um ensaio. Com a sessão morta, o agente recarregava a mesma credencial e batia no WhatsApp a cada 5 segundos, sem fim, um comportamento que é caminho de banimento e que nenhum alerta mostrava. Hoje ele para e avisa. A sessão também cai sozinha: num dos números na não oficial, foram quatro quedas num mesmo dia de setembro.

Oficial ou não oficial: a comparação critério por critério#

A tabela compara os dois caminhos no que muda para um atendimento com IA: o número, quando a empresa pode escrever, o custo, o risco e o que chega de cada conversa. Ela junta a documentação da Meta, os termos do WhatsApp e o que vemos na plataforma de atendimento que operamos nos dois transportes.

CritérioAPI oficial (WhatsApp Business Platform)Não oficial (Baileys e afins)
Númeroregistrado na Meta, em uma integração por vez; número que já tem WhatsApp exige apagar a conta do app ou entrar por coexistênciaum chip com WhatsApp, pareado por QR; usamos número dedicado, nunca VoIP, e aquecemos o chip novo
Quando a empresa pode escrevertexto livre só na janela de 24 h aberta pela pessoa; fora dela, só modeloa qualquer hora, tecnicamente; mensagem automática ou em massa é o que os termos proíbem
Modelo de mensagemaprovado e classificado pela Meta (marketing, utilidade, autenticação); pode ser barrado pelo 131049não existe
Custopor mensagem entregue: 1.000 respostas grátis por mês por número; medimos R$ 0,04 por resposta depois disso e R$ 0,34 por modelo de marketingsem tarifa da Meta; custo do chip, do aparelho e da sessão
Risco de banaviso, restrição gradual e pedido de revisãoconta desativada por violar os termos, sem recurso
Mídia e voznota de voz só em OGG com Opus; sem foto de visualização únicao que a biblioteca imita do WhatsApp Web, sem documentação e sujeito a mudar
Anúncio de clique para o WhatsAppa mensagem traz o anúncio de origem (o referral) e abre até 7 dias sem cobrançao dado de origem do anúncio não vem pelo caminho documentado
Várias pessoas atendendopainel com um acesso por atendente; com coexistência, o app WhatsApp Business continua juntoo time segue no app do celular, e a IA entra como aparelho conectado

Lida linha a linha, a tabela mostra uma troca: a oficial põe regra e preço onde a não oficial põe risco. Quando revisamos o escopo da nossa plataforma, o campo de origem do contato ficou sem fonte nos números da não oficial, porque o referral do anúncio é recurso da API oficial.

A regra da Meta contra chatbots de IA atinge o atendimento da empresa?#

No caso comum, não. Desde 15 de janeiro de 2026, os termos da plataforma proíbem os provedores de IA, como quem oferece um assistente de uso geral, quando a IA é a função principal oferecida, "e não incidental ou acessória". Um atendente que responde pela empresa sobre o negócio dela é uso acessório. Quem decide o enquadramento, pelos termos, é a Meta.

No Brasil há uma exceção para os próprios provedores de IA: a Meta diz que é obrigada por lei a permitir que eles usem a plataforma aqui, e desde 11 de março de 2026 cobra deles cada mensagem de serviço entregue a usuários brasileiros. A cobrança é específica desses provedores e não muda o preço das outras empresas.

Para o atendente de uma empresa, a regra que pesa é a política de mensagens do WhatsApp: com automação, a empresa precisa oferecer um caminho rápido e claro para falar com uma pessoa. Nos agentes que operamos, pedir uma pessoa passa a conversa para o time. E, num assistente financeiro no WhatsApp que estamos escopando, o escopo diz que o assistente só fala das finanças da família e recusa outro assunto com gentileza, para não virar um assistente de uso geral.

Como escolhemos o transporte de cada cliente#

Escolhemos pelo que o atendimento precisa fazer. Se a empresa vai iniciar conversa, com follow-up, aviso ou reativação, se quer saber qual anúncio trouxe cada lead ou se o número já está numa integração oficial, vai para a oficial. Se o atendimento só responde a quem escreve e o time quer seguir no aplicativo do celular, a não oficial cabe, com número dedicado e o risco assinado.

Fluxo de decisão: se o atendimento precisa iniciar conversa, saber qual anúncio trouxe o lead ou o número já está numa integração oficial, vai para a API oficial; se só responde a quem escreve e o time segue no app do celular, cabe a não oficial, com número dedicado e o risco assinado pelo cliente.
O transporte sai do que o atendimento precisa fazer

Para a escolha ser por cliente, o transporte virou uma peça trocável do sistema: o mesmo agente, a mesma caixa de entrada e o mesmo funil funcionam nos dois caminhos, e só muda a camada que fala com o WhatsApp. O lado da oficial foi validado antes de existir conta na Meta, com 270 testes do agente rodando contra uma Meta falsa, cobrindo entrada, envio, áudio convertido, modelos e o aviso ao time com plano B. É a mesma lógica de qualquer integração com sistema de terceiro: o limite de quem está do outro lado vira limite do produto, como no ERP que decide parte do seu sistema.

As contas ficam no nome do cliente: o Meta Business, a conta do WhatsApp, o número, os modelos e o cartão que paga a Meta. Foi isso que deixou um cliente trocar de fornecedor sem trocar de número.

Nem toda empresa precisa de uma integração direta com a Meta. Na Helpe, o código de verificação por WhatsApp que estamos colocando sai por um parceiro oficial da Meta, cobrado por mensagem, com SMS automático se o WhatsApp falhar. E projeto que precisa iniciar conversa desde o primeiro dia já nasce na oficial, como o assistente financeiro que estamos escopando, que manda lembrete de vencimento fora da janela.

Perguntas frequentes#

A API não oficial do WhatsApp é permitida?#

Não pelos termos do WhatsApp. Eles proíbem acessar o serviço por meios automatizados não autorizados e mandar mensagem automática ou em massa, e preveem suspender ou desativar a conta. A própria Baileys, uma das bibliotecas mais conhecidas, avisa que não tem ligação nem autorização do WhatsApp. Quem usa assume o risco de perder o número.

Posso usar na API oficial o número que já uso no WhatsApp do celular?#

Pode, de dois jeitos. O primeiro é apagar a conta do aplicativo e registrar o número na API, perdendo o histórico do celular. O segundo é entrar por um parceiro da Meta que faça a coexistência, em que o número continua no app WhatsApp Business e na API ao mesmo tempo, com limites: grupos não são sincronizados, listas de transmissão e visualização única são desligadas e a vazão fica em 20 mensagens por segundo.

Quanto custa a API oficial do WhatsApp por mensagem?#

Desde julho de 2025, a Meta cobra por mensagem entregue, com preço por categoria e por país. Cada número tem 1.000 respostas de atendimento grátis por mês, e quem chega por anúncio de clique para o WhatsApp abre até 7 dias sem cobrança. Num número que operamos, em outubro de 2026, a resposta depois das 1.000 grátis custou cerca de R$ 0,04, e um modelo cobrado como marketing, cerca de R$ 0,34.

A Meta proibiu chatbot de IA no WhatsApp?#

Proibiu os provedores de IA cujo produto principal é o assistente, como um chatbot de uso geral, a partir de 15 de janeiro de 2026. O texto vale quando a IA é a função principal, e não incidental ou acessória. Um atendente que responde pela empresa sobre o negócio dela é uso acessório. A política de mensagens exige, quando há automação, um caminho claro para falar com uma pessoa.

Por que o WhatsApp barrou meu modelo de mensagem já aprovado?#

Porque a aprovação libera o texto, e não garante a entrega. O erro 131049 aparece quando a Meta segura a mensagem para não cansar a pessoa, sobretudo pelo limite de modelos de marketing que cada um recebe de todas as empresas. Ela recomenda esperar 24 horas antes de reenviar. Para avisos internos, a saída que usamos é a pessoa do time abrir a janela de 24 horas com uma mensagem.

Fontes#

Próximo passo#

Se você vai pôr um atendente de IA no WhatsApp e precisa decidir o caminho antes de escolher fornecedor, é o trabalho que fazemos em IA e automação: o transporte escolhido pelo que o atendimento precisa fazer, as contas no nome da sua empresa e as regras da Meta entrando no desenho desde o começo.

Próximo passo

Quer olhar isso no seu caso?

Conte em poucas linhas o que você tem hoje. A gente responde com o caminho que faz sentido, inclusive quando a resposta é não construir nada.

Ver Integrações e migração de sistemasFalar com a Epicora
Compartilhar
Pedro Cunha
Quem escreve
Pedro Cunha
CTO da Epicora

Pedro Cunha lidera a engenharia da Epicora, em Chapecó (SC). Escreve aqui sobre as decisões técnicas dos sistemas que a equipe coloca em produção — arquitetura, escopo, estimativa e IA aplicada.

Artigos de Pedro Cunha

Contato

Vamos conversar sobre o seu projeto

Conte o que você precisa resolver. Retornamos rápido, com gente que entende de tecnologia e de negócio.

Prefere falar direto?

Escolha o canal que preferir. Respondemos rápido, no horário comercial.

Chamar no WhatsAppE-mail[email protected]Telefone(49) 99187-4237Onde estamosR. Condá, 1392 – D - Universitário, Chapecó - SC, 89812-201
5,011 avaliações no Google

Da primeira conversa ao go-live: eficiência, segurança e inovação.