@aorizondo/n8n-nodes-evolution 1.9.53 → 1.9.54

package/README.md

@@ -3,8 +3,10 @@
 ![Evolution API](https://github.com/user-attachments/assets/813b7b34-377c-42e8-9f1a-12e27e682c7f)
 
 <p align="center">
-Community Node para integração completa da <b>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.
+Community Node for complete integration of <b>Evolution API v2.2+</b> with <b>n8n</b>.<br>
+Allows WhatsApp automation with support for messages, groups, channels, integrations, and more.<br><br>
+<b>⚠️ PATCHED VERSION by @aorizondo:</b><br>
+This fork addresses critical bugs in credentials mapping for AI and integrations (fixing 'Invalid URL' and 'evolutionApi' vs 'evolutionApiV2Api' context issues) and translates the UI from Portuguese to English. Original Credit to Flávio Kosta.
 </p>
 
 <div align="center">
@@ -15,333 +17,343 @@ Permite automação de WhatsApp com suporte a mensagens, grupos, canais, integra
 
 ---
 
-##  Requisitos
+## Requirements
 
-- **n8n** versão **1.54.4** ou superior
-- **Evolution API** versão **2.2.0** ou superior
+- **n8n** version **1.54.4** or higher
+- **Evolution API** version **2.2.0** or higher
 - **Node.js** >= 18.10
-- **pnpm** >= 9.1.4 (para desenvolvimento)
+- **pnpm** >= 9.1.4 (for development)
 
 ---
 
-##  Instalação
+## Installation
 
-### Via npm (Recomendado)
+### Via npm (Recommended)
 ```bash
-npm install n8n-nodes-evolution
+npm install @aorizondo/n8n-nodes-evolution
 ```
 
 ### Manual
-1. Clone o repositório
-2. Execute `pnpm install`
-3. Execute `pnpm build`
-4. Copie para a pasta de nodes customizados do n8n
+1. Clone the repository
+2. Run `pnpm install`
+3. Run `pnpm build`
+4. Copy to the n8n custom nodes folder
 
 ---
 
-##  Recursos Disponíveis (14)
+## Available Resources (14)
 
-###  Instância
-Gerenciamento completo de instâncias da Evolution API.
+### Instance
+Complete management of Evolution API instances.
 
-| Operação | Descrição |
+| Operation | Description |
 |----------|-----------|
-| 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 |
+| Create Instance | Creates a new WhatsApp instance |
+| Generate QR-Code | Gets QR code for connection |
+| Fetch Instance | Lists available instances |
+| Connection State | Checks current state |
+| Set Behavior | Configures behavior |
+| Set Presence | Sets presence status |
+| Set Proxy | Configures proxy |
+| Fetch Proxy | Gets proxy configuration |
+| Disconnect | Disconnects from WhatsApp |
+| Delete | Removes instance |
+
+### Message
+Sending various types of messages.
+
+| Operation | Description |
 |----------|-----------|
-| 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 |
+| Send Text | Simple text message |
+| Send Image | Send images |
+| Send Video | Send videos |
+| Send Audio | Send audios |
+| Send Document | Send documents |
+| Send Poll | Poll creation |
+| Send Contact | Share contacts |
+| Send List | Message with a list of options |
+| Send Button | Message with buttons |
+| Send Pix | PIX payment message (Brazil) |
+| Send Status | Publish to status |
+| React | Add reaction to a message |
+
+### Group
+Complete group management.
+
+| Operation | Description |
 |----------|-----------|
-| 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 |
+| Create Group | Creates a new group |
+| Update Image | Changes group photo |
+| Update Name | Changes group name |
+| Update Description | Changes description |
+| Update Settings | Changes settings |
+| Update Members | Adds/removes members |
+| Fetch Invite Link | Gets invite link |
+| Revoke Link | Revokes current link |
+| Send Invite Link | Sends invite |
+| Find Participants | Lists participants |
+| Ephemeral Messages | Configures temporary messages |
+| Leave Group | Removes instance from group |
+| Join Group | Joins via invite link |
+
+### Channels (Newsletter)
+Management of WhatsApp channels/newsletters.
+
+| Operation | Description |
 |----------|-----------|
-| 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 |
+| Create Channel | Creates new channel |
+| Fetch Channels | Lists available channels |
+| Fetch Messages | Lists channel messages |
+| Send Text | Sends text to own channel |
+| Send Media | Sends image/video/audio/document |
+| Send Poll | Creates poll in channel |
+| Send Q&A Question | Creates interactive question (⚠️ replies not available) |
+| Repost Message | Reposts from one channel to another |
+| Invite Info | Gets info from invite code |
+| Follow | Follows a channel |
+| Unfollow | Stops following |
+| Mute | Mutes notifications |
+| Unmute | Unmutes notifications |
+
+> ⚠️ **WhatsApp Limitation**: Q&A question replies are processed only server-side by WhatsApp. It is not possible to capture subscriber replies via API.
+
+### Community
+WhatsApp communities management.
+
+| Operation | Description |
 |----------|-----------|
-| Criar Comunidade | Cria nova comunidade |
-| Buscar Comunidades | Lista comunidades |
-| Buscar Participantes | Lista membros |
-| Atualizar Participantes | Gerencia membros |
-| Sair da Comunidade | Remove da comunidade |
+| Create Community | Creates new community |
+| Fetch Communities | Lists communities |
+| Fetch Participants | Lists members |
+| Update Participants | Manages members |
+| Leave Community | Removes from community |
 
-###  Chat
-Operações de chat e mensagens.
+### Chat
+Chat and message operations.
 
-| Operação | Descrição |
+| Operation | Description |
 |----------|-----------|
-| 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 |
+| Check Number | Validates WhatsApp number |
+| Read Message | Marks as read |
+| Manage Archive | Archives/unarchives |
+| Mark as Unread | Marks conversation |
+| Delete Message | Removes message |
+| Fetch Profile Picture | Gets photo |
+| Get Media in Base64 | Converts media |
+| Edit Message | Edits sent message |
+| Send Presence | Sends typing status |
+| Block Contact | Blocks/unblocks |
+| Fetch Contacts | Lists contacts |
+| Search Messages | Searches messages |
+| Search Status | Searches status |
+| Search Chats | Lists conversations |
+| Fetch Chat by JID | Searches specific chat |
+
+### Labels
+Label management.
+
+| Operation | Description |
 |----------|-----------|
-| Criar Etiqueta | Cria nova label |
-| Buscar Etiquetas | Lista labels |
-| Adicionar a Chat | Adiciona label ao chat |
-| Remover de Chat | Remove label do chat |
+| Create Label | Creates new label |
+| Fetch Labels | Lists labels |
+| Add to Chat | Adds label to chat |
+| Remove from Chat | Removes label from chat |
 
-###  Chamadas
-Controle de chamadas de voz.
+### Calls
+Voice call control.
 
-| Operação | Descrição |
+| Operation | Description |
 |----------|-----------|
-| Simular Chamada | Inicia chamada fake |
-| Buscar Chamadas | Lista chamadas |
+| Simulate Call | Starts fake call |
+| Fetch Calls | Lists calls |
 
-###  Negócios
-Recursos do WhatsApp Business.
+### Business
+WhatsApp Business resources.
 
-| Operação | Descrição |
+| Operation | Description |
 |----------|-----------|
-| Buscar Catálogo | Lista produtos |
-| Buscar Coleções | Lista coleções |
+| Fetch Catalog | Lists products |
+| Fetch Collections | Lists collections |
 
-###  Perfil
-Gerenciamento de perfil.
+### Profile
+Profile management.
 
-| Operação | Descrição |
+| Operation | Description |
 |----------|-----------|
-| 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 |
+| Fetch Profile | Gets information |
+| Update Name | Changes name |
+| Update Status | Changes status |
+| Update Photo | Changes photo |
+| Remove Photo | Removes photo |
+| Privacy Settings | Manages privacy |
 
-###  Templates (Meta Business)
-Gerenciamento de templates do Meta Business.
+### Templates (Meta Business)
+Meta Business templates management.
 
-| Operação | Descrição |
+| Operation | Description |
 |----------|-----------|
-| Criar Template | Cria novo template |
-| Buscar Templates | Lista templates |
+| Create Template | Creates new template |
+| Fetch Templates | Lists templates |
 
-###  Armazenamento S3
-Integração com armazenamento S3.
+### S3 Storage
+S3 storage integration.
 
-| Operação | Descrição |
+| Operation | Description |
 |----------|-----------|
-| Buscar Mídia | Obtém mídia do S3 |
-| Buscar URL da Mídia | Obtém URL assinada |
+| Fetch Media | Gets media from S3 |
+| Fetch Media URL | Gets signed URL |
 
-###  Evento
-Configuração de eventos e integrações.
+### Event
+Events and integrations configuration.
 
-| Operação | Descrição |
+| Operation | Description |
 |----------|-----------|
-| 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 |
+| Webhook | Configures webhook |
+| RabbitMQ | Configures RabbitMQ |
+| WebSocket | Configures WebSocket |
+| SQS | Configures Amazon SQS |
+| NATS | Configures NATS |
+| Pusher | Configures Pusher |
+| Kafka | Configures Apache Kafka |
+
+### Integration
+Integrations with external platforms.
+
+| Operation | Description |
 |----------|-----------|
-| 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 |
+| Chatwoot | Chatwoot integration |
+| Evolution Bot | Native bot |
+| Typebot | Typebot integration |
+| Dify | Dify AI integration |
+| Flowise | Flowise integration |
+| OpenAI | OpenAI integration |
+| N8N Bot | N8n bot |
+| EvoAI | EvoAI integration |
 
 ---
 
-##  Cenários de Uso
+## Use Cases
 
-### Workflow Reativo (Webhook)
-Processa mensagens recebidas:
+### Reactive Workflow (Webhook)
+Processes incoming messages:
 ```
-Webhook n8n  Processa dados  Evolution API Node  Responde
+n8n Webhook -> Processes data -> Evolution API Node -> Responds
 ```
 
-### Workflow Proativo (Consultas)
-Inicia ações programadas:
+### Proactive Workflow (Queries)
+Starts scheduled actions:
 ```
-Schedule/Trigger  Evolution API Node  Busca/Envia dados
+Schedule/Trigger -> Evolution API Node -> Fetches/Sends data
 ```
 
 ---
 
-##  Desenvolvimento
+## Development
 
 ```bash
-# Instalar dependências
+# Install dependencies
 pnpm install
 
-# Build de produção
+# Production build
 pnpm build
 
-# Modo de desenvolvimento (watch)
+# Development mode (watch)
 pnpm dev
 
 # Lint
 pnpm lint
 
-# Lint com correção automática
+# Lint with auto-fix
 pnpm lintfix
 ```
 
 ---
 
-##  Changelog
+## Changelog
+
+### v1.9.53 (Fork by @aorizondo)
+- ✨ **English UI**: Translated node interface from Portuguese to English.
+- 🐛 **Bugfix**: Fixed hardcoded `evolutionApi` credential calls across 18 integration endpoints (OpenAI, EvoAI, S3, Webhooks, etc.) that used to throw `does not have any credentials of type "evolutionApi"`.
+- 🐛 **Bugfix**: Fixed `Invalid URL` execution errors on integration endpoints by ensuring that `EvolutionRequest` wrapper is used for all operations, correctly picking up the Server URL from the user's credentials.
 
 ### 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
+- ❌ **Removed**: `NEWSLETTER_QUESTION_REPLY` event (WhatsApp limitation - Q&A replies are not sent to third-parties)
+- 🧹 Debug code cleanup
 
 ### v1.9.27 (2025-12-02)
-- ✨ **Newsletter Send Question**: Enviar perguntas Q&A para canais próprios
-- ✨ **Newsletter Send Poll**: Enquetes em canais
+- ✨ **Newsletter Send Question**: Send Q&A questions to own channels
+- ✨ **Newsletter Send Poll**: Polls in channels
 
 ### 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)
+- ✨ **S3 Media URL**: Support for `mediaS3Url` on trigger and repost
+- 🔧 Fix: `ignoreOwnNewsletters` default true (prevents duplication loop)
 
 ### 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
+- ✨ **Dynamic Selection**: Channels, groups, and instances with dropdown
+- ✨ **LoadOptions**: Dynamic fetching via API
+- ✨ **Repost Newsletter**: Repost messages between channels
 
 ### 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)
+- ✨ **Repost Newsletter Message**: Repost from followed channels to own channels
+- ✨ **Modify Caption/Media**: Edit content when reposting
+- 🔧 Payload optimization (~40-50% smaller)
 
 ### 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
+- ✨ **Auto-extraction**: 30+ automatically extracted fields
+- ✨ **Newsletter Media Base64**: Full media on 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
+- ✨ **Newsletter Send**: Send text and media to own channels
+- ✨ **Newsletter Invite Info**: Get information from invite code
+- ✨ **Newsletter Fetch Messages**: Fetch channel messages
+- 🔧 TypeScript typings fixes for Newsletter API
+- 📊 **127+ operations** covering the entire API
 
 ### v1.5.0 (2025-11-27)
-- ✨ **Community**: 10 operações adicionais (convites, solicitações, configurações)
-- 🔧 Melhorias no Trigger Node para webhooks
+- ✨ **Community**: 10 additional operations (invites, requests, settings)
+- 🔧 Improvements on Trigger Node for 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
+-  **14 Resources** complete
+-  **~114 Operations** covering the entire API
+-  New: Templates API, S3 API
+-  New events: WebSocket, SQS, NATS, Pusher, Kafka
+-  New integrations: OpenAI, N8N Bot, EvoAI
+-  Newsletter renamed to "Channels"
+-  Bug fixes and UI improvements
 
 ### v1.1.0
-- Adicionado suporte a Newsletter/Canais
-- Melhorias no gerenciamento de grupos
-- Novos campos para mensagens
+- Added support for Newsletter/Channels
+- Improvements on group management
+- New fields for messages
 
 ### v1.0.0
-- Release inicial
-- Suporte básico a instâncias e mensagens
+- Initial release
+- Basic support for instances and messages
 
 ---
 
-##  Contribuição
+## Credits
+
+- **Original Author**: Flávio Kosta (@flaviokosta79) - Created the original `n8n-nodes-evolution` package.
+- **Fork Maintainer**: @aorizondo - Fixed credentials bugs and translated the UI to English.
+
+## Contribution
 
-Contribuições são bem-vindas! Por favor:
-- Abra **Issues** para reportar bugs
-- Envie **Pull Requests** com melhorias
-- Sugira novas funcionalidades
+Contributions are welcome! Please:
+- Open **Issues** to report bugs
+- Send **Pull Requests** with improvements
+- Suggest new features
 
 ---
 
-##  Licença
+## License
 
-MIT License - Veja [LICENSE.md](LICENSE.md) para detalhes.
+MIT License - See [LICENSE.md](LICENSE.md) for details.
 
 ---
 
 <p align="center">
-Desenvolvido com  para a comunidade Evolution API
+Developed with 💙 for the Evolution API community
 </p>