Volver al blog

Notificaciones push para n8n: alertas en tu teléfono desde cualquier workflow

Notificaciones push para n8n: alertas en tu teléfono desde cualquier workflow

n8n es bueno haciendo cosas mientras no estás, y malo avisándote de ellas. Llega un formulario, un feed recibe una publicación nueva, una sincronización falla a las 3 a. m., y el único registro es una línea en la lista de ejecuciones que abrirás la semana que viene.

Esta guía conecta n8n a tu teléfono. Llamarás a la API de Pocket Alert desde un nodo HTTP Request, envolverás esa llamada en un sub-workflow reutilizable, añadirás un workflow de errores que te avisa cuando cualquier workflow falla y terminarás con botones Aprobar y Rechazar que reanudan un workflow desde la pantalla de bloqueo.

Todo lo que aparece abajo se probó en n8n 2.45.7 (la imagen Docker n8nio/n8n), con el nodo HTTP Request apuntando a un capturador de peticiones local para poder comprobar cada petición contra la referencia de la API.

Qué necesitas

Paso 1: una credencial Header Auth

Pocket Alert lee la clave de API desde una cabecera llamada Token. En n8n, crea una credencial de tipo Header Auth:

  • Name: Token
  • Value: tu clave de API

Llama a la credencial Pocket Alert. Guardar la clave como credencial la mantiene fuera del JSON del workflow, así que puedes exportar y compartir workflows sin filtrarla.

Paso 2: el nodo HTTP Request

Añade un nodo HTTP Request y configúralo así:

CampoValor
MethodPOST
URLhttps://api.pocketalert.app/v1/messages
AuthenticationGeneric Credential Type, luego Header Auth, luego la credencial Pocket Alert
Send BodyOn
Body Content TypeJSON
Specify BodyUsing JSON

El cuerpo necesita title y message. level y actions son opcionales. La forma más obvia de escribirlo es JSON plano con expresiones dentro de las cadenas:

{
  "title": "New signup",
  "message": "{{ $json.name }} on {{ $json.plan }}",
  "level": "high"
}

Eso funciona hasta que un valor contiene unas comillas dobles o un salto de línea. Con name valiendo Ana "AJ" Silva, n8n detiene el nodo con «The value in the JSON Body field is not valid JSON», porque la comilla cierra la cadena antes de tiempo. Los mensajes de formularios y los títulos de RSS tropiezan con esto antes de lo que esperas.

La solución es dejar que JavaScript construya el JSON. Pon todo el cuerpo en una sola expresión:

{{ JSON.stringify({
  title: 'New signup',
  message: $json.name + ' on ' + $json.plan,
  level: 'high'
}) }}

O, si prefieres mantener la estructura JSON, envuelve cada valor dinámico en JSON.stringify() y quita las comillas que lo rodean: "message": {{ JSON.stringify($json.name + ' on ' + $json.plan) }}. Ambas opciones produjeron JSON válido con las comillas escapadas en las pruebas. Esto es lo que envió n8n:

POST /v1/messages
Content-Type: application/json
Token: <your API key>
User-Agent: n8n

{"title":"New signup","message":"Ana \"AJ\" Silva on Pro","level":"high"}

level acepta silent, low, default, high o critical. high atraviesa Concentración en el iPhone. critical suena aunque el interruptor de silencio esté activado y con No molestar. Es una función de pago; en el plan gratuito llega como high. Más información en niveles de prioridad.

Paso 3: un sub-workflow «Enviar push» para todo

Copiar ese nodo en cada workflow significa cambiar diez workflows cuando cambias la clave, la lógica de niveles o el botón. Ponlo en un único sub-workflow y llámalo desde el resto.

Copia este JSON y pégalo en un lienzo vacío de n8n (o guárdalo en un archivo y usa Import from File):

