> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wppfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> Automatice WhatsApp en n8n con los nodos oficiales de WppFy.

El paquete [`n8n-nodes-wppfy`](https://www.npmjs.com/package/n8n-nodes-wppfy) agrega dos nodos a n8n:

<CardGroup cols={2}>
  <Card title="WppFy" icon="paper-plane">
    Todas las rutas de esta documentación como operaciones: enviar mensajes, gestionar chats, grupos, canales, etiquetas, CRM, catálogo y más.
  </Card>

  <Card title="WppFy Trigger" icon="bolt">
    Inicia un workflow cuando llegan mensajes y otros eventos de WhatsApp. El webhook se crea y se elimina automáticamente.
  </Card>
</CardGroup>

## Instalación

<Tabs>
  <Tab title="Desde la interfaz">
    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**.
  </Tab>

  <Tab title="Self-hosted (CLI / Docker)">
    ```bash theme={null}
    cd ~/.n8n/nodes
    npm install n8n-nodes-wppfy
    # reinicie n8n
    ```

    En Docker, ejecute el comando dentro del contenedor (o en el volumen `~/.n8n/nodes`) y reinícielo.
  </Tab>
</Tabs>

## Credencial

Cree una credencial **WppFy API**:

| Campo | Valor |
| - | - |
| **Instance Token** | Token de su instancia, disponible en el [panel de WppFy](https://wppfy.com/dashboard) |
| **Base URL** | `https://api.wppfy.com` (predeterminado) |

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**.

| Parámetro | Ejemplo |
| - | - |
| Resource | Send Message |
| Operation | Send text message |
| Number | `5511999999999` o el ID de un grupo que termina en `@g.us` |
| Text | `¡Hola {{ $json.nombre }}!` |

<Tip>
  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) }}`.
</Tip>

<Note>
  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.
</Note>

## 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**.

<Warning>
  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.
</Warning>

## 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](/es/api-reference/start-here): 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](https://www.npmjs.com/package/n8n-nodes-wppfy).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.