Eventos de WhatsApp que impulsan tus flujos de trabajo en n8n.

Los webhooks firmados de Flowella activan tus flujos de trabajo de n8n a través del propio desencadenador de webhooks de n8n, y el nodo «Solicitud HTTP» envía las plantillas de WhatsApp a través de la API de Flowella.

Empieza gratis Referencia de la API
  • Hoy está en funcionamientoA través de la API de Flowella y los webhooks
  • PróximamenteUn nodo de Flowella para n8n
Flo, la mascota de Flowella, enchufa un cable en el último de los tres nodos de colores para conectarlos entre sí.

Lanza un evento y sigue la carga útil.

Aquí tienes un flujo de trabajo de n8n, dibujado al estilo de Flowella. Elige un evento de ejemplo y envíalo; a continuación, síguelo de nodo en nodo: el nodo «Switch» redirige cada evento, y un nodo «HTTP Request» avisa a tu equipo, actualiza tu lista de correo o envía una plantilla de WhatsApp a través de la API de Flowella. Selecciona cualquier nodo para ver exactamente qué ha recibido o enviado.

Flo señala una de las tres flechas de la señalización, del mismo modo que una rama de un flujo de trabajo elige una ruta
Solo los nodos propios de n8n
Ejemplo de evento
Acme ClubCuenta empresarial
Datos de ejemplo

Hoy

Hola, Ada: tu suscripción al Acme Club vence el 31 de octubre. Responde aquí si tienes alguna duda.
Eventos de FlowellaFlujo de trabajo de n8n
Datos de ejemplo

Lo que Flowella ha publicado en el webhook Datos de ejemplo

POST/webhook/flowella-events

Content-Type
application/json
X-Flowella-Signature
Se activa cuando se produce un evento

Envía un evento para ver las publicaciones de Flowella aquí.

POST/webhook/flowella-events

Content-Type
application/json
X-Flowella-Signature
5d2c9f1a…e19a
{
  "id": "6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10",
  "type": "message.received",
  "created_at": "2026-10-16T08:41:07.000Z",
  "payload_version": "1",
  "data": {
    "messageId": "clsamplemsg00000000000043",
    "conversationId": "clsampleconv0000000000007",
    "contactId": "clsamplecontact0000000003",
    "direction": "INBOUND",
    "type": "TEXT",
    "metaMessageId": "wamid.sample00000000000043"
  }
}

POST/webhook/flowella-events

Content-Type
application/json
X-Flowella-Signature
5d2c9f1a…e19a
{
  "id": "6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10",
  "type": "optout.created",
  "created_at": "2026-10-16T08:41:07.000Z",
  "payload_version": "1",
  "data": {
    "contactId": "clsamplecontact0000000003",
    "conversationId": "clsampleconv0000000000007",
    "phone": "+447700900123",
    "reason": "USER_KEYWORD"
  }
}

POST/webhook/flowella-events

Content-Type
application/json
X-Flowella-Signature
5d2c9f1a…e19a
{
  "id": "6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10",
  "type": "template.status_updated",
  "created_at": "2026-10-16T08:41:07.000Z",
  "payload_version": "1",
  "data": {
    "metaTemplateId": "1234567890123456",
    "templateName": "autumn_fair_invite",
    "status": "APPROVED",
    "language": "en_GB"
  }
}

Cada entrega tiene el mismo sobre, y los campos propios del evento se encuentran en su última clave: id type created_at payload_version data

Comprueba «X-Flowella-Signature» antes de actuar: se trata de un resumen hexadecimal HMAC-SHA256 del cuerpo sin procesar, generado con tu clave secreta de firma.

Switch: cada evento toma la primera regla cuyas condiciones se cumplan todas

Este evento: Aún no se ha comprobado type: message.received data.type: TEXT type: optout.created type: template.status_updated data.status: APPROVED

  1. Avisar al equipo {{ $json.body.type }} es igual a message.received {{ $json.body.data.type }} es igual a TEXT
  2. Actualizar la lista de correo {{ $json.body.type }} es igual a optout.created
  3. Enviar la campaña {{ $json.body.type }} es igual a template.status_updated {{ $json.body.data.status }} es igual a APPROVED

