Description

n8n-nodes-quepasa-api-yurisilva_pro

!QuePasa Logo

Implementação completa da API QuePasa WhatsApp para n8n com suporte multi-conta

pro.svg”>
Sobre

—

🎯 Sobre

Este pacote fornece nodes personalizados do n8n para integração com a API QuePasa (WhatsApp Multi-Device), permitindo automação completa de operações do WhatsApp em workflows do n8n.

O que é QuePasa?

QuePasa é uma micro web-aplicação em Go que fornece uma API RESTful HTTP para interação com WhatsApp através da biblioteca Whatsmeow (protocolo oficial WhatsApp Multi-Device).

Por que usar este pacote?

—

📊 Status

Versão: 2.0.1
Status: ✅ 100% COMPLETO – PRODUÇÃO READY
Última Atualização: 22 de Janeiro de 2026

Implementação

██████████████████████████████████████████████████ 100%

—

📦 Instalação

Via npm (quando publicado)

npm install n8n-nodes-quepasa-api-yurisilva_pro

Instalação Local (desenvolvimento)

Clone o repositório
git clone https://github.com/yurisilva_pro/n8n-quepasa-nodes.git
cd n8n-quepasa-nodes
Instale dependências
npm install
Compile o projeto
npm run build
Link para n8n
npm link
No diretório n8n
cd ~/.n8n/nodes
npm link n8n-nodes-quepasa
Reinicie n8n
n8n start

—

✨ Recursos

🔐 Autenticação Simples

Configure suas credenciais QuePasa de forma rápida e direta:

{
  baseUrl: "http://localhost:31000",
  token: "your-api-token"
}

Campos:

📤 Envio de Mensagens

👥 Gerenciamento de Grupos

📞 Contatos

🖼️ Mídias

🪝 Webhooks

💬 Chats

📊 Status/Presença

—

🧩 Nodes Disponíveis

1. Session Node ✅

Gerenciamento de sessão WhatsApp

| Operação | Descrição |
|———-|———–|
| Get QR Code | Gera QR Code para autenticação |
| Check Status | Verifica status da sessão |
| Get Info | Obtém informações da conta |
| Disconnect | Desconecta a sessão |

2. Message Node ✅

Operações de mensagens

| Operação | Descrição |
|———-|———–|
| Send Text | Envia mensagem de texto |
| Send Media | Envia mídia (imagem, vídeo, áudio, documento) |
| Send from URL | Envia mídia a partir de URL |
| Revoke Message | Revoga/deleta mensagem enviada |
| React to Message 🆕 | Reage a mensagem com emoji |
| Forward Message 🆕 | Encaminha mensagem para outro chat |
| Get History 🆕 | Obtém histórico de mensagens |

3. Group Node ✅

Gerenciamento de grupos

| Operação | Descrição |
|———-|———–|
| List Groups | Lista todos os grupos |
| Get Group Info | Obtém detalhes de um grupo |
| Create Group | Cria novo grupo |
| Update Name | Atualiza nome do grupo |
| Add Participants | Adiciona participantes |
| Remove Participant | Remove participante |
| Leave Group | Sai do grupo |
| Update Description 🆕 | Atualiza descrição do grupo |
| Update Picture 🆕 | Atualiza foto do grupo |
| Remove Picture 🆕 | Remove foto do grupo |
| Promote to Admin 🆕 | Promove participante a admin |
| Demote from Admin 🆕 | Rebaixa admin a participante |
| Get Invite Link 🆕 | Obtém link de convite |
| Revoke Invite Link 🆕 | Revoga link de convite |
| Join via Invite 🆕 | Entra em grupo via convite |

4. Contact Node ✅

Operações de contatos

| Operação | Descrição |
|———-|———–|
| List Contacts | Lista todos os contatos |
| Get Contact Info | Obtém informações de contato |
| Check WhatsApp | Verifica se números estão no WhatsApp |
| Get Picture 🆕 | Obtém foto de perfil do contato |
| Block Contact 🆕 | Bloqueia um contato |
| Unblock Contact 🆕 | Desbloqueia um contato |

