TL;DR (EN): A ready-to-use AI agent skill / knowledge pack for Evolution Go (the Go + whatsmeow WhatsApp REST API), extracted from the source code and covering v0.7.2 (incl. passkey/WebAuthn pairing). Drop it into Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Windsurf, Cline — or any AI coding tool — so your assistant integrates Evolution Go correctly, without burning tokens re-learning the API. Unofficial, community-made. PT-BR content (the Evolution Go community is mostly Brazilian).
Uma skill de agente de IA pronta pra usar sobre a Evolution Go — a API REST de WhatsApp em Go (Gin + whatsmeow) da Evolution Foundation. Foi extraída do código-fonte (não da doc de marketing), cobre a v0.7.2 (com pareamento por passkey/WebAuthn), e transforma o conhecimento da API num pacote que o seu assistente de código consulta sob demanda — sem gastar token e tempo reaprendendo a Evo Go a cada sessão.
⚠️ Não oficial. Pacote da comunidade, sem afiliação com a Evolution Foundation. VerNOTICE.
-
SKILL.md— o mapa mestre: auth, envelope, formato de JID, tabela de rotas, receita mínima, pegadinhas. -
AGENTS.md— roteador multi-ferramenta (lido por Codex/Cursor/Windsurf/Zed/… automaticamente). -
reference/— 12 arquivos de referência exaustivos (um por domínio):instances·connection-states·passkey·messages·interactive·chat-ops·user-profile·groups·newsletter-labels·webhooks-events·deploy-config·recipes
Como funciona: o SKILL.md/AGENTS.md é um roteador fino; o agente lê o arquivo de reference/
certo sob demanda (divulgação progressiva). Isso funciona em qualquer ferramenta que consiga ler arquivos
do repositório — não precisa carregar 4.700 linhas de contexto de uma vez.
Copie a pasta pra sua pasta de skills — ela já vira uma skill nativa (com divulgação progressiva):
# global (todas as sessões)
cp -r evolution-go-skill ~/.claude/skills/evolution-go
# OU por projeto
cp -r evolution-go-skill .claude/skills/evolution-goNo claude.ai/Claude Desktop, você também pode compactar a pasta e subir como Skill (o SKILL.md fica na raiz do zip).
O Cursor lê AGENTS.md automaticamente. Pra uma regra dedicada, este repo também traz
.cursor/rules/evolution-go.mdc — copie a pasta .cursor/ (e reference/) pro seu projeto, ou adicione
este repo como submódulo/pasta de referência e @-mencione os arquivos.
Copie .github/copilot-instructions.md pro seu projeto (o Copilot injeta esse arquivo no contexto).
Mantenha a pasta reference/ acessível pro modelo abrir os arquivos citados.
Lê AGENTS.md na raiz automaticamente. Basta ter este repo (ou seu conteúdo) no diretório de trabalho.
Copie .windsurf/rules/evolution-go.md (trigger model_decision) pro seu projeto.
Copie .clinerules pro seu projeto.
Aponte o assistente pra este repositório / pra pasta reference/, ou cole os links crus dos arquivos que
interessam. É tudo markdown — funciona em qualquer lugar.
Evolution Go v0.7.2. Inclui: instâncias e conexão (QR, pairing code, passkey/WebAuthn), gestão de estado de conexão (quedas/reconexão), envio (texto/mídia/áudio/enquete/sticker/localização/contato/status, botões incl. PIX, listas, carrossel), operações de mensagem/chat, usuário/perfil/privacidade, grupos e comunidades, newsletters e labels, webhooks + catálogo completo de eventos e payloads, transportes (RabbitMQ/NATS/WebSocket), storage de mídia (MinIO/S3), licença/Manager, banco (Postgres/GORM), proxy, deploy e erros.
- Descreve/cita o projeto
evolution-foundation/evolution-go(Apache-2.0). Esses trechos permanecem sob a licença original. - Este pacote de referência (o texto original, tabelas, exemplos e guias) é MIT — ver
LICENSE. - Não oficial, sem afiliação/endosso da Evolution Foundation. Marcas citadas apenas para referência. Ver
NOTICE.
Achou algo desatualizado (a Evo Go evolui rápido) ou um comportamento diferente do documentado? Abra uma issue/PR com o trecho do código-fonte que comprova. A regra do pacote é simples: o código-fonte é a verdade.