Node-RED es una herramienta de flows gratuita y de código abierto que funciona en tu propio hardware o servidor. No hay cuenta ni intermediario: DynamiHost envía el evento scan.created directamente a tu instancia de Node-RED cada vez que se escanea uno de tus códigos dinámicos, y tu flow continúa desde ahí.

Lo que necesitas

  • Un plan de DynamiHost con webhooks: Trial, Pro o Business. Si la página Webhooks de tu panel muestra un mensaje de bloqueo, tu plan aún no incluye webhooks.
  • Una instancia de Node-RED en marcha, accesible en una dirección HTTPS pública. DynamiHost no puede entregar a localhost ni a otras direcciones privadas, y las URL de endpoint en redes privadas se rechazan al guardarlas.

Paso 1: obtén una URL de webhook de Node-RED

  1. En el editor de Node-RED, añade un nodo HTTP In a un flow y ajusta su método a POST.
  2. Dale una ruta reconocible, por ejemplo /dynamihost-scans. La URL del nodo es la dirección de tu instancia más esa ruta.
  3. Añade después un nodo HTTP Response ajustado para devolver el estado 200, y conecta el flow. DynamiHost trata cualquier respuesta 2xx como una entrega correcta, y cualquier otra como un fallo que reintentar.
  4. Haz clic en Deploy. La URL solo está activa una vez desplegado el flow.

Protege la propia instancia (la contraseña del editor de Node-RED y HTTPS) antes de exponerla: cualquiera que encuentre la ruta puede publicar en ella, así que verifica la firma como se describe abajo si el flow hace algo importante.

Paso 2: añade la URL en DynamiHost

  1. Abre Webhooks en el panel y haz clic en Add endpoint.
  2. Pega la URL completa de tu nodo HTTP In y selecciona el evento scan.created.
  3. Guarda y copia el secreto de firma que se muestra una sola vez para el endpoint. Un nodo Function puede verificarlo: la página Integraciones del panel tiene un fragmento de Node listo para esa comprobación, y las cabeceras entrantes van en el mensaje que Node-RED transmite.

Paso 3: prueba la conexión

En la página Webhooks, haz clic en Send test en tu endpoint nuevo. Añade un nodo Debug a tu flow y observa cómo el payload de ejemplo llega a la barra lateral de depuración. Después escanea uno de tus códigos con tu teléfono y observa cómo llega el evento real.

Lo que llega

Cada entrega es el evento scan.created: el id del código, su código corto y su nombre, la hora del escaneo y, cuando se conocen, el país, la ciudad, el dispositivo, el sistema operativo, el navegador y el referente. El formato completo del payload, la verificación de la firma, los reintentos y la regla de desactivación automática están en Webhooks: recibe un aviso en cada escaneo, en este centro de ayuda.

Ideas de automatización

  • Conmuta una luz inteligente, un relé o una pantalla en tu local cuando se escanee un código, mediante MQTT o un nodo de API local.
  • Añade los escaneos a un archivo local o una base de datos para informes sin conexión.
  • Reenvía los escaneos a otro sistema interno no accesible desde internet, con Node-RED como puente.