API oficial WhatsApp: o que é, quanto custa e agente de IA

Terça, depois do almoço, duas propostas abertas lado a lado na tela. As duas prometem um agente de IA respondendo o WhatsApp da empresa. A primeira vem pela API oficial, com mensalidade, taxa de implantação e uma linha que ninguém explica: "mensagens Meta: conforme consumo". A segunda sai mais barata, promete mensagens ilimitadas e liga tudo lendo um QR code com o celular.

Aí você digita API oficial WhatsApp na busca pra entender a diferença e encontra, quase sempre, o blog de quem vende o acesso. Eu escrevi este texto do outro lado da mesa, o de quem vai ligar um agente e precisa saber o que está comprando.

O que é a API oficial do WhatsApp (ou WhatsApp Business API)

A API oficial do WhatsApp é a porta que a Meta abre para um sistema mandar e receber mensagens pelo número da empresa. O nome de batismo é Plataforma do WhatsApp Business. No mercado, ela aparece como WhatsApp Business API, API do WhatsApp ou só API WhatsApp. É por ela que um CRM, um sistema de atendimento ou um agente de IA lê a mensagem que chegou e responde sem ninguém digitando no celular.

Vale separar o que leva o nome WhatsApp:

• O aplicativo WhatsApp Business, gratuito, que uma pessoa usa no celular, com mensagem de ausência e resposta rápida.
• A API oficial, que não tem tela nenhuma: ela liga o número a um sistema. Hoje roda na nuvem da própria Meta, e por isso muita gente busca por WhatsApp Cloud API.
• A API não oficial, que imita o WhatsApp Web lendo um QR code. Ela fica pra próxima seção.

Pra usar a oficial, existem dois caminhos. O direto é criar um app na área de desenvolvedor da Meta e programar a ligação: o endereço que recebe as mensagens, o token, o envio. O outro é contratar um provedor, empresa parceira da Meta que entrega a API pronta dentro de um painel. Quem pergunta o que é API do WhatsApp quase sempre já está escolhendo entre esses dois, mesmo sem saber.

API oficial ou não oficial: o risco é o número

A API não oficial existe porque é fácil e barata de ligar. Um programa abre o WhatsApp Web, você lê o QR code, e ele passa a mandar e receber mensagens no seu lugar. Daí os vídeos de "API grátis e ilimitada".

O problema está nos termos de serviço do WhatsApp, em vigor desde 2021. Eles proíbem "mensagens automáticas" e o acesso ao serviço "por meios automatizados" sem autorização, e avisam que a conta pode ser desativada ou suspensa. Um agente ligado pelo QR code faz exatamente isso: manda mensagem automática por um acesso que a Meta não autorizou.

Na prática, quem usa a API não oficial do WhatsApp aposta que não vai ser pego. Às vezes passa meses funcionando. Quando cai, vai junto o número da empresa, que os clientes têm salvo no celular, e não existe a quem reclamar. Um cliente meu, de gestão patrimonial, pôs a API não oficial na lista de riscos antes de qualquer conversa sobre o que o agente faria. Era o risco certo pra olhar primeiro.

Quanto custa a API oficial do WhatsApp: são três contas

Quem procura API oficial WhatsApp preço costuma achar só a tabela da Meta. Ela é a primeira conta, e a única igual pra todo mundo.

Desde julho de 2025, a Meta cobra por mensagem entregue, conforme a categoria. No Brasil, a tabela em reais que vale desde 1º de outubro de 2026 fica assim:

A linha que mais mexe com quem vai ligar um agente é a última. De novembro de 2024 até setembro de 2026, responder quem chamou era de graça. Em 1º de outubro de 2026, a Meta voltou a cobrar: cada número tem mil mensagens de serviço grátis por mês, e a partir da milésima primeira paga. Boa parte do que aparece na busca ainda diz que atendimento não custa nada. E um agente que responde rápido, em várias mensagens curtas, gasta essa cota bem antes de uma pessoa.

Algumas coisas continuam saindo de graça: qualquer mensagem nas 72 horas depois que a pessoa chega por um anúncio de clique para o WhatsApp, e o modelo de utilidade mandado dentro da janela de 24 horas.

A segunda conta é a do provedor: mensalidade, valor por atendente ou por número, às vezes uma margem em cima da mensagem da Meta. Ela muda de um pra outro, e é ali que mora o "conforme consumo" sem explicação. Peça a proposta com a parte da Meta separada da parte do provedor.

A terceira é a da IA. O agente usa um modelo de linguagem, como os da OpenAI, da Anthropic ou do Google, e cada resposta consome tokens que alguém paga. A Meta também vende o próprio agente, o Meta Business Agent, cobrado por token: pela conta da mesma página de preços, sai a uns 4 a 5 centavos de dólar por mensagem. Fora da proposta fica ainda o tempo de alguém escrevendo as regras e conferindo as respostas nas primeiras semanas.

Como ligar um agente de IA na API oficial

