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

• Email: [email protected]
• GitHub: @jfcardososantos

🔗 Links

• N8N
• Evolution API
• NPM Package

📈 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: [email protected]