n8n-nodes-zappfy

Nó da comunidade n8n para integração com a API Zappfy WhatsApp. Permite enviar mensagens, gerenciar grupos, contatos, etiquetas, campanhas em massa, configurar chatbot e muito mais — tudo a partir do n8n.

Recursos

• Mensagens: enviar texto, mídia, contato, localização, status, menus interativos, carrossel, botões PIX, pedidos de pagamento; reagir, editar, excluir, marcar como lida, baixar mídia
• Conversas: arquivar, fixar, silenciar, marcar lida/não-lida, bloquear, definir etiquetas, editar leads
• Contatos: listar, adicionar, remover
• Grupos: criar, gerenciar participantes (adicionar/remover/promover), atualizar nome/descrição/imagem, links de convite
• Comunidades: criar, gerenciar grupos
• Instância: conectar, status, privacidade, presença, proxy
• Perfil: alterar nome e foto
• Disparador (Bulk): campanhas simples e avançadas, controle (pausar/retomar/cancelar), limpeza
• Chatbot: triggers, agents IA, knowledge base, functions
• Resposta Rápida: criar, listar, editar
• Etiquetas: criar, listar, editar
• Chamadas: iniciar, rejeitar
• Chatwoot: configuração de integração
• Webhook: configuração e gatilho automático

Instalação

Pelo painel do n8n (recomendado)

1. Vá em Configurações → Community Nodes
2. Clique em Install
3. Digite n8n-nodes-zappfy
4. Aceite os riscos e clique em Install

Via npm

npm install n8n-nodes-zappfy

Reinicie o n8n após a instalação.

Configuração da credencial

1. No n8n, crie uma nova credencial do tipo Zappfy API
2. Cole o Token Da Instância (obtido no painel Zappfy em Configurações Da Instância)
3. (Opcional) Altere a URL Base apenas se estiver usando uma instalação self-hosted
4. Clique em Test para validar — o teste chama GET /instance/status

Uso

Nó de ação Zappfy

Adicione o nó Zappfy ao seu workflow. Selecione um Recurso (Mensagem, Conversa, Grupo, etc.) e uma Operação. Os campos relevantes aparecerão automaticamente.

Exemplo — enviar texto:

• Recurso: Mensagem
• Operação: Enviar Texto
• Número: 5511999999999
• Texto: Olá!

Nó de gatilho Zappfy Trigger

Adicione o nó Zappfy Trigger como ponto de partida do workflow. Selecione os Eventos que deseja receber (Mensagens, Conversas, Grupos, etc.). Ao ativar o workflow, o n8n registra automaticamente um webhook na sua instância Zappfy. Ao desativar, o webhook é desabilitado.

Documentação da API

A documentação completa da API Zappfy está em https://docs.zappfy.io.

Licença

MIT