Por baixo de qualquer plataforma, o caminho é o mesmo. A mensagem chega no número, a Meta avisa o seu sistema, o agente lê, consulta o que precisa (agenda, CRM, tabela de preço), escreve a resposta e devolve pela API. O que muda de um provedor pra outro é quanto disso já vem pronto.

Pra chegar lá, a Meta pede pouca coisa:

1. Um portfólio empresarial na Meta, o antigo Business Manager, com os dados da empresa. A verificação dela costuma entrar quando o volume cresce.
2. Um número que receba o código de confirmação. Se ele já roda no aplicativo WhatsApp Business, dá pra ligar a API sem largar o aplicativo, pela coexistência com o aplicativo que a Meta oferece por meio de provedores. Tem perda: os grupos não sincronizam, e só o histórico dos últimos seis meses vem junto.
3. Permissão de quem vai receber. A política da Meta exige o consentimento da pessoa antes de a empresa puxar conversa.

Depois vem a regra que mais muda o desenho do agente, a janela de atendimento. Quando o cliente manda mensagem, abre uma janela de 24 horas em que a empresa responde do jeito que quiser. Fechou a janela, só sai mensagem a partir de um modelo aprovado antes pela Meta. O agente que promete "te mando o orçamento amanhã à tarde" precisa de um modelo aprovado pra cumprir a promessa, ou alguém vai ter que escrever de novo pelo celular.

Muita gente leu que a Meta proibiu IA no WhatsApp. Os termos que entraram em vigor em janeiro de 2026 miraram as empresas cujo produto principal é o próprio chatbot, os assistentes de uso geral que conversam sobre qualquer coisa. No Brasil, essas empresas seguem na plataforma pagando uma tabela própria. A Meta disse ao TechCrunch, em outubro de 2025, que a mudança não afeta empresa que usa IA pra atender os próprios clientes. O agente da sua loja, da sua clínica ou do seu escritório continua permitido.

O que precisa estar escrito antes de ligar

A API não decide nada. Ela entrega a mensagem e leva a resposta, e o que o agente responde é você quem define. Antes de ligar, estas decisões precisam estar no papel:

• O caminho até uma pessoa. A política de mensagens do WhatsApp, atualizada em 2026, permite automação dentro da janela de 24 horas, desde que a empresa tenha à mão um caminho rápido, claro e direto pra pessoa sair do robô: passar pra um atendente no chat, um telefone, um e-mail. Sem esse caminho, o agente fica fora da regra da plataforma.
• O que ele responde sozinho e o que sempre passa por você. Horário e segunda via saem direto. Desconto, prazo, cancelamento e reclamação esperam o seu ok.
• Quais modelos de mensagem pedir à Meta, e em que categoria. Lembrete com oferta no meio costuma ser classificado como marketing, e marketing custa quase dez vezes mais que utilidade.
• De quem são o número e as regras. Confirme antes de assinar que os dois saem com você se trocar de provedor.

Nenhuma dessas linhas vem pronta no painel do provedor. Quem escreve é quem conhece a empresa, e essa decisão continua sendo sua. No post sobre o agente de IA para WhatsApp, eu mostrei como testar essas regras com conversas antigas, num assistente que você já tem, antes de ligar qualquer coisa. E nas primeiras semanas, mesmo ligado, o agente escreve e você aprova antes de sair.

Antes de assinar, conte as conversas de um mês

O primeiro passo do protocolo antivibe, o método que eu uso antes de construir qualquer coisa, é mapear o terreno: olhar o trabalho como ele acontece hoje, antes de escolher a ferramenta. Aqui, isso cabe numa tarde.

Exporte um mês de conversas do WhatsApp da empresa e marque, em cada uma:

• Quem começou. Conversa que o cliente abriu cai na janela de 24 horas e conta como serviço. Conversa que a empresa abriu precisa de modelo aprovado e paga como utilidade ou marketing.
• O que era. Pergunta repetida, pedido, reclamação, aviso, promoção.
• O que pediu decisão. Tudo que mexeu em preço, prazo ou dinheiro.

Com isso, você multiplica pela tabela da Meta e sabe a parte dela antes de abrir qualquer proposta. Fica claro também se o seu número passa das mil mensagens de serviço do mês, e quanto do trabalho o agente faria sem você. Se quase tudo cai em "pediu decisão", o primeiro trabalho do agente é organizar a fila pra você, e responder o cliente fica pra depois.

Volte àquelas duas propostas da terça depois do almoço. Com a contagem na mão, a linha "conforme consumo" vira um número que você mesmo calculou, e a proposta ilimitada pelo QR code fica do tamanho do risco que traz: o número da empresa.

Montei uma página sobre a assistente de IA no WhatsApp que eu uso no estúdio, pra quem quer ver um agente desses trabalhando numa empresa pequena. E se você quer fazer essa conta com alguém e desenhar o que o agente faz sozinho, entre em contato.