evolution-api-v2

N8N Community Node for Evolution API v2

Package Information

Released: 8/6/2025
Downloads: 33 weekly / 82 monthly
Latest Version: 1.1.11
Author: JF Cardoso Santos

Available Nodes

Evolution API
No description available

Documentation

N8N Evolution API v2 Community Node

Este é um community node para o N8N que permite integração com a Evolution API v2 para WhatsApp.

🚀 Funcionalidades

  • Gerenciamento de Instâncias: Criar, conectar, desconectar e gerenciar instâncias do WhatsApp
  • Envio de Mensagens: Enviar mensagens de texto e mídia
  • Gerenciamento de Grupos: Criar grupos e buscar membros
  • Verificação de Chat: Verificar se um número é WhatsApp
  • Webhooks: Configurar webhooks para eventos
  • Integrações: Suporte para integração com Chatwoot

📦 Instalação

Via NPM (Recomendado)

npm install n8n-nodes-evolution-api-v2

Via N8N Community Nodes

  1. Vá para Settings > Community Nodes
  2. Clique em Install
  3. Digite: n8n-nodes-evolution-api-v2
  4. Clique em Install

🔧 Configuração

Credenciais

  1. Crie uma nova credencial do tipo Evolution API
  2. Configure:
    • Server URL: URL do seu servidor Evolution API
    • API Token: Token de autenticação da API

Recursos Disponíveis

Instância

  • Criar Instância: Cria uma nova instância do WhatsApp
  • Buscar Instâncias: Lista todas as instâncias disponíveis
  • Conectar Instância: Conecta a uma instância específica
  • Reiniciar Instância: Reinicia uma instância
  • Estado da Conexão: Verifica o estado da conexão
  • Logout: Faz logout de uma instância
  • Deletar Instância: Remove uma instância
  • Definir Presença: Define o status de presença

Mensagem

  • Enviar Texto: Envia uma mensagem de texto
  • Enviar Imagem: Envia uma imagem com legenda

Grupo

  • Criar Grupo: Cria um novo grupo
  • Buscar Membros: Lista membros de um grupo

Chat

  • Verificar WhatsApp: Verifica se um número é WhatsApp

Evento

  • Webhook: Configura webhooks para eventos

Integração

  • Chatwoot: Configura integração com Chatwoot

🛠️ Desenvolvimento

Pré-requisitos

  • Node.js 18+
  • npm ou yarn

Instalação Local

git clone https://github.com/jfcardososantos/n8n-nodes-evolution-api-v2.git
cd n8n-nodes-evolution-api-v2
npm install

Scripts Disponíveis

# Build do projeto
npm run build

# Desenvolvimento com watch
npm run dev

# Linting
npm run lint

# Formatação
npm run format

# Release (patch, minor, major)
npm run release:patch
npm run release:minor
npm run release:major

📝 Exemplos de Uso

Enviar Mensagem de Texto

// Configuração do node
{
  "resource": "message",
  "operation": "sendText",
  "instanceName": "minha-instancia",
  "number": "5511999999999",
  "messageText": "Olá! Esta é uma mensagem de teste."
}

Criar Grupo

// Configuração do node
{
  "resource": "group",
  "operation": "createGroup",
  "instanceName": "minha-instancia",
  "subject": "Grupo de Teste",
  "participants": ["5511999999999", "5511888888888"]
}

🤝 Contribuição

  1. Faça um fork do projeto
  2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
  3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
  4. Push para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

👨‍💻 Autor

JF Cardoso Santos

🔗 Links

📈 Versionamento

Este projeto usa SemVer para versionamento. Para ver as versões disponíveis, veja as tags neste repositório.

🆘 Suporte

Se você encontrar algum problema ou tiver dúvidas, por favor:

  1. Verifique a documentação da Evolution API
  2. Abra uma issue no GitHub
  3. Entre em contato via email: jfcardososantos@gmail.com

Discussion