Evolution API

A Evolution API transforma o WhatsApp numa API REST: seu sistema envia e recebe mensagens por chamadas HTTP e eventos. Mantida pela Evolution Foundation, ela nasceu como um controlador baseado na biblioteca Baileys e hoje também conversa com a WhatsApp Cloud API, que é a oficial da Meta.

Para que serve

• Ligar um número de WhatsApp a um chatbot feito em Typebot, Dify ou Flowise.
• Levar as conversas para o Chatwoot e atender pelo painel dele.
• Disparar automações no n8n a partir de mensagens recebidas.
• Publicar eventos em filas como RabbitMQ, Kafka ou Amazon SQS e guardar mídia em S3 ou MinIO.

Como começar

O servidor pede Node.js 20 ou mais novo, PostgreSQL ou MySQL e, de preferência, Redis. Com o arquivo .env configurado, o README sobe tudo com Docker:

docker run -p 8080:8080 --env-file .env evoapicloud/evolution-api:latest

Depois você escolhe o tipo de conexão. A Baileys é gratuita e usa a versão web do WhatsApp; o próprio README avisa que ela tem limitações em relação às APIs oficiais. Por ser uma conexão não oficial, use um número dedicado a ela, nunca o número principal do atendimento. A Cloud API segue as políticas da Meta e pode cobrar por mensagem.

Licença e custo

A licença é Apache 2.0 com condições extras. O uso comercial é permitido, inclusive como backend de outro produto. Se você usa o frontend, não pode tirar o logo nem o aviso de copyright do console. E todo sistema que inclui a Evolution API, mesmo de código fechado, precisa mostrar aos administradores um aviso claro de que usa o projeto; quem não cumpre pode ter de comprar licença comercial. O site oficial não informa planos pagos.

Quando vale a pena

É indicada para desenvolvedores e agências que integram WhatsApp a sistemas próprios e aceitam manter um servidor. Para operação de alto volume ou que não pode parar, a API oficial pela Cloud API é o caminho mais seguro; o Atraca explica as diferenças em WhatsApp Business API. Para ligar o WhatsApp a um CRM de marketing, veja Integração WhatsApp + Mautic.