n8n-nodes-wwebjsapi

Node n8n para integração completa com a WWebJS API — um wrapper REST para o WhatsApp Web JS.

🚀 Instalação

# No diretório do n8n
npm install n8n-nodes-wwebjsapi

Ou via interface do n8n: Settings → Community Nodes → Install

---

⚙️ Configuração

1. No n8n, crie uma credencial do tipo WWebJS API Credentials
2. Preencha:
   • Base URL: URL do seu servidor WWebJS (ex: http://localhost:3000)
   • API Key: valor da variável API_KEY configurada no servidor

---

📋 Operações disponíveis

O node é gerado automaticamente a partir do swagger.json da API. As operações são organizadas por categoria:

Session

Operação	Descrição
Get all sessions	Lista todas as sessões ativas
Start session	Inicia uma nova sessão
Stop session	Para uma sessão
Get session status	Status atual da sessão
Get session QR code	Dados do QR code
Get QR code as image	QR code como imagem PNG
Request pairing code	Autenticar via código de pareamento
Restart session	Reinicia a sessão
Terminate session	Encerra a sessão
Terminate inactive sessions	Encerra todas sessões inativas
Terminate all sessions	Encerra todas as sessões
Get page screenshot	Screenshot do browser

Client

Operação	Descrição
Get connection info	Informações da conexão atual
Accept group invite	Aceita convite de grupo
Archive chat	Arquiva um chat
Create group	Cria um grupo
Get all chats	Lista todos os chats
Get all contacts	Lista todos os contatos
Get number ID	Obtém WID de um número
Send message	Envia mensagem de texto
Send media from URL	Envia mídia por URL
Set status message	Define mensagem de status
Check if user is registered	Verifica se número está no WhatsApp
Get chat by ID	Detalhes de um chat
Get contact by ID	Detalhes de um contato

Message

Operação	Descrição
Get messages from chat	Lista mensagens de um chat
Delete message	Deleta uma mensagem
React to message	Reage com emoji
Star message	Marca/desmarca mensagem como favorita

---

🔄 Atualizar para nova versão da API

O node é gerado automaticamente a partir do swagger.json. Para atualizar:

# Opção 1: Script automático
bash scripts/update-swagger.sh

# Opção 2: Manual
curl -o swagger.json https://raw.githubusercontent.com/avoylenko/wwebjs-api/refs/heads/main/swagger.json
node scripts/generate-from-swagger.js
npm run build

---

🛠️ Desenvolvimento

# Clone e instale
git clone <repo>
cd n8n-nodes-wwebjsapi
npm install

# Gerar a partir do swagger atual
npm run generate

# Compilar
npm run build

# Desenvolver com watch
npm run dev

---

📁 Estrutura do projeto

n8n-nodes-wwebjsapi/
├── swagger.json                    # ← Atualize este arquivo para novas versões
├── scripts/
│   ├── generate-from-swagger.js   # Gerador automático do node
│   └── update-swagger.sh          # Script de atualização completa
├── nodes/
│   └── WWebjsApi/
│       ├── WWebjsApi.node.ts      # ← GERADO AUTOMATICAMENTE
│       └── wwebjs.svg
├── credentials/
│   └── WWebjsApiCredentials.credentials.ts
├── package.json
└── tsconfig.json

⚠️ Não edite WWebjsApi.node.ts diretamente — ele é regerado a cada atualização.

---

📄 Licença

MIT