n8n-nodes-wapi

Este é um pacote de nodes customizados para n8n que permite integração completa com a W-api WhatsApp API.

🚀 Instalação

Opção 1: Instalação via npm (Recomendado para produção)

1. Publique o pacote no npm:

cd n8n-nodes-wapi
npm publish

2. No n8n, instale o pacote:

npm install n8n-nodes-wapi

Opção 2: Instalação Local (Para desenvolvimento/testes)

1. No diretório do n8n, instale localmente:

cd ~/.n8n/custom
npm install /caminho/completo/para/n8n-nodes-wapi

2. Ou adicione ao package.json do n8n:

{
  "dependencies": {
    "n8n-nodes-wapi": "file:../caminho/para/n8n-nodes-wapi"
  }
}

Opção 3: Variável de Ambiente (Mais simples para testes)

1. Defina a variável de ambiente:

export N8N_CUSTOM_EXTENSIONS="/caminho/completo/para/n8n-nodes-wapi"

2. Reinicie o n8n

📋 Recursos Disponíveis

🔌 Instância

• Criar: Criar nova instância WhatsApp
• Conectar: Obter QR Code para conexão
• Status: Verificar status da conexão
• Listar: Listar todas as instâncias
• Logout: Desconectar instância
• Deletar: Remover instância

💬 Mensagem

• Enviar Texto: Enviar mensagem de texto
• Enviar Imagem: Enviar imagem com legenda opcional

🔗 Webhook

• Configurar: Definir URL do webhook
• Obter: Ver configuração atual do webhook

🔑 Configuração de Credenciais

1. No n8n, vá em Credentials → New
2. Procure por W-api API
3. Configure:
   • URL da API: http://localhost:3333 (ou sua URL)
   • API Key: Sua chave de autenticação

📝 Exemplos de Uso

Exemplo 1: Criar Instância e Enviar Mensagem

[Trigger] → [W-api: Criar Instância] → [W-api: Enviar Texto]

Exemplo 2: Workflow Completo

[Webhook] → [W-api: Enviar Texto] → [Resposta]

Exemplo 3: Enviar Imagem

[Schedule] → [W-api: Enviar Imagem]

🎯 Campos Principais

Instância

• Nome da Instância: Identificador único (ex: loja-centro)

Mensagem

• Nome da Instância: Instância a ser usada
• Número: Número com código do país (ex: 5521999999999)
• Texto: Conteúdo da mensagem
• URL da Imagem: Link da imagem (para envio de imagens)
• Legenda: Texto da imagem (opcional)

Webhook

• Nome da Instância: Instância a configurar
• URL do Webhook: Endpoint que receberá os eventos

🔄 Eventos do Webhook

O webhook receberá eventos como:

• QRCODE_UPDATED: Novo QR Code gerado
• CONNECTION_UPDATE: Mudança no status da conexão
• MESSAGES_UPSERT: Nova mensagem recebida

🆘 Suporte

Para problemas ou dúvidas, abra uma issue no GitHub.

📄 Licença

MIT