Volver al blog

n8n funciona en pruebas, pero el webhook de producción falla: guía para VPS

Ilustración para Cloud Linux

Un webhook que responde dentro del editor de n8n puede fallar en producción porque utiliza otra URL, el flujo no está publicado o la dirección pública no coincide con el proxy. Antes de cambiar el VPS, identifica qué solicitud llega y en qué punto se detiene.

La comprobación debe hacerse con un flujo de demostración y datos ficticios. Así puedes probar varias veces sin duplicar pedidos, enviar mensajes o modificar sistemas de clientes.

Separa las dos direcciones del webhook

El nodo Webhook distingue el acceso de pruebas y el de producción. Copia la dirección mostrada en la opción correspondiente; no cambies una parte a mano suponiendo que siempre será equivalente. Revisa también el método HTTP esperado y la ruta del nodo.

Comprueba el estado del flujo: según la versión de n8n, debe estar publicado o activado para atender su dirección de producción. La documentación del nodo Webhook explica la diferencia de uso entre ambos modos.

Observa la solicitud completa

Envía una petición de prueba desde fuera del VPS y guarda hora, método, ruta y estado HTTP. Después busca la ejecución correspondiente en n8n. Una URL que abre en un navegador no demuestra que acepte un POST con el cuerpo que enviará la integración.

  • No aparece ninguna ejecución: revisa dominio, ruta, proxy y estado del flujo.
  • Hay ejecución, pero falla un nodo: la solicitud ya llegó; investiga el error de ese nodo.
  • La integración espera demasiado: revisa cuándo debe devolverse la respuesta y qué trabajo ocurre antes.
  • Solo falla un emisor: compara autenticación, método y formato del mensaje.

Estas pistas orientan el diagnóstico; no convierten un código HTTP en una causa única. Conserva el texto del error y los registros del mismo intervalo.

Revisa HTTPS y la URL pública detrás del proxy

Si n8n trabaja detrás de un proxy, su dirección interna puede ser distinta de la pública. La guía oficial para URL de webhooks con proxy describe la configuración necesaria. Consulta la variable de URL pública y el número de saltos de proxy que corresponden a tu versión y arquitectura; no copies valores de una guía antigua sin contrastarlos.

Comprueba que el certificado cubre el nombre usado por la integración y que la ruta llega al servicio correcto. No expongas el puerto interno para evitar revisar el proxy ni elimines autenticación para que una prueba responda.

Construye una comprobación pequeña y repetible

  1. Crea un flujo separado que reciba un identificador ficticio.
  2. Haz que responda con una confirmación simple, sin conexiones a sistemas externos.
  3. Prueba su URL de producción desde una conexión externa.
  4. Relaciona el identificador con una única ejecución.
  5. Incorpora después la autenticación y los pasos de la integración, uno por uno.

Si esta comprobación funciona, reduce el flujo que falla hasta encontrar la diferencia relevante. Documenta la configuración antes de cambiarla y conserva una vía de regreso.

Preguntas frecuentes

¿Necesito ampliar el VPS si el webhook devuelve un error?

No sin comprobar el motivo. Una ruta incorrecta o un flujo sin publicar no requieren más recursos. La capacidad se evalúa con carga y registros reales.

¿Puedo dejar la URL de pruebas en mi aplicación?

Utiliza el modo apropiado para su operación y verifica la documentación de tu versión. No bases una integración permanente en una sesión manual de escucha del editor.

Para alojar tu automatización, consulta los servidores Cloud de Hostilimitado. Indica versión de n8n, integraciones, concurrencia y quién administrará actualizaciones y copias; contratar un VPS no implica por sí mismo que la aplicación esté administrada.