Avisos de tus flujos de n8n en tu iPhone

n8n puede notificar de muchas formas, por ejemplo con su nodo de Pushover integrado o con apps de chat, pero todas envían cada mensaje por separado. Honk aporta lo que necesita un flujo de trabajo cuando funciona sin nadie pendiente: las repeticiones se reúnen en un grupo, un fallo y su recuperación quedan juntos y un reintento nunca avisa dos veces.

Esta guía cubre las dos formas de conectarlo: el nodo comunitario de Honk y, para las instancias que no admiten nodos comunitarios, el nodo HTTP Request. Al final, monta un flujo de errores que notifica cada ejecución fallida.

Antes de empezar

• Una cuenta de Honk (por ahora solo con invitación: solicita acceso) y un proyecto para tus flujos de trabajo con una clave de ingesta: en la app web, abre el proyecto y entra en Claves.
• n8n 1.x o 2.x.

Opción 1: el nodo de Honk

En un n8n autoalojado, instala el nodo comunitario desde Settings ▸ Community Nodes o con npm:

# Self-hosted n8n: Settings → Community Nodes → Install → n8n-nodes-honk
# Without the UI (Docker or npm installs), in the n8n user folder:
cd ~/.n8n/nodes && npm install n8n-nodes-honk
# then restart n8n

Crea una credencial Honk API con la URL del servidor y la clave de ingesta. Test comprueba la clave sin enviar nada a tu teléfono. Después añade Honk ▸ Send message a un flujo de trabajo:

1. Settings → Community Nodes → Install → n8n-nodes-honk
2. Credentials → New → Honk API
     Server URL:     https://honk-me.app
     Ingestion Key:  honk_…
     (Test checks the key; nothing is sent to your phone)
3. Add the node Honk → Send message
     Message:   Wants a quote for an online shop, budget €4,000. Reply within a day.
     Title:     New request from Ana Pop
     Severity:  Light Honk (Info)
   Additional Fields
     Priority:  High
     Category:  Customers
     Source:    n8n
     Group Key: requests/{{ $json.id }}
   Options
     Idempotency Key: request-{{ $json.id }}   (default: execution + node + item)
4. Node Settings → Retry On Fail: on (the same key, so never a duplicate)

El nodo envía una solicitud por cada elemento de entrada. Cada elemento lleva una clave de idempotencia, que por defecto se forma con la ejecución, el nodo y el elemento, así que puedes activar Retry On Fail sin miedo: un reintento devuelve el evento original en lugar de enviar un segundo aviso.

Si el mismo evento puede llegar en ejecuciones distintas, como un webhook que el remitente entrega dos veces, define tu propia clave en Options ▸ Idempotency Key, por ejemplo request-{{ $json.body.id }}. Honk acepta cada clave una sola vez cada 24 horas.

Opción 2: el nodo HTTP Request

En n8n Cloud, o en cualquier instancia con los nodos comunitarios desactivados, el nodo HTTP Request integrado hace lo mismo, aunque con más campos que rellenar. Guarda la clave en una credencial de n8n (Header Auth), nunca en el propio nodo:

HTTP Request node
  Method:          POST
  URL:             https://honk-me.app/v1/messages
  Authentication:  Generic Credential Type → Header Auth
                   Name "Authorization", Value "Bearer honk_…" (an n8n credential)
  Header:          Idempotency-Key = {{ $execution.id }}-{{ $runIndex }}
  Settings:        Retry On Fail (3 tries, 2000 ms)
  Body (JSON):
  {
    "title": "New request from Ana Pop",
    "message": "Wants a quote for an online shop, budget €4,000. Reply within a day.",
    "severity": "light",
    "priority": "high",
    "category": "customers",
    "source": "n8n",
    "group_key": "requests/{{ $json.id }}"
  }

La cabecera de idempotencia usa el id de la ejecución y el índice de ejecución del nodo (run index), así que Retry On Fail la reutiliza.

Notifica cada ejecución fallida

Cuando falla un flujo de trabajo, n8n inicia el flujo de errores (Error Workflow) que tenga asignado. Crea uno que envíe el fallo a Honk, agrupado por flujo:

Workflow "Honk: workflow errors"
  1. Error Trigger
  2. Honk → Send message
       Message:   {{ $json.execution.error.message }}
       Title:     n8n: {{ $json.workflow.name }} failed
       Severity:  Long Honk (Error)
     Additional Fields
       Event Type:  Problem
       Group Key:   n8n/{{ $json.workflow.id }}
       Source:      n8n
       Category:    Automation
       URL:         {{ $json.execution.url }}
     Options
       Idempotency Key: n8n-error-{{ $json.execution.id }}

Then, in every workflow that should report: Settings → Error Workflow → "Honk: workflow errors"

Cada flujo de trabajo tiene su propio grupo, n8n/<workflow id>. El primer fallo llega como Bocinazo largo, con un enlace a la ejecución fallida; si el flujo sigue fallando cada cinco minutos, recibes actualizaciones discretas con un recuento, no una notificación por ejecución.

Pruébalo con un webhook

El repositorio del nodo incluye un flujo de ejemplo, examples/quote-request.json: un webhook recibe una solicitud de presupuesto y Honk te la notifica, con un grupo por solicitud. Impórtalo con Workflows ▸ Import from File, elige tu credencial de Honk, actívalo y envíale una solicitud de prueba:

curl -X POST https://your-n8n.example.com/webhook/quote-request \
  -H 'Content-Type: application/json' \
  -d '{"id": 4812, "name": "Ana", "email": "[email protected]", "summary": "3 rooms, 2 bathrooms"}'

Qué añade Honk a n8n

Un nodo de notificaciones envía un mensaje, y ahí termina. Honk mantiene un grupo por cada cosa que está pasando, decide cuándo debe vibrar tu teléfono y cierra el incidente cuando llega la recuperación. Además, reúne tus flujos de trabajo con tus servidores, tus scripts y tu casa en una sola bandeja de entrada, con horas de silencio y un resumen para las ejecuciones rutinarias.