A la espera de un evento.

Se cumple la regla 1, por lo que el evento pasa a la fase de «Alerta» del equipo.

La regla 2 se cumple, por lo que el proceso continúa con la actualización de la lista de correo.

Se cumple la regla 3, por lo que el proceso continúa con «Enviar la campaña».

El Switch reenvía el evento sin modificarlo, por lo que el siguiente nodo también puede leer $json.body.

Lo que envió el nodo «Solicitud HTTP» Datos de ejemplo

POSThttps://alerts.example.com/hooks/whatsapp-replies

Content-Type
application/json

Este nodo solo se ejecuta cuando se cumple la regla 1.

POSThttps://alerts.example.com/hooks/whatsapp-replies

Content-Type
application/json

conversationId desde {{ $json.body.data.conversationId }}contactId desde {{ $json.body.data.contactId }}

{
  "conversationId": "clsampleconv0000000000007",
  "contactId": "clsamplecontact0000000003"
}
200 OK

POSThttps://alerts.example.com/hooks/whatsapp-replies

Content-Type
application/json

No se ha ejecutado. El Switch ha enviado este evento a otra salida.

El evento incluye identificadores, no la respuesta en sí, por lo que tu equipo abre la conversación en la bandeja de entrada de Flowella y responde desde allí.

Lo que envió el nodo «Solicitud HTTP» Datos de ejemplo

POSThttps://lists.example.com/v1/unsubscribes

Content-Type
application/json

Este nodo solo se ejecuta cuando se cumple la regla 2.

POSThttps://lists.example.com/v1/unsubscribes

Content-Type
application/json

phone desde {{ $json.body.data.phone }}reason desde {{ $json.body.data.reason }}

{
  "phone": "+447700900123",
  "reason": "USER_KEYWORD"
}
200 OK

POSThttps://lists.example.com/v1/unsubscribes

Content-Type
application/json

No se ha ejecutado. El Switch ha enviado este evento a otra salida.

«optout.created» es el evento que contiene un número de teléfono, para que tus otras herramientas también puedan dejar de enviarle mensajes.

Lo que envió el nodo «Solicitud HTTP» Datos de ejemplo

POSThttps://api.flowella.io/v1/templates/send

Authorization
Bearer flo_(oculta)Desde tus credenciales de n8n
Content-Type
application/json

Este nodo solo se ejecuta cuando se cumple la regla 3.

POSThttps://api.flowella.io/v1/templates/send

Authorization
Bearer flo_(oculta)Desde tus credenciales de n8n
Content-Type
application/json
Idempotency-Key
6f1d8a2c-4b7e-4c19-9a53-0e2b7c4d9f10

templateId desde {{ $json.body.data.metaTemplateId }}Idempotency-Key desde {{ $json.body.id }}, así que una entrega que se vuelve a intentar nunca se envía dos vecesrecipients de la lista de miembros que mantiene n8n

{
  "templateId": "1234567890123456",
  "whatsappChannelId": "clsamplechannel0000000001",
  "recipients": [
    { "phone": "+447700900123", "bodyParameters": ["Ada"] },
    { "phone": "+447700900456", "bodyParameters": ["Ben"] }
  ]
}
202 Accepted{ "id": "v1ts-0123456789abcdef", "status": "accepted" }

POSThttps://api.flowella.io/v1/templates/send

Authorization
Bearer flo_(oculta)Desde tus credenciales de n8n
Content-Type
application/json

No se ha ejecutado. El Switch ha enviado este evento a otra salida.

Guarda la clave API en una credencial de n8n, nunca en el propio flujo de trabajo. El código de estado «202 Accepted» significa que Flowella ha puesto el envío en cola y lo entrega en segundo plano.

