n8n-nodes-papi

Este é um node da comunidade n8n para integração com a PAPI WhatsApp API - uma API completa para automação do WhatsApp baseada no Baileys.

Instalação

No n8n (Community Nodes)

1. Vá em Settings > Community Nodes
2. Clique em Install a community node
3. Digite n8n-nodes-papi
4. Clique em Install

Manual

npm install n8n-nodes-papi

Configuração

1. Adicione suas credenciais da PAPI API:
   • Base URL: URL do seu servidor PAPI (ex: https://api.seudominio.com)
   • API Key: Sua chave de API (PANEL_API_KEY configurada no servidor)

Recursos Disponíveis

📱 Instâncias

• Listar todas as instâncias
• Criar nova instância
• Obter status
• Obter QR Code
• Deletar instância
• Logout
• Configurar Webhook
• Obter Webhook
• Toggle Link Público
• Configurar Proxy ✨ NEW
• Obter Proxy ✨ NEW
• Configurar WebSocket ✨ NEW
• Obter WebSocket ✨ NEW
• Configurar Settings ✨ NEW (rejectCalls, ignoreGroups, alwaysOnline, etc.)
• Obter Settings ✨ NEW

💬 Mensagens

• Enviar texto
• Enviar imagem
• Enviar vídeo
• Enviar áudio/PTT
• Enviar documento
• Enviar sticker
• Enviar localização
• Enviar contato
• Enviar reação
• Enviar botões
• Enviar lista
• Enviar carrossel
• Enviar Enquete/Poll ✨ NEW
• Deletar mensagem
• Editar mensagem
• Marcar como lida

👥 Grupos

• Listar grupos
• Criar grupo
• Obter metadados
• Obter link de convite
• Gerenciar participantes (adicionar/remover/promover/rebaixar)
• Atualizar configurações
• Sair do grupo

👤 Perfil

• Obter foto de perfil
• Atualizar foto
• Atualizar status/recado
• Atualizar nome

🔒 Privacidade

• Obter configurações
• Bloquear/Desbloquear contatos
• Listar bloqueados

🛠️ Utilidades

• Verificar número no WhatsApp
• Atualizar presença (digitando, online)
• Gerenciar labels
• Estatísticas do servidor

📱 SMS ✨ NEW

• Enviar SMS
• Enviar SMS em massa (bulk)
• Obter configuração
• Atualizar configuração
• Obter status das portas
• Testar SMS

📞 Central de Ligações ✨ NEW

• Listar instâncias de ligação
• Obter instância
• Criar instância
• Atualizar instância
• Deletar instância
• Atualizar status
• Testar SMS via instância

Trigger (Webhook)

O node PAPI Trigger permite receber eventos em tempo real:

• Mensagens recebidas
• Status de mensagem (enviado, entregue, lido)
• Reações
• Presença
• Atualizações de grupo
• Participantes de grupo
• Chamadas
• Contatos
• Chats
• Labels
• Sincronização de histórico

Filtros disponíveis:

• Por tipo de evento
• Por instância
• Por remetente
• Apenas grupos ou privado
• Ignorar mensagens próprias
• Por tipo de mensagem

Exemplo de Uso

Enviar mensagem de texto

1. Adicione o node PAPI WhatsApp
2. Selecione recurso: Mensagem
3. Selecione operação: Enviar Texto
4. Preencha o ID da instância
5. Preencha o número (com DDI): 5511999999999
6. Digite o texto da mensagem

Enviar SMS

1. Adicione o node PAPI WhatsApp
2. Selecione recurso: SMS
3. Selecione operação: Enviar SMS
4. Preencha o número (com DDI): 5511999999999
5. Digite o texto do SMS

Enviar Enquete

1. Adicione o node PAPI WhatsApp
2. Selecione recurso: Mensagem
3. Selecione operação: Enviar Enquete
4. Preencha o ID da instância
5. Preencha o número
6. Digite a pergunta e as opções separadas por vírgula

Receber mensagens via webhook

1. Adicione o node PAPI Trigger
2. Configure os eventos desejados
3. Copie a URL do webhook
4. Configure o webhook na sua instância PAPI

Changelog

v1.2.0

• ✨ Novo recurso: SMS (enviar, bulk, configurar, testar)
• ✨ Novo recurso: Central de Ligações (CRUD de instâncias)
• ✨ Nova operação: Enviar Enquete/Poll
• ✨ Novas operações de instância: Proxy, WebSocket, Settings
• 🐛 Melhorias gerais de estabilidade

v1.1.4

• Versão inicial com suporte completo a WhatsApp

Links

• PAPI API
• Documentação
• Suporte

Licença

MIT