{
  "name": "Send push",
  "nodes": [
    {
      "parameters": {
        "workflowInputs": {
          "values": [
            { "name": "title" },
            { "name": "message" },
            { "name": "level" },
            { "name": "url" }
          ]
        }
      },
      "name": "When called",
      "type": "n8n-nodes-base.executeWorkflowTrigger",
      "typeVersion": 1.1,
      "position": [0, 0]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.pocketalert.app/v1/messages",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={{ JSON.stringify({\n  title: $json.title,\n  message: $json.message,\n  level: $json.level || 'default',\n  actions: $json.url ? [{ type: 'view', label: 'Open', value: $json.url }] : []\n}) }}",
        "options": {}
      },
      "name": "Pocket Alert",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [220, 0]
    }
  ],
  "connections": {
    "When called": { "main": [[{ "node": "Pocket Alert", "type": "main", "index": 0 }]] }
  },
  "settings": { "executionOrder": "v1" }
}

Después de importarlo, abre el nodo Pocket Alert y selecciona tu credencial. El sub-workflow recibe cuatro entradas: title, message, un level opcional que por defecto es default, y una url opcional. Cuando url está definida, la push incluye un botón Open que la abre. Un array actions vacío se acepta y simplemente significa que no hay botones.

Publícalo. En n8n 2.x, las ejecuciones de producción llaman a la versión publicada de un sub-workflow. Hasta que publiques Send push, cada llamada programada o disparada por webhook falla con «Workflow is not active and cannot be executed», aunque una prueba manual desde el editor funcione, porque las ejecuciones manuales usan el borrador. Lo mismo vale tras cada edición: los cambios en Send push llegan a producción solo cuando vuelves a publicar.

Para llamarlo desde otro workflow, añade un nodo Execute Sub-workflow, elige Send push de la lista y rellena los cuatro campos con expresiones, por ejemplo New order #{{ $json.id }} como título.

Recibe una push cuando cualquier workflow falle

n8n ejecuta un workflow de errores independiente cuando falla una ejecución de producción. Crea un workflow llamado Error alert con un nodo Error Trigger seguido de un nodo Execute Sub-workflow que llama a Send push con estos campos:

EntradaExpresión
titleFailed: {{ $json.workflow.name }}
message{{ ($json.execution?.lastNodeExecuted ?? 'Trigger') + ': ' + ($json.execution ?? $json.trigger).error.message }}
levelhigh
url{{ $json.execution?.url ?? '' }}

Publica también Error alert; en 2.x, un workflow de errores sin publicar se omite con el mismo mensaje «not active» en el registro. Después, abre cada workflow que te importe, ve a Workflow settings y configura Error workflow como Error alert.

Para comprobar las rutas, se hizo fallar a propósito un workflow llamado «Sync orders»: su nodo HTTP Request recibió un 503. El Error Trigger recibió esto (recortado):

{
  "execution": {
    "id": "5",
    "url": "http://localhost:5678/workflow/WPErAWNJyV6MWO11/executions/5",
    "error": {
      "message": "Service unavailable - try again later or consider setting this node to retry automatically (in the node settings)",
      "description": "down",
      "httpCode": "503"
    },
    "lastNodeExecuted": "Fetch orders",
    "mode": "webhook"
  },
  "workflow": { "id": "WPErAWNJyV6MWO11", "name": "Sync orders" }
}

El teléfono recibió «Failed: Sync orders» con «Fetch orders: Service unavailable...» y un botón Open que apuntaba a esa ejecución. Hay dos detalles importantes:

  • El enlace de la ejecución usa tu URL pública. n8n construye execution.url a partir de N8N_EDITOR_BASE_URL, y si no existe usa la URL del webhook. En la prueba era localhost, que no sirve de nada en un teléfono. En una instancia autoalojada, define N8N_EDITOR_BASE_URL con la dirección en la que abres n8n.
  • Un trigger que falla se ve distinto. Cuando el propio trigger falla, por ejemplo un feed RSS que devuelve HTML, no hay ejecución. El payload tiene trigger.error en lugar de execution, y no hay URL. Los ?. y ?? de las expresiones de arriba cubren ese caso; en la prueba llegó como «Failed: Changelog to phone» con «Trigger: Non-whitespace before first tag...» y sin botón.