Configúralo en tres pasos.

Necesitas una cuenta de Flowella vinculada a WhatsApp, una plantilla aprobada por Meta y un flujo de trabajo de n8n. A continuación:

  1. Paso 1: Añadir un activador de webhook

    Inicia el flujo de trabajo con el nodo «Webhook» de n8n, configúralo en «POST» y copia su URL de producción.

    Nodo de webhookDatos de ejemplo
    Método
    POST
    Ruta
    flowella-events
    URL
    https://n8n.example.com/webhook/flowella-events
    Escuchar
    Webhooks salientes

  2. Paso 2: Suscríbete en Flowella

    En Ajustes → Webhooks, añade esa URL, selecciona los eventos que desees y guarda el secreto de firma. Al hacer clic en «Enviar prueba», se activa un evento «webhook.test». Debes tener el rol de Propietario o Administrador.

    WebhooksDatos de ejemplo
    Punto final
    https://n8n.example.com/webhook/flowella-events
    Eventos
    message.received, optout.created, template.status_updated
    Secreto de firma
    Guardado
    Prueba enviada
    Configuración de webhooks

  3. Paso 3: Enviar de vuelta mediante una solicitud HTTP

    Añade un nodo «Solicitud HTTP» que envíe una solicitud POST a /v1/templates/send, con tu clave API de Flowella en una credencial de encabezado.

    Nodo de solicitud HTTPDatos de ejemplo
    Método
    POST
    URL
    https://api.flowella.io/v1/templates/send
    Credencial
    Header: Authorization
    202 Aceptadas
    Referencia de la API

Lo que funciona hoy en día y lo que está por venir.

Todo lo anterior funciona con la API de Flowella y los webhooks, que ya están disponibles. Próximamente estará disponible un nodo de Flowella para n8n.

Próximamente

Un nodo de Flowella para n8n

Publicaremos aquí cómo funciona cuando esté listo. Hasta entonces, el activador «Webhook» y el nodo «Solicitud HTTP» de n8n cumplen su función.

Es bueno saberlo

  • Comprueba la firmaCada solicitud incluye el campo «X-Flowella-Signature», un resumen hexadecimal HMAC-SHA256 del cuerpo sin procesar. Verifícalo antes de actuar. Mientras rotas el secreto, el campo «X-Flowella-Signature-Previous» también incluye la firma anterior.
  • Responde en un plazo de 10 segundosFlowella espera hasta 10 segundos a que se produzca un código 2xx e intenta la entrega un máximo de 3 veces, con un intervalo de 1 y 2 segundos entre cada intento. Responde primero y, a continuación, realiza cualquier tarea que requiera más tiempo.
  • Habrá reposicionesUna entrega reintentada lleva el mismo identificador de sobre, así que conserva los identificadores que ya hayas gestionado y trata las repeticiones como si no pasara nada.
  • Identificadores, no palabras«message.received» contiene los identificadores, la dirección y el tipo de mensaje, pero nunca su texto. Tu equipo lee y responde a las respuestas en la bandeja de entrada de Flowella.
Empieza gratis

Disponible desde hoy Hoy está en funcionamiento

Compatible con cualquier herramienta que envíe y reciba solicitudes HTTP, incluida n8n.

Eventos de webhook a los que puedes suscribirte hoy mismo

  • message.received
  • message.sent
  • message.delivered
  • message.read
  • message.failed
  • conversation.opened
  • conversation.closed
  • optout.created
  • template.status_updated
  • contact.created
  • contact.updated
  • contact.deleted

Además de «webhook.test», que «Send test» activa cuando se solicita.

Flo salta de alegría con el puño en alto y el móvil en la mano

Empieza a crear con Flowella y n8n.

Todo lo que aparece en esta página funciona actualmente a través de la API de Flowella y los webhooks. Reserva una demostración de 30 minutos en Teams y analizaremos juntos tus flujos de trabajo.

Reserva una demostración Referencia de la API
Ver todas las integraciones