O que é a WhatsApp API?
A WhatsApp API é a forma de conectar um número de WhatsApp a um sistema externo, como um CRM, um chatbot ou um agente de IA, para enviar e receber mensagens de forma programada, sem alguém responder manualmente no celular. Existem a API oficial da Meta, chamada WhatsApp Business Platform, e APIs não oficiais, como a Evolution API.
A diferença para o aplicativo comum é o propósito. O app foi feito para uma pessoa digitar e ler mensagens. A API foi feita para sistemas: cada mensagem recebida vira um evento que o seu software processa, e cada resposta pode ser enviada por código. É isso que permite atender várias conversas ao mesmo tempo, registrar leads automaticamente e colocar uma IA respondendo.
A escolha entre API oficial e não oficial muda o custo, o risco de bloqueio e a complexidade de configuração. Não é só uma questão técnica, é uma decisão de negócio que depende do volume, do tipo de mensagem e do quanto a operação pode ficar parada. Por isso vale entender o funcionamento e as diferenças antes de escolher, em vez de decidir só pela facilidade de configuração.
- Conecta um número de WhatsApp a sistemas externos, como CRM, chatbot ou agente de IA.
- Permite enviar e receber mensagens por código, sem operação manual no celular.
- Tem duas famílias: a API oficial da Meta e as APIs não oficiais, como a Evolution API.
- Não responde nada sozinha: quem decide a resposta é o sistema ou o agente por trás dela.
Como a WhatsApp API funciona na prática
O funcionamento se baseia em dois movimentos. Quando chega uma mensagem, a API avisa o seu sistema por um webhook, que é um endereço na internet para onde ela envia os dados da conversa. Quando o seu sistema quer responder, ele chama a API com o número de destino e o texto. Todo o resto, como decidir a resposta ou registrar o lead, acontece no seu backend.
Num atendimento com IA, o backend recebe a mensagem pelo webhook, envia o texto a um modelo de linguagem junto com as instruções do agente e o histórico, e devolve a resposta pela API. Um Cloudflare Worker ou uma Supabase Edge Function costumam bastar para esse papel em operações pequenas e médias.
- Mensagem recebida: a API envia os dados da conversa para o webhook do seu sistema.
- Processamento: o backend decide o que fazer, por exemplo consultar um modelo de IA ou o CRM.
- Resposta: o backend chama a API para enviar a mensagem de volta ao cliente.
- Monitoramento: alguém precisa saber quando a conexão cai, para o atendimento não parar em silêncio.
API oficial vs. não oficial: comparativo por critério
A API oficial da Meta exige cadastro da empresa, aprovação e segue as regras da plataforma, como modelos de mensagem aprovados para iniciar conversas fora da janela de atendimento de 24 horas. Em troca, é o caminho suportado pela Meta e o mais seguro para operações grandes. As não oficiais, como a Evolution API e bibliotecas como a Baileys, se conectam como o WhatsApp Web, bastando ler um QR Code.
Para testar uma ideia ou operar em pequena escala respondendo quem chegou por conta própria, a não oficial costuma bastar. Para operação grande, crítica ou com disparo frequente, vale migrar para a oficial. O ponto central é honestidade sobre o risco: a não oficial roda num modelo que a Meta não reconhece oficialmente.
- Configuração — oficial: cadastro, verificação da empresa e aprovação; não oficial: ler um QR Code e conectar.
- Custo — oficial: cobrança da Meta por mensagem, conforme categoria e país; não oficial: sem cobrança da Meta, mas com custo de servidor.
- Risco de bloqueio — oficial: menor, desde que siga as políticas; não oficial: maior, principalmente com volume alto de envio.
- Melhor uso — oficial: grande volume e operação crítica; não oficial: validar ideias e atender quem pediu contato em escala menor.
WhatsApp, WhatsApp Business e WhatsApp API: qual a diferença?
Os três nomes confundem porque compartilham a mesma marca. O WhatsApp comum é o aplicativo pessoal. O WhatsApp Business é um aplicativo gratuito com recursos para pequenas empresas, como perfil comercial, catálogo, etiquetas e respostas rápidas, mas continua sendo operado por uma pessoa. A WhatsApp API é a camada de integração para sistemas, sem interface de aplicativo.
Na prática, muitos negócios começam no WhatsApp Business e migram para a API quando o volume de conversas passa do que a equipe consegue responder, ou quando querem colocar um agente de IA atendendo e integrar com CRM e checkout. Essa migração não precisa ser de uma vez: dá para manter o app para conversas pontuais e usar a API num número dedicado ao atendimento automatizado.
- WhatsApp: uso pessoal, operado manualmente no celular.
- WhatsApp Business: app para pequenas empresas, com recursos comerciais, ainda operado por uma pessoa.
- WhatsApp API: integração com sistemas, para automação, CRM e agentes de IA.
- Sinal para migrar para a API: leads esperando resposta ou a equipe repetindo as mesmas respostas o dia todo.
Como montar uma automação com WhatsApp API, passo a passo
O caminho mais rápido para quem quer colocar um agente de IA atendendo é começar pela Evolution API e um backend serverless, validar com conversas reais e só depois avaliar a migração para a API oficial. O Claude Code, ferramenta de linha de comando da Anthropic que roda em macOS, Windows e Linux, monta o webhook, a conexão com o modelo de IA e os testes a partir de instruções em português.
O passo que mais se pula é o teste. Antes de divulgar o número, simule mensagens fora do padrão, perguntas que o conteúdo não cobre e pedidos para falar com uma pessoa. É nesses casos que um agente mal configurado erra. Corrija o prompt e o conteúdo de base até o agente lidar bem com esses cenários.
- 1. Escolha a via: Evolution API para começar rápido ou API oficial da Meta para operação formal e maior volume.
- 2. Conecte um número dedicado, pelo QR Code na Evolution API ou pelo cadastro na plataforma da Meta.
- 3. Configure o webhook que recebe as mensagens e as envia ao sistema de resposta, como um modelo de IA.
- 4. Escreva as instruções do agente e a regra de passagem para humano.
- 5. Teste de ponta a ponta, incluindo erros e mensagens inesperadas, antes de divulgar.
Custos, limites e cuidados com a WhatsApp API
Nenhuma via é totalmente gratuita em escala. A API oficial tem cobrança da Meta por mensagem, que varia com a categoria e o país e deve ser consultada na tabela oficial. A não oficial não tem essa cobrança, mas exige servidor para rodar e, se houver IA, o custo do modelo de linguagem, que cresce com o volume de conversas.
O cuidado mais importante vale para qualquer via: evitar disparo em massa para quem não pediu contato. Essa é a principal causa de bloqueio de número. Também vale monitorar a conexão, porque uma instância desconectada sem aviso pode significar dias sem atendimento automático. Um alerta simples de desconexão, por e-mail ou mensagem para a equipe, já evita esse problema.
- API oficial: cobrança da Meta por mensagem, conforme categoria e país.
- API não oficial: custo de servidor e maior risco de bloqueio.
- Modelo de IA: custo por uso, com plano gratuito do Gemini para validar.
- Use número dedicado e monitore a conexão para não perder atendimento em silêncio.
WhatsApp Oficial: Automatize Disparos em Massa com IA (Meta API)
Na ZX LAB, parte do atendimento roda com a Evolution API conectada a um agente de IA: o número funciona como um WhatsApp normal, mas cada mensagem recebida passa por um webhook antes de virar resposta automática. Não é a API oficial da Meta, e sim uma camada que se conecta como o WhatsApp Web; funciona bem para operações menores, e quem precisa de grande volume costuma migrar para a API oficial. Rafael Castro, fundador da ZX LAB, ensina essa escolha aos mais de 15 mil alunos da escola.