Skip to main content
O pacote n8n-nodes-wppfy adiciona dois nós ao n8n:

WppFy

Todas as rotas desta documentação como operações: enviar mensagens, gerenciar chats, grupos, canais, etiquetas, CRM, catálogo e mais.

WppFy Trigger

Inicia um workflow quando chegam mensagens e outros eventos do WhatsApp. O webhook é criado e removido automaticamente.

​
Instalação

  1. No n8n, acesse Settings → Community Nodes.
  2. Clique em Install.
  3. Digite n8n-nodes-wppfy, aceite o aviso e clique em Install.

​
Credencial

Crie uma credencial WppFy API: Ao salvar, o n8n testa a credencial com GET /instance/status. Cada credencial corresponde a uma instância: crie uma por número.

​
Enviar mensagens (nó WppFy)

  1. Adicione o nó WppFy ao workflow.
  2. Escolha o Resource (por exemplo Send Message) e a Operation (por exemplo Send text message).
  3. Preencha os campos obrigatórios. Os opcionais ficam em Additional Fields → Add Field.
Campos com listas ou objetos (opções de menu, cards de carrossel, participantes de grupo) aceitam JSON. Você pode digitar o JSON ou usar uma expressão, como {{ JSON.stringify($json.participantes) }}.
Os placeholders da WppFy, como {{name}} e {{first_name}}, funcionam em campos de texto comuns. Dentro de uma expressão do n8n, escreva {{ "{{name}}" }} para que o n8n não tente interpretá-los.

​
Receber eventos (nó WppFy Trigger)

  1. Adicione o nó WppFy Trigger e selecione a credencial.
  2. Em Events, escolha os eventos que iniciam o workflow (padrão: Messages).
  3. Em Ignore Messages, mantenha Sent by API se o workflow responder com o nó WppFy. Assim as próprias respostas não disparam o workflow de novo.
  4. Ative o workflow.
Ao ativar, o nó adiciona um webhook na instância apontando para o n8n. Ao desativar, esse webhook é removido. Webhooks que você já tem na instância não são alterados. Cada evento vira um item com o payload do evento (EventType, message, chat, owner…). O token da instância que vem no payload é removido por padrão; para mantê-lo, ative Options → Include Instance Token.
O n8n precisa estar acessível pela internet para receber os eventos: n8n Cloud, ou self-hosted com WEBHOOK_URL público. Um n8n rodando só em localhost não recebe eventos.

​
Agentes de IA

O nó WppFy pode ser usado como ferramenta de um AI Agent. Adicione o WppFy como tool, escolha a operação que o agente pode usar (por exemplo Send text message) e deixe o modelo preencher os campos com $fromAI().

​
Operações disponíveis

O nó segue os grupos da Referência API: Instance, Proxy, Profile, Business, Calls, Send Message, Async Message, Message Actions and Search, Chats, Contacts, Blocklist, Labels, Groups and Communities, Newsletters and Channels, Quick Replies, CRM e Chatwoot Integration. A lista completa de operações está na página do pacote no npm.