Tres workflows que la gente construye de verdad

Cada uno de estos termina en el mismo nodo Execute Sub-workflow que llama a Send push. Los tres se ejecutaron contra el capturador y generaron peticiones válidas.

Un nuevo envío de formulario

Un n8n Form Trigger con tres campos etiquetados Name, Email y Message. La salida del formulario usa las etiquetas como claves, así que las entradas son:

  • title: Contact form: {{ $json.Name }}
  • message: {{ $json.Email }} y {{ $json.Message }} en la línea siguiente
  • level: default

Deja url vacío aquí. Un botón view necesita una URL http(s), así que un enlace mailto: haría que la petición fuera rechazada con 400. Lo mismo funciona con un nodo Webhook detrás del formulario de tu propia web: los campos están entonces en $json.body. Más ideas en alertas de envío de formularios.

Una nueva publicación en un feed RSS

Un RSS Feed Trigger que consulta un changelog o un blog cada 10 minutos:

  • title: New post: {{ $json.title }}
  • message: {{ $json.contentSnippet }}
  • level: low
  • url: {{ $json.link }}

contentSnippet es la descripción sin HTML, así que <p>You can now work <b>offline</b>.</p> llegó como texto plano. El trigger solo emite elementos más recientes que el último que vio, así que activarlo no te inunda con el archivo histórico. El botón Open lleva a la publicación.

Una comprobación programada

Un Schedule Trigger cada 5 minutos, seguido de un nodo HTTP Request que hace GET a tu web con dos opciones activadas en Response: Include Response Headers and Status y Never Error. Sin Never Error, un 503 detiene el nodo en lugar de llegar al paso siguiente. Después, un nodo If con {{ $json.statusCode }} no igual a 200, y en la rama verdadera:

  • title: Site check failed: {{ $json.statusCode }}
  • level: high
  • url: la página que estás comprobando

Never Error cubre los códigos de estado incorrectos, no una web que no responde en absoluto. Un fallo de DNS o un timeout siguen haciendo fallar el nodo, y entonces el workflow de errores envía la push. Ten en cuenta que una comprobación así te avisa en cada ejecución mientras la web esté caída: doce push por hora con un intervalo de 5 minutos. Más patrones en alertas de automatización.

Aprueba o rechaza desde la pantalla de bloqueo

Algunos workflows no deberían terminar sin una persona: un reembolso por encima de un límite, una publicación a punto de salir, un agente de IA a punto de tocar producción. Los botones de acción http de Pocket Alert envían una petición directamente desde el teléfono, y el nodo Wait de n8n puede pausar hasta que llegue una petición. Júntalos:

  1. Un trigger con la petición, aquí un nodo Webhook que recibe {"order":"A-1042","amount":129}.
  2. Un nodo HTTP Request que envía la push con dos botones.
  3. Un nodo Wait: Resume en On Webhook Call, HTTP Method POST, Limit Wait Time activado, 2 horas.
  4. Un nodo If: {{ $json.body.decision }} igual a approve.

El cuerpo del nodo HTTP Request:

{{ JSON.stringify({
  title: 'Refund $' + $json.body.amount + '?',
  message: 'Order ' + $json.body.order + ' is asking for a refund.',
  level: 'high',
  actions: ['approve', 'decline'].map(decision => ({
    type: 'http',
    label: decision === 'approve' ? 'Approve' : 'Decline',
    value: JSON.stringify({
      url: $execution.resumeUrl,
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ decision })
    })
  }))
}) }}

El value de un botón http es en sí mismo una cadena JSON, por eso hay un JSON.stringify dentro de otro JSON.stringify. $execution.resumeUrl es la dirección en la que el nodo Wait escucha para esta ejecución concreta.

