Evolution API: Tutorial Completo (sem dor de cabeça)
Evolution API é a alternativa open-source gratuita pra API do WhatsApp. Explico como começar sem se perder em setup.
O que é Evolution API
Projeto open-source brasileiro que permite integrar WhatsApp com qualquer sistema via REST API.
É usado por milhões de empresas (porque é grátis e funciona).
Como funciona
Evolution emula o WhatsApp Web. Você conecta seu WhatsApp escaneando QR uma vez, e depois pode mandar/receber mensagens via endpoints HTTP.
Setup local (pra dev)
docker run -d \ --name evolution \ -p 8080:8080 \ -e AUTHENTICATION_API_KEY=sua-chave \ atendai/evolution-api
Depois acessa localhost:8080/manager pra gerar QR e conectar.
Endpoints principais
- POST /message/sendText/:instance — manda texto
- POST /message/sendMedia/:instance — manda imagem/vídeo/áudio
- POST /webhook/set/:instance — configura webhook pra receber
- GET /instance/connectionState/:instance — status conexão
Problemas comuns
- ⚠️ Desconexões frequentes — solução: rodar em VPS confiável, não em casa
- ⚠️ Ban de número — solução: não mandar spam, respeitar ritmo humano
- ⚠️ Mídia não chega — solução: Evolution precisa acesso a internet estável
Alternativa sem setup
Se você não quer mexer com Docker/VPS/setup, o PotenciaPVP já tem Evolution pré-configurada rodando num servidor estável. Você só conecta seu WhatsApp e pronto.
Quando vale fazer setup próprio
- Você é dev
- Quer personalizar ao extremo
- Tem equipe técnica
Quando vale usar solução gerenciada
- Não é dev
- Quer focar em vendas, não infra
- Prefere pagar R$ 29,90/mês do que cuidar de VPS