Quem procura como colocar um agente de IA para atender no WhatsApp cai, cedo ou tarde, num tutorial de Evolution API. A promessa é sedutora: um servidor barato, um QR Code lido no celular e, em uma tarde, o robô está respondendo cliente sem nenhuma aprovação da Meta e sem pagar por mensagem.
O que quase nenhum desses tutoriais diz é que a própria Evolution API oferece dois jeitos de se conectar ao WhatsApp, e que só um deles é oficial. Este artigo separa a ferramenta da conexão, mostra o que os Termos de Serviço do WhatsApp dizem com todas as letras e dá um critério simples para decidir qual número da empresa pode correr o risco e qual não pode.
O que é a Evolution API?
A Evolution API é uma API REST de código aberto que faz a ponte entre o WhatsApp e outros sistemas: CRM, plataforma de atendimento, automação ou um agente de IA. Em vez de alguém responder pelo celular, as mensagens entram por essa API, são processadas por outro software e a resposta volta pelo mesmo caminho.
O projeto nasceu como um controlador de WhatsApp baseado no CodeChat, que por sua vez usava a biblioteca Baileys, e hoje é mantido pela Evolution Foundation. Segundo o repositório oficial no GitHub, ele se integra a ferramentas como Typebot, Chatwoot, Dify e OpenAI, além de filas de mensagens e armazenamento de mídia. É por isso que aparece em tantos projetos de chatbot: ele é a tomada onde o resto se pluga.
Um ponto que costuma passar batido: a Evolution API não é um serviço que se contrata, é um software que alguém precisa instalar, hospedar, atualizar e vigiar. Quem diz que ela é “grátis” está falando da licença, não do trabalho de manter o servidor de pé.
A Evolution API é oficial do WhatsApp?
Não. A Evolution API é um projeto independente, sem relação com a Meta. Mas a pergunta certa não é se o software é oficial, e sim por qual porta ele entra no WhatsApp. E aqui está o detalhe que muda tudo: ela pode entrar por duas portas diferentes.
Ou seja: dá para usar a Evolution API inteiramente dentro das regras, conectada à API oficial. O que os tutoriais vendem como “API gratuita do WhatsApp” é só um dos modos, o Baileys, e é nele que mora o risco.
Qual a diferença entre o modo Baileys e a Cloud API?
O Baileys é uma biblioteca que conversa com o WhatsApp Web por WebSocket, como se fosse mais um aparelho conectado à conta. O próprio README do Baileys avisa que o projeto não é afiliado, autorizado nem endossado pelo WhatsApp, e que seus mantenedores desencorajam o uso para mensagens em massa ou automatizadas. A Cloud API é o caminho que a Meta abriu para empresas, com cadastro, regras e cobrança.
| Modo Baileys (WhatsApp Web) | Modo Cloud API (oficial) | |
|---|---|---|
| Quem autoriza | Ninguém: a conexão imita um aparelho no WhatsApp Web | A Meta, pela plataforma do WhatsApp Business |
| Como liga | Lendo um QR Code ou código de pareamento no celular | Registrando o número na plataforma da Meta |
| Custo de mensagem | Nenhum cobrado pelo WhatsApp | Pode haver cobrança por mensagem, conforme a categoria |
| Regras | Os Termos de Serviço do WhatsApp comum, que vetam automação não autorizada | As políticas da Meta para empresas, que preveem a automação |
| Estabilidade | Depende de a biblioteca acompanhar cada mudança do WhatsApp Web | Interface documentada e mantida pela Meta |
| Se der errado | O número pode ser suspenso, e a empresa fica sem canal | Há regras de qualidade e caminhos formais de recurso |
Comparativo elaborado pela Alliance Comunicação com base no README da Evolution API, no README do Baileys e nos Termos de Serviço do WhatsApp.
Repare que a última linha não fala de tecnologia. Fala de quem fica com o prejuízo. É aí que a decisão deixa de ser do time técnico e passa a ser da diretoria.
O que os Termos de Serviço do WhatsApp dizem sobre automação?
Os tutoriais costumam resumir com “há risco de banimento” e seguir em frente. Vale ler o texto. Os Termos de Serviço do WhatsApp, com data de vigência de 4 de janeiro de 2021, tratam do assunto em duas cláusulas da seção de uso aceitável.
Há mais três trechos que interessam a quem pensa em ligar um robô pelo WhatsApp Web. O primeiro veda o uso não pessoal do serviço sem autorização; o atendimento de uma empresa por um agente de IA é, por definição, uso não pessoal. O segundo proíbe distribuir o serviço por uma rede em que possa ser usado por vários dispositivos ao mesmo tempo, salvo pelas ferramentas que o próprio WhatsApp oferece.
O terceiro é o que dói: quando a conta é desativada ou suspensa, o usuário concorda em não criar outra conta sem permissão. Na prática, não existe “trocar de chip e seguir” dentro das regras. E a seção de encerramento deixa claro que o WhatsApp pode suspender o acesso a qualquer momento se a pessoa violar a letra ou o espírito dos Termos.
Nada disso se aplica à Cloud API do mesmo modo, porque ali a automação é justamente o que foi autorizado. As regras da plataforma oficial são outras, e uma delas, a de 2026 sobre provedores de IA, explicamos no artigo sobre o que a Meta proíbe nos chatbots com IA.
A Evolution API dá ban no WhatsApp?
O software, por si, não dá ban em ninguém. O que pode levar à suspensão é o modo de conexão somado ao comportamento: um número ligado pelo WhatsApp Web que dispara mensagens em volume, responde em segundos a qualquer hora e recebe denúncias de quem não pediu o contato reúne exatamente o que os Termos descrevem como uso não autorizado.
Ninguém fora da Meta sabe com precisão qual combinação de sinais derruba uma conta, e a empresa não publica esse critério. Por isso desconfie de quem promete “configuração anti-ban”. Intervalo aleatório entre mensagens e aquecimento de chip são vendidos como proteção, mas não mudam o que está escrito: a conta continua usando o serviço de um jeito que o contrato não autoriza.
O inverso também pode acontecer: um número nunca ser suspenso. A questão não é se o número vai cair, é o que acontece com o negócio se ele cair numa segunda-feira de manhã.
O que a empresa perde quando o número cai?
Muito mais do que o canal. O número do WhatsApp de uma empresa costuma estar impresso no cartão, na fachada, no Google Perfil da Empresa, nos anúncios e na assinatura de e-mail de cada vendedor. É o endereço que o cliente salvou na agenda. Quando ele é suspenso, cada um desses pontos passa a levar a uma conversa que ninguém responde.
- O canal de entrada. Leads de anúncio que caem no número suspenso se perdem enquanto ninguém percebe.
- O histórico. Conversas que existiam só no aparelho e no WhatsApp Web deixam de estar acessíveis no app; se não havia cópia num CRM, o contexto de cada cliente some junto.
- A agenda do cliente. Trocar de número significa pedir a toda a base que salve um contato novo, e parte dela não salva.
- O material impresso e os cadastros. Fachada, embalagem, catálogo e perfis em diretórios precisam ser refeitos.
- O tempo do time. Recurso, troca de número e reconfiguração de integrações consomem dias de quem deveria estar vendendo.
É por isso que o histórico precisa morar fora do celular, num sistema da empresa, e não apenas no aparelho. Explicamos o porquê no artigo sobre CRM com WhatsApp e o histórico que fica no celular.
Quanto custa a Evolution API de verdade?
A licença não custa nada, mas tem condição. O arquivo de licença do projeto diz que a Evolution API segue a Apache 2.0 com condições adicionais: quem usa os componentes de interface não pode remover nem alterar o logotipo e os créditos, e quem a embute em qualquer projeto, inclusive software fechado, precisa exibir um aviso claro de que a Evolution API está sendo usada, visível para os administradores. Descumprir pode exigir uma licença comercial, a critério do produtor.
Fora a licença, a conta tem três partes. A primeira é o servidor: a API precisa de uma máquina ligada o tempo todo, com banco de dados e, em geral, um cache. A segunda é a manutenção: o WhatsApp Web muda, a biblioteca precisa acompanhar e cada atualização tem de ser testada. A nota da versão 2.3.7, publicada em dezembro de 2025, lista correções para mensagens que paravam de chegar depois de uma reconexão e para mensagens perdidas, e registra a atualização do Baileys para uma versão candidata, a 7.0.0-rc.9.
A terceira parte é a mensagem, e ela só existe no modo oficial: na Cloud API, a Meta cobra por mensagem conforme a categoria do template. Não vamos repetir a tabela aqui; ela está detalhada no artigo sobre o que a empresa paga de verdade na WhatsApp Business API. O ponto é comparar o custo da mensagem com o custo do número suspenso, não com zero.
Como decidir qual número vai por qual conexão?
A decisão cabe em duas perguntas, e nenhuma delas é técnica. A primeira: esse número atende cliente? A segunda, para os que não atendem: perder esse número causaria prejuízo?
1. Número de atendimento e vendas: conexão oficial
É o número que está no site, nos anúncios e na fachada. Se um agente de IA vai responder por ele, a conexão é a Cloud API, mesmo que a orquestração continue na Evolution API. Ganha-se previsibilidade e um contrato que prevê a automação; paga-se por mensagem e aceita-se a regra de templates.
2. Número interno ou de avisos: depende do prejuízo
Um número que só manda lembretes para a equipe ou recebe alertas de sistema não atende cliente, mas pode ser importante. Se a queda dele paralisaria uma operação, trate-o como número de atendimento. Se a perda for só um incômodo, a decisão é de custo-benefício, tomada por escrito.
3. Número de teste e laboratório: a não oficial é tolerável
Para prototipar um agente, testar um fluxo no n8n ou mostrar uma prova de conceito à diretoria, um chip novo ligado pelo modo Baileys é um ambiente barato e rápido. A regra é que ele nunca receba o número da marca e nunca converse com cliente real. Quando o projeto for aprovado, migra-se para a conexão oficial antes de ir ao ar.
Antes de ligar qualquer agente a cliente de verdade, vale ainda testá-lo com conversas simuladas. O roteiro desse ensaio está no artigo sobre como criar um agente de IA e testá-lo antes do cliente.
Onde entram o agente de IA, o n8n e a LGPD?
Na arquitetura mais comum, a Evolution API recebe a mensagem, um orquestrador como o n8n decide o que fazer e um modelo de linguagem escreve a resposta. A própria nota da versão 2.3.7 menciona melhorias na integração com o n8n, e os tutoriais mostram a ligação por requisição HTTP. Nada disso muda o que foi dito sobre a conexão: o agente pode ser excelente e o número, ainda assim, estar pendurado na porta errada.
O n8n tem as suas próprias regras de licença, que tratamos no artigo sobre o que é o n8n e onde o gratuito tem regra. Somadas, as duas licenças pedem que alguém na empresa saiba o que está instalado e sob quais condições.
Há também a LGPD. Quando a empresa hospeda a Evolution API no próprio servidor, as conversas dos clientes, com nome, telefone e o que mais for dito, passam a ficar guardadas numa máquina sob responsabilidade dela. O art. 46 da Lei Geral de Proteção de Dados exige que os agentes de tratamento adotem medidas de segurança técnicas e administrativas para proteger esses dados de acesso não autorizado, perda ou vazamento, e o § 2º diz que isso vale desde a concepção do serviço.
Na prática: servidor com acesso restrito, chave da API fora do código, backup do banco, prazo para apagar conversas antigas e registro de quem acessa. Um servidor montado numa tarde por tutorial raramente tem tudo isso.
Quais os erros mais comuns com a Evolution API?
- Ligar o número principal pelo QR Code. É o erro mais caro, porque coloca na conexão não oficial justamente o número que a empresa não pode perder.
- Confundir a licença gratuita com custo zero. Servidor, manutenção e as horas de quem atualiza a biblioteca entram na conta.
- Ignorar a condição da licença. Embutir a Evolution API num produto sem o aviso de uso visível aos administradores pode exigir licença comercial.
- Acreditar em “configuração anti-ban”. Atraso entre mensagens não transforma uso não autorizado em autorizado.
- Deixar o histórico só no WhatsApp. Sem cópia num CRM, a queda do número leva junto o contexto de cada cliente.
- Esquecer a segurança do servidor. Painel exposto na internet e chave de API padrão deixam as conversas dos clientes ao alcance de qualquer um.
- Disparar para quem não pediu. Mensagem em massa para lista comprada é o comportamento que os Termos citam por nome, em qualquer conexão.
O risco da Evolution API não está no código aberto. Está em pendurar o número da marca na porta que o WhatsApp não autorizou.
O que muda por tipo de negócio?
O critério das duas perguntas vale para todos, mas o peso do número muda conforme o modelo:
| Tipo de negócio | Como costuma estar o número | Conexão indicada para o agente de IA |
|---|---|---|
| Comércio e serviço local | Um único número na fachada, no Google e nos anúncios | Oficial: é o principal canal de venda |
| E-commerce | Número de suporte e pós-venda com alto volume de mensagens | Oficial, com templates de utilidade para pedido e entrega |
| B2B de ciclo longo | Números de vendedores, às vezes pessoais | Oficial no número comercial; tirar o histórico dos celulares pessoais |
| Agência ou software house | Números de teste para prototipar fluxos de clientes | Não oficial só no laboratório; oficial antes de entregar |
| Operação interna | Número de avisos para equipe ou alertas de sistema | Depende do prejuízo de perdê-lo; decidir por escrito |
Se a sua empresa ainda não sabe onde o WhatsApp entra na jornada do cliente, comece por esse mapa. O diagnóstico de marketing gratuito mostra em que etapas o atendimento pesa mais e o que vale automatizar primeiro.
Por onde começar hoje
- Liste todos os números de WhatsApp da empresa e onde cada um aparece.
- Para cada um, responda às duas perguntas: atende cliente? Perdê-lo causaria prejuízo?
- Verifique quais estão hoje conectados pelo WhatsApp Web a algum sistema ou robô.
- Migre os números de atendimento para a Cloud API antes de ligar o agente de IA; a Evolution API pode continuar como orquestradora.
- Leve o histórico das conversas para um CRM, fora do celular.
- Revise o servidor: acesso restrito, chave fora do código, backup e prazo de retenção das conversas.
- Mantenha a conexão não oficial apenas em chips de teste, sem contato com clientes reais.
A Evolution API é uma boa ferramenta, e escolher a conexão certa não significa abrir mão dela. Significa decidir com clareza qual número a empresa pode arriscar. Se o próximo passo é colocar um agente para atender de verdade, nossa equipe de agentes de IA desenha essa arquitetura com a conexão oficial desde o primeiro dia.