En las pruebas, un POST a la URL del botón Approve con su cuerpo devolvió 200, el workflow se reanudó y $json.body.decision valió approve, así que el nodo If tomó la rama verdadera. Decline fue por la rama falsa. Los detalles que costaron varios intentos:

  • Envía la decisión en el cuerpo, no en la URL. En n8n 2.45.7, la URL de reanudación ya termina en ?signature=.... Añadir ?decision=approve rompe la firma y n8n responde 401. Un cuerpo JSON evita manipular cadenas.
  • El segundo toque se rechaza. Una vez reanudada la ejecución, otro toque recibe 409 «has finished already», y la app muestra su notificación de petición fallida con un botón Retry. Cuenta el primer toque.
  • Sin respuesta, es un no. Cuando se agota el límite de 2 horas, el nodo Wait continúa sin decision, así que el nodo If va por la rama falsa. Haz que esa rama sea la segura.
  • El teléfono tiene que llegar a n8n. La petición sale del teléfono, no de Pocket Alert. $execution.resumeUrl se construye a partir de tu URL de webhook (WEBHOOK_URL, que n8n 2.45 te pide renombrar a N8N_WEBHOOK_URL). En n8n Cloud o detrás de un dominio público funciona sin más. En un servidor doméstico funciona mientras el teléfono esté en la misma red, o a través de una VPN como Tailscale.
  • Los botones son una función de pago. En el plan gratuito la push sigue llegando, pero sin botones. Los botones de notificaciones del sistema requieren la aplicación de Pocket Alert 2.0.1 o posterior.

El mismo patrón para agentes de IA está en notificaciones con humano en el bucle.

O envía un POST a un webhook de Pocket Alert

Si prefieres no guardar una clave de API en n8n, crea un webhook en Webhooks desde la consola y haz que el nodo HTTP Request envíe JSON por POST a su URL https://p4a.me/wh/... sin autenticación. Una plantilla del webhook convierte el payload en el mensaje. La contrapartida: el título siempre es Webhook <name>, y el texto viene de la plantilla en lugar del workflow. El historial del webhook registra cada petición recibida, lo que ayuda al depurar.

Límites y solución de problemas

  • Cuota diaria. El plan gratuito permite 50 mensajes al día, con reinicio a las 00:00 UTC. Un bucle sobre 200 elementos envía 200 push. Tras el límite, la API responde 429; no dejes que n8n lo reintente, la respuesta no cambiará hasta el reinicio. Consulta límites diarios.
  • 401 significa que la clave es incorrecta, o que el nombre de la cabecera en la credencial no es Token.
  • 400 significa que al cuerpo le falta title o message (una expresión que resultó vacía cuenta), tiene un nivel desconocido, o tiene un botón no válido: más de 3, una URL view que no es http(s), o un valor http que no es una cadena JSON con una url.
  • «not valid JSON» en n8n significa que un valor rompió el cuerpo JSON. Cambia a JSON.stringify como en el Paso 2.
  • Nada al fallar. Comprueba que Error alert y Send push estén ambos publicados y que el workflow que falla tenga Error alert configurado en sus ajustes. Las pruebas manuales desde el editor no activan el workflow de errores.

Preguntas frecuentes

¿Existe un nodo de Pocket Alert para n8n?

Por ahora no. El nodo HTTP Request cubre toda la API, y el sub-workflow Send push te da un bloque similar a un nodo que configuras una sola vez. Si usas Make, existe una aplicación oficial para Make.

¿Funciona en n8n Cloud?

Sí. Todo lo que aparece aquí usa nodos integrados. En Cloud, las URL de ejecución y de reanudación ya son públicas, lo que ahorra la configuración de URL que necesita una instancia autoalojada.

¿Puedo enviar solo a un teléfono?

Añade device_id con el ID del dispositivo al cuerpo. Sin él, la push va a todos tus dispositivos. application_id archiva el mensaje bajo una aplicación, así que las alertas de n8n tienen su propio canal en la app.

Crea una cuenta gratuita, importa el workflow Send push y apunta tu workflow de errores hacia él. La próxima ejecución fallida aparecerá en tu teléfono en lugar de en la lista de ejecuciones.

Comparte este artículo