5. Media Node ✅

Download de mídias

| Operação | Descrição |
|———-|———–|
| Download Media | Baixa mídia de uma mensagem |
| Download as Base64 🆕 | Baixa mídia como string Base64 |

6. Webhook Node ✅

Configuração de webhooks

| Operação | Descrição |
|———-|———–|
| Set Webhook | Configura webhook URL |
| Get Webhook | Obtém configuração atual |
| Delete Webhook | Remove webhook |
| Update Webhook 🆕 | Atualiza configuração do webhook |

7. Chat Node ✅

Gerenciamento de chats

| Operação | Descrição |
|———-|———–|
| Mark as Read | Marca chat como lido |
| Archive Chat | Arquiva chat |
| Unarchive Chat 🆕 | Desarquiva chat |
| Pin Chat 🆕 | Fixa chat no topo |
| Unpin Chat 🆕 | Desfixa chat |
| Mute Chat 🆕 | Silencia notificações |
| Unmute Chat 🆕 | Ativa notificações |

8. Status Node ✅

Controle de presença e status

| Operação | Descrição |
|———-|———–|
| Update Presence | Atualiza presença (online/offline) |
| Update Status 🆕 | Atualiza status/about do WhatsApp |
| Get Contact Status 🆕 | Obtém status/about de um contato |

—

🚀 Quick Start

1. Configure suas Credenciais

No n8n, crie uma nova credencial QuePasa API:

2. Adicione o Node QuePasa

1. Arraste o node QuePasa para seu workflow
2. Selecione sua credencial
3. Escolha o Resource (Session, Message, Group, etc.)
4. Escolha a Operation desejada
5. Preencha os parâmetros necessários

3. Exemplo: Enviar Mensagem

{
  "resource": "message",
  "operation": "sendText",
  "chatId": "5511999999999",
  "text": "Olá! Esta é uma mensagem do n8n via QuePasa"
}

4. Exemplo: Gerar QR Code

{
  "resource": "session",
  "operation": "getQrCode",
  "userId": "admin",
  "returnAsImage": true
}

O QR Code será retornado como Binary Data pronto para ser salvo ou exibido.

—

📚 Documentação

Documentação Completa

| Documento | Descrição |
|———–|———–|
| COMPLETA.md”>IMPLEMENTACAOCOMPLETA.md | Detalhes da implementação |
| GUIA.md”>ENDPOINTSGUIA.md | Referência de endpoints |
| docs/README.md | Índice da documentação |

[Schedule Trigger] → [QuePasa: Check Status] → [IF: Connected?] 
                                                     ↓ Yes
                                    [QuePasa: Send Text] → [Done]
                                                     ↓ No
                                    [QuePasa: Get QR Code] → [Email QR]

[HTTP Request: Get Contacts] → [QuePasa: Create Group] → [QuePasa: Add Participants]

[Webhook Trigger] → [QuePasa: Download Media] → [Save to S3] → [QuePasa: Send Text (Reply)]

[Spreadsheet: Load Numbers] → [QuePasa: Check WhatsApp] → [Filter Valid] → [QuePasa: Send Text (Batch)]

n8n-quepasa-nodes/
├── credentials/          # Credenciais n8n
├── nodes/                # Nodes principais
│   └── QuePasa/
│       ├── descriptions/ # Descrições de UI
│       └── QuePasa.node.ts
├── utils/                # Funções auxiliares
├── tests/                # Testes unitários
├── docs/                 # Documentação detalhada
└── dist/                 # Código compilado

Instalar dependências
npm install
Compilar TypeScript
npm run build
Executar testes
npm test
Linting
npm run lint
Formatar código
npm run format
Copiar assets
npm run copy:assets
Watch mode (desenvolvimento)
npm run watch

npm test
Com cobertura
npm run test:coverage
Watch mode
npm run test:watch

Linhas de Código:     ~5.400+
Arquivos TypeScript:  18
Nodes:                8
Operações:            48 (100% cobertura) 🎉
Testes:               8 (100% pass)
Documentação:         15 arquivos