Lo difícil nunca es la app por sí sola, sino la interfaz entre ella y tu instancia de n8n. Esta página aborda cuatro tareas y muestra siempre los dos lados: qué ocurre en n8n y qué ocurre en la app.
Bastan dos datos: la dirección de tu instancia de n8n y una clave API de n8n. Ambos se quedan en el dispositivo — la clave va al llavero de iOS, no a nuestros servidores.
https://mi-instancia.app.n8n.cloud — sin ninguna ruta detrás.Entonces la API pública no está activada en tu instancia. Algunos planes de hosting y algunas configuraciones autoalojadas la traen desactivada. En una instancia autoalojada se activa desde los ajustes de n8n o mediante variables de entorno; en un plan alojado depende de la tarifa.
Sin API pública ninguna app puede hablar con tu instancia — tampoco la nuestra. No es una limitación de WorkflowBuddy, es la propia interfaz.
Dos causas habituales: la clave API se cortó al copiarla, o la URL lleva una ruta de más. Introduce solo la dirección base — no la URL del editor y sin /api/v1 al final.
En el llavero de iOS de tu dispositivo. Si quieres, Face ID o Touch ID protege el acceso a la app y la visualización de la clave. Nosotros no guardamos tu clave API de n8n.
Defines una regla de monitorización por flujo: qué se avisa, cada cuánto se comprueba y cuándo hay que callar. Del resto se encarga la monitorización en nuestro servidor, también con la app cerrada.
Nada. Y es a propósito: WorkflowBuddy consulta a la API de n8n por las ejecuciones de tus flujos. No se inyecta ningún nodo de error, no se modifica ningún flujo y no se instala nada en tu instancia.
Eso significa también que un flujo que crees mañana se puede monitorizar de inmediato — no hay que prepararlo.
Los avisos de error para tu flujo más importante son la entrada gratuita Free — un flujo, sin límite de tiempo. La monitorización de todos los flujos y los tipos de incidente cancelado y bloqueado son de Premium Premium, igual que las horas de silencio y el intervalo de comprobación más fino.
Repasa tres puntos en orden: ¿están permitidas las notificaciones de WorkflowBuddy en los ajustes de iOS? ¿Hay una regla de monitorización activa para ese flujo concreto? ¿Y ocurrió durante tus horas de silencio?
Si sigue el silencio, envíate una notificación de prueba desde la regla. Si esa llega, la vía de entrega está bien.
Eliges entre 5, 15, 30 y 60 minutos. La comprobación ocurre en nuestro servidor, no en el teléfono, así que la notificación llega también con la app cerrada. El aviso «mínimo iOS: 15 min» de la app solo afecta a la actualización de la vista en segundo plano, no a las alertas.
En la versión gratuita la monitorización corre con el valor predeterminado de 15 minutos; elegir el intervalo es de Premium. Si lo necesitas al segundo, usa la API Push: entonces avisa el propio flujo, justo cuando ocurre.
Una que empezó y sigue corriendo pasado el tiempo que tú has fijado. Normalmente espera a un servicio externo que ha dejado de responder. Las aprobaciones abiertas no cuentan expresamente: esas pueden esperar.
Para cuando es tu flujo quien mejor sabe que hay algo que contar: una clave desde la app y un nodo HTTP Request corriente en n8n — sin nodo Code y sin firmas.
wb_ y se guarda en el llavero de este dispositivo.Añade un nodo HTTP Request, método POST, y pasa la clave como cabecera. Como cuerpo basta con JSON sencillo:
POST https://companion.amelus.de/api/notify
Authorization: Bearer wb_...
Content-Type: application/json
{
"title": "Error en la facturación",
"message": "La ejecución 4711 se detuvo en el paso 3",
"severity": "warning"
}severity es opcional y admite info, warning y critical; sin indicarlo se aplica info.
Se incluyen 50 mensajes al día de forma gratuita Free; con Premium el límite sube a 500 al día Premium. Ambos se cuentan por dispositivo.
La clave es desconocida o fue revocada. Al rotarla, la anterior queda invalidada de inmediato, así que también hay que sustituir la credencial en n8n. Comprueba además que la cabecera lleve realmente Bearer delante de la clave.
Se agotó el cupo diario o el de por minuto. La respuesta incluye una cabecera Retry-After que indica a partir de cuándo vuelve a funcionar. La causa habitual es un flujo en bucle.
Entonces nuestro servidor aceptó el mensaje y lo reenvió, y fue iOS quien lo descartó. Casi siempre las notificaciones de WorkflowBuddy están desactivadas. La app ya te lo dice en la pantalla de la API Push, en lugar de informar de un éxito que no llega.
Sí, en todos los que quieras. Créala una vez en n8n como credencial Header Auth: así todos los flujos la usan y cambiarla es una modificación en un solo sitio.
El flujo se detiene y te pregunta; tu respuesta lo continúa o lo detiene. En una frase: una notificación en el teléfono, un toque y sigue adelante — sin abrir n8n.
Dos nodos estándar, sin código.
https://companion.amelus.de/api/approval, cabecera Authorization: Bearer wb_... (la misma clave que para la API Push). El cuerpo se define como Expression:{{ JSON.stringify({
title: 'Factura 4711',
message: '¿Autorizar el pago de 2.400 €?',
resumeUrl: $execution.resumeUrl,
expiresAt: new Date(Date.now() + 60*60*1000).toISOString()
}) }}{{ $json.query.decision }} que distinga los valores approve y reject.expiresAt— el tiempo restante.No hay que configurar ninguna clave aparte: las aprobaciones usan la misma clave de la API Push, pero tienen su propio cupo.
Caímos nosotros mismos en todas; cada una cuesta media tarde:
$execution.resumeUrl tal cual. No le añadas nada, y menos ?decision=approve. Desde n8n 2.33 la URL de reanudación ya lleva una firma; un segundo ? la destruye, n8n responde 401 y en el registro de la instancia no se ve nada raro. El parámetro de la decisión lo pone el endpoint.
$execution.resumeUrl acaba literalmente en la petición y la aprobación no tiene adónde volver.
5 aprobaciones al día son gratuitas Free — suficientes para probarlo en un flujo real — y con Premium suben a 200 al día Premium. Este cupo va aparte del de los mensajes normales: un flujo hablador no puede quitarte una aprobación.
Directamente del dispositivo a tu propia instancia de n8n. Nuestro servidor solo reenvía la notificación y nunca guarda la dirección de reanudación. La app, por su parte, únicamente llama a direcciones cuyo host pertenece a una instancia que tú has configurado — una dirección colada no lleva a ninguna parte.
No pasa nada. La solicitud se guarda al entregarse, no al tocarla. Permanece como tarjeta en el panel mientras siga abierta.
La ejecución continuó mientras tanto, expiró o fue cancelada. La causa más frecuente al probar: el flujo se volvió a iniciar en el editor (véase la trampa 3).
La app rechaza a propósito cualquier llamada a un host ajeno. Ocurre cuando el flujo corre en una instancia que (todavía) no está configurada en la app — o cuando allí figura con otra dirección, por ejemplo interna en lugar de pública.
Entonces el flujo no envió expiresAt. n8n no comunica por sí mismo el plazo del nodo Wait, así que lo tiene que enviar el flujo — si falta, la app prefiere mostrar la solicitud sin cuenta atrás antes que inventarse un plazo.
Escríbenos a info@amelus.de o usa el formulario de contacto. Lo que aquí falte suele tener su sitio en esta página — tus avisos son bienvenidos.