Skip to main content
El paquete n8n-nodes-wppfy agrega dos nodos a n8n:

WppFy

Todas las rutas de esta documentación como operaciones: enviar mensajes, gestionar chats, grupos, canales, etiquetas, CRM, catálogo y más.

WppFy Trigger

Inicia un workflow cuando llegan mensajes y otros eventos de WhatsApp. El webhook se crea y se elimina automáticamente.

​
Instalación

  1. En n8n, vaya a Settings → Community Nodes.
  2. Haga clic en Install.
  3. Escriba n8n-nodes-wppfy, acepte el aviso y haga clic en Install.

​
Credencial

Cree una credencial WppFy API: Al guardarla, n8n prueba la credencial con GET /instance/status. Cada credencial corresponde a una instancia: cree una por número.

​
Enviar mensajes (nodo WppFy)

  1. Agregue el nodo WppFy al workflow.
  2. Elija el Resource (por ejemplo Send Message) y la Operation (por ejemplo Send text message).
  3. Complete los campos obligatorios. Los opcionales están en Additional Fields → Add Field.
Los campos con listas u objetos (opciones de menú, tarjetas de carrusel, participantes de grupo) aceptan JSON. Puede escribir el JSON o usar una expresión, como {{ JSON.stringify($json.participantes) }}.
Los placeholders de WppFy, como {{name}} y {{first_name}}, funcionan en campos de texto normales. Dentro de una expresión de n8n, escriba {{ "{{name}}" }} para que n8n no intente evaluarlos.

​
Recibir eventos (nodo WppFy Trigger)

  1. Agregue el nodo WppFy Trigger y seleccione la credencial.
  2. En Events, elija los eventos que inician el workflow (predeterminado: Messages).
  3. En Ignore Messages, mantenga Sent by API si el workflow responde con el nodo WppFy, para que sus propias respuestas no vuelvan a iniciar el workflow.
  4. Active el workflow.
Al activar, el nodo agrega un webhook a la instancia que apunta a n8n. Al desactivar, ese webhook se elimina. Los webhooks que ya tenga en la instancia no se modifican. Cada evento se convierte en un ítem con el payload del evento (EventType, message, chat, owner…). El token de la instancia incluido en el payload se elimina por defecto; para conservarlo, active Options → Include Instance Token.
n8n debe ser accesible desde internet para recibir eventos: n8n Cloud, o self-hosted con un WEBHOOK_URL público. Un n8n que solo corre en localhost no recibe eventos.

​
Agentes de IA

El nodo WppFy se puede usar como herramienta de un AI Agent. Agregue WppFy como tool, elija la operación que el agente puede usar (por ejemplo Send text message) y deje que el modelo complete los campos con $fromAI().

​
Operaciones disponibles

El nodo sigue los grupos de la Referencia 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 y Chatwoot Integration. La lista completa de operaciones está en la página del paquete en npm.