n8n-nodes-new-evolution-api 2.0.0

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright 2022 n8n
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,347 @@
+# n8n-nodes-new-evolution-api
+
+![New Evolution API](https://github.com/user-attachments/assets/813b7b34-377c-42e8-9f1a-12e27e682c7f)
+
+<p align="center">
+Community Node para integração completa da <b>New Evolution API v2.2+</b> com o <b>n8n</b>.<br>
+Permite automação de WhatsApp com suporte a mensagens, grupos, canais, integrações e muito mais.
+</p>
+
+<div align="center">
+  <img src="https://img.shields.io/badge/version-1.9.29-blue?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/operations-130+-green?style=for-the-badge" alt="Operations">
+  <img src="https://img.shields.io/badge/resources-14-orange?style=for-the-badge" alt="Resources">
+</div>
+
+---
+
+##  Requisitos
+
+- **n8n** versão **1.54.4** ou superior
+- **Evolution API** versão **2.2.0** ou superior
+- **Node.js** >= 18.10
+- **pnpm** >= 9.1.4 (para desenvolvimento)
+
+---
+
+##  Instalação
+
+### Via npm (Recomendado)
+```bash
+npm install n8n-nodes-new-evolution-api
+```
+
+### Manual
+1. Clone o repositório
+2. Execute `pnpm install`
+3. Execute `pnpm build`
+4. Copie para a pasta de nodes customizados do n8n
+
+---
+
+##  Recursos Disponíveis (14)
+
+###  Instância
+Gerenciamento completo de instâncias da Evolution API.
+
+| Operação | Descrição |
+|----------|-----------|
+| Criar Instância | Cria nova instância WhatsApp |
+| Gerar QR-Code | Obtém QR code para conexão |
+| Buscar Instância | Lista instâncias disponíveis |
+| Estado da Conexão | Verifica estado atual |
+| Definir Comportamento | Configura comportamento |
+| Definir Presença | Define status de presença |
+| Definir Proxy | Configura proxy |
+| Buscar Proxy | Obtém configuração de proxy |
+| Desconectar | Desconecta do WhatsApp |
+| Deletar | Remove instância |
+
+###  Mensagem
+Envio de diversos tipos de mensagens.
+
+| Operação | Descrição |
+|----------|-----------|
+| Enviar Texto | Mensagem de texto simples |
+| Enviar Imagem | Envio de imagens |
+| Enviar Vídeo | Envio de vídeos |
+| Enviar Áudio | Envio de áudios |
+| Enviar Documento | Envio de documentos |
+| Enviar Enquete | Criação de enquetes |
+| Enviar Contato | Compartilhamento de contatos |
+| Enviar Lista | Mensagem com lista de opções |
+| Enviar Botão | Mensagem com botões |
+| Enviar Pix | Mensagem de pagamento PIX |
+| Enviar Status | Publicar no status |
+| Reagir | Adicionar reação a mensagem |
+
+###  Grupo
+Gerenciamento completo de grupos.
+
+| Operação | Descrição |
+|----------|-----------|
+| Criar Grupo | Cria novo grupo |
+| Atualizar Imagem | Altera foto do grupo |
+| Atualizar Nome | Altera nome do grupo |
+| Atualizar Descrição | Altera descrição |
+| Atualizar Configurações | Altera configurações |
+| Atualizar Membros | Adiciona/remove membros |
+| Buscar Link de Convite | Obtém link de convite |
+| Revogar Link | Revoga link atual |
+| Enviar Link de Convite | Envia convite |
+| Encontrar Participantes | Lista participantes |
+| Mensagens Temporárias | Configura mensagens temporárias |
+| Sair do Grupo | Remove instância do grupo |
+| Entrar no Grupo | Entra via link de convite |
+
+###  Canais (Newsletter)
+Gerenciamento de canais/newsletters do WhatsApp.
+
+| Operação | Descrição |
+|----------|-----------|
+| Criar Canal | Cria novo canal |
+| Buscar Canais | Lista canais disponíveis |
+| Buscar Mensagens | Lista mensagens do canal |
+| Enviar Texto | Envia texto para canal próprio |
+| Enviar Mídia | Envia imagem/vídeo/áudio/documento |
+| Enviar Enquete | Cria enquete no canal |
+| Enviar Pergunta Q&A | Cria pergunta interativa (⚠️ respostas não disponíveis) |
+| Repostar Mensagem | Reposta de um canal para outro |
+| Info do Convite | Obtém info do código de convite |
+| Seguir | Segue um canal |
+| Deixar de Seguir | Para de seguir |
+| Silenciar | Silencia notificações |
+| Reativar | Reativa notificações |
+
+> ⚠️ **Limitação do WhatsApp**: Respostas a perguntas Q&A são processadas apenas server-side pelo WhatsApp. Não é possível capturar as respostas dos inscritos via API.
+
+###  Comunidade
+Gerenciamento de comunidades WhatsApp.
+
+| Operação | Descrição |
+|----------|-----------|
+| Criar Comunidade | Cria nova comunidade |
+| Buscar Comunidades | Lista comunidades |
+| Buscar Participantes | Lista membros |
+| Atualizar Participantes | Gerencia membros |
+| Sair da Comunidade | Remove da comunidade |
+
+###  Chat
+Operações de chat e mensagens.
+
+| Operação | Descrição |
+|----------|-----------|
+| Verificar Número | Valida número WhatsApp |
+| Ler Mensagem | Marca como lida |
+| Gerenciar Arquivo | Arquiva/desarquiva |
+| Marcar como Não Lido | Marca conversa |
+| Deletar Mensagem | Remove mensagem |
+| Buscar Foto de Perfil | Obtém foto |
+| Obter Mídia em Base64 | Converte mídia |
+| Editar Mensagem | Edita mensagem enviada |
+| Enviar Presença | Envia status de digitando |
+| Bloquear Contato | Bloqueia/desbloqueia |
+| Buscar Contatos | Lista contatos |
+| Procurar Mensagens | Busca mensagens |
+| Procurar Status | Busca status |
+| Procurar Chats | Lista conversas |
+| Buscar Chat por JID | Busca chat específico |
+
+###  Etiquetas
+Gerenciamento de etiquetas (labels).
+
+| Operação | Descrição |
+|----------|-----------|
+| Criar Etiqueta | Cria nova label |
+| Buscar Etiquetas | Lista labels |
+| Adicionar a Chat | Adiciona label ao chat |
+| Remover de Chat | Remove label do chat |
+
+###  Chamadas
+Controle de chamadas de voz.
+
+| Operação | Descrição |
+|----------|-----------|
+| Simular Chamada | Inicia chamada fake |
+| Buscar Chamadas | Lista chamadas |
+
+###  Negócios
+Recursos do WhatsApp Business.
+
+| Operação | Descrição |
+|----------|-----------|
+| Buscar Catálogo | Lista produtos |
+| Buscar Coleções | Lista coleções |
+
+###  Perfil
+Gerenciamento de perfil.
+
+| Operação | Descrição |
+|----------|-----------|
+| Buscar Perfil | Obtém informações |
+| Atualizar Nome | Altera nome |
+| Atualizar Status | Altera status |
+| Atualizar Foto | Altera foto |
+| Remover Foto | Remove foto |
+| Configurações de Privacidade | Gerencia privacidade |
+
+###  Templates (Meta Business)
+Gerenciamento de templates do Meta Business.
+
+| Operação | Descrição |
+|----------|-----------|
+| Criar Template | Cria novo template |
+| Buscar Templates | Lista templates |
+
+###  Armazenamento S3
+Integração com armazenamento S3.
+
+| Operação | Descrição |
+|----------|-----------|
+| Buscar Mídia | Obtém mídia do S3 |
+| Buscar URL da Mídia | Obtém URL assinada |
+
+###  Evento
+Configuração de eventos e integrações.
+
+| Operação | Descrição |
+|----------|-----------|
+| Webhook | Configura webhook |
+| RabbitMQ | Configura RabbitMQ |
+| WebSocket | Configura WebSocket |
+| SQS | Configura Amazon SQS |
+| NATS | Configura NATS |
+| Pusher | Configura Pusher |
+| Kafka | Configura Apache Kafka |
+
+###  Integração
+Integrações com plataformas externas.
+
+| Operação | Descrição |
+|----------|-----------|
+| Chatwoot | Integração Chatwoot |
+| Evolution Bot | Bot nativo |
+| Typebot | Integração Typebot |
+| Dify | Integração Dify AI |
+| Flowise | Integração Flowise |
+| OpenAI | Integração OpenAI |
+| N8N Bot | Bot do n8n |
+| EvoAI | Integração EvoAI |
+
+---
+
+##  Cenários de Uso
+
+### Workflow Reativo (Webhook)
+Processa mensagens recebidas:
+```
+Webhook n8n  Processa dados  Evolution API Node  Responde
+```
+
+### Workflow Proativo (Consultas)
+Inicia ações programadas:
+```
+Schedule/Trigger  Evolution API Node  Busca/Envia dados
+```
+
+---
+
+##  Desenvolvimento
+
+```bash
+# Instalar dependências
+pnpm install
+
+# Build de produção
+pnpm build
+
+# Modo de desenvolvimento (watch)
+pnpm dev
+
+# Lint
+pnpm lint
+
+# Lint com correção automática
+pnpm lintfix
+```
+
+---
+
+##  Changelog
+
+### v1.9.29 (2025-12-06)
+- ❌ **Removido**: Evento `NEWSLETTER_QUESTION_REPLY` (limitação do WhatsApp - respostas Q&A não são enviadas para terceiros)
+- 🧹 Limpeza de código de debug
+
+### v1.9.27 (2025-12-02)
+- ✨ **Newsletter Send Question**: Enviar perguntas Q&A para canais próprios
+- ✨ **Newsletter Send Poll**: Enquetes em canais
+
+### v1.9.19 (2025-12-01)
+- ✨ **S3 Media URL**: Suporte a `mediaS3Url` no trigger e repost
+- 🔧 Fix: `ignoreOwnNewsletters` default true (evita loop de duplicação)
+
+### v1.9.0 (2025-11-30)
+- ✨ **Seleção Dinâmica**: Canais, grupos e instâncias com dropdown
+- ✨ **LoadOptions**: Busca dinâmica via API
+- ✨ **Repost Newsletter**: Reposta mensagens entre canais
+
+### v1.8.0 (2025-11-30)
+- ✨ **Repost Newsletter Message**: Reposta de canais seguidos para canais próprios
+- ✨ **Modificar Legenda/Mídia**: Edita conteúdo ao repostar
+- 🔧 Otimização de payload (~40-50% menor)
+
+### v1.7.0 (2025-11-27)
+- ✨ **Trigger Node**: Recebe webhooks com endpoint editável
+- ✨ **Auto-extração**: 30+ campos extraídos automaticamente
+- ✨ **Newsletter Media Base64**: Mídia completa no webhook
+
+### v1.6.0 (2025-11-28)
+- ✨ **Newsletter Send**: Enviar texto e mídia para canais próprios
+- ✨ **Newsletter Invite Info**: Obter informações de código de convite
+- ✨ **Newsletter Fetch Messages**: Buscar mensagens do canal
+- 🔧 Correções de tipos TypeScript para Newsletter API
+- 📊 **127+ operações** cobrindo toda API
+
+### v1.5.0 (2025-11-27)
+- ✨ **Community**: 10 operações adicionais (convites, solicitações, configurações)
+- 🔧 Melhorias no Trigger Node para webhooks
+
+### v1.2.0 (2025-11-25)
+-  **14 Recursos** completos
+-  **~114 Operações** cobrindo toda API
+-  Novos: Templates API, S3 API
+-  Novos eventos: WebSocket, SQS, NATS, Pusher, Kafka
+-  Novas integrações: OpenAI, N8N Bot, EvoAI
+-  Newsletter renomeado para "Canais" (localização PT-BR)
+-  Correções de bugs e melhorias de UI
+
+### v1.1.0
+- Adicionado suporte a Newsletter/Canais
+- Melhorias no gerenciamento de grupos
+- Novos campos para mensagens
+
+### v1.0.0
+- Release inicial
+- Suporte básico a instâncias e mensagens
+
+---
+
+##  Contribuição
+
+Contribuições são bem-vindas! Por favor:
+- Abra **Issues** para reportar bugs
+- Envie **Pull Requests** com melhorias
+- Sugira novas funcionalidades
+
+---
+
+##  Licença
+
+MIT License - Veja [LICENSE.md](LICENSE.md) para detalhes.
+
+---
+
+<p align="center">
+Desenvolvido com  para a comunidade Evolution API
+</p>

package/dist/credentials/EvolutionApiV2Api.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class EvolutionApiV2Api implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/EvolutionApiV2Api.credentials.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvolutionApiV2Api = void 0;
+class EvolutionApiV2Api {
+    constructor() {
+        this.name = 'evolutionApiV2Api';
+        this.displayName = 'New Evolution API';
+        this.documentationUrl = 'https://doc.evolution-api.com/pt';
+        this.properties = [
+            {
+                displayName: 'Server Url',
+                name: 'server-url',
+                type: 'string',
+                default: '',
+                placeholder: 'https://exemplo.com',
+                description: 'Digite a URL completa da sua Evolution API (ex: https://api.exemplo.com)',
+            },
+            {
+                displayName: 'ApiKey',
+                name: 'apikey',
+                type: 'string',
+                default: '',
+                typeOptions: {
+                    password: true,
+                },
+                description: 'Digite a ApiKey da Instancia ou Global da sua Evolution API',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    apikey: '={{$credentials.apikey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials["server-url"]}}',
+                url: '={{$credentials["server-url"].endsWith("/") ? "/erro" : "/instance/fetchInstances"}}',
+                method: 'GET',
+                headers: {
+                    apikey: '={{$credentials.apikey}}',
+                },
+            },
+        };
+    }
+}
+exports.EvolutionApiV2Api = EvolutionApiV2Api;
+//# sourceMappingURL=EvolutionApiV2Api.credentials.js.map

package/dist/credentials/EvolutionApiV2Api.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvolutionApiV2Api.credentials.js","sourceRoot":"","sources":["../../credentials/EvolutionApiV2Api.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,iBAAiB;IAA9B;QACC,SAAI,GAAG,mBAAmB,CAAC;QAC3B,gBAAW,GAAG,mBAAmB,CAAC;QAClC,qBAAgB,GAAG,kCAAkC,CAAC;QACtD,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,qBAAqB;gBAClC,WAAW,EAAE,0EAA0E;aACvF;YACD;gBACC,WAAW,EAAE,QAAQ;gBACrB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,WAAW,EAAE,6DAA6D;aAC1E;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,MAAM,EAAE,0BAA0B;iBAClC;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,iCAAiC;gBAC1C,GAAG,EAAE,sFAAsF;gBAC3F,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACR,MAAM,EAAE,0BAA0B;iBAClC;aACD;SACD,CAAC;IACH,CAAC;CAAA;AA5CD,8CA4CC"}

package/dist/nodes/EvolutionApi/EvolutionApiTrigger.node.d.ts

@@ -0,0 +1,18 @@
+import type { IHookFunctions, IWebhookFunctions, INodeType, INodeTypeDescription, IWebhookResponseData } from 'n8n-workflow';
+import { getInstances } from './loadOptions';
+export declare class EvolutionApiTrigger implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getInstances: typeof getInstances;
+        };
+    };
+    webhookMethods: {
+        default: {
+            checkExists(this: IHookFunctions): Promise<boolean>;
+            create(this: IHookFunctions): Promise<boolean>;
+            delete(this: IHookFunctions): Promise<boolean>;
+        };
+    };
+    webhook(this: IWebhookFunctions): Promise<IWebhookResponseData>;
+}