Pasos para crear un webhook

Crear un webhook

Pulsa + Crear webhook. El asistente tiene tres pasos:

1. Información del webhook

Ponle un nombre y una descripción. Solo sirven para identificarlo.

2. Dispositivos y eventos

•Marca uno o varios dispositivos en el selector (puedes buscar por red o por nombre y elegir varios de una vez).

•Marca los eventos que lo dispararán: Nueva medición, Alertas - Alarmas, Dispositivo desconectado o Batería baja.

3. Configurar la conexión

•URL de destino (el endpoint que recibirá los datos).

•Método de solicitud: POST o PUT.

•Opcionalmente, hasta 5 de cada uno de estos parámetros:
– Encabezados: se envían tal cual en la petición (úsalos para autenticación, por ejemplo Authorization).
– Query parameters: se añaden a la URL de destino.
– Body parameters: se añaden al cuerpo (JSON) junto con los datos del sensor.

Ninguna clave o valor puede quedar vacío: si dejas un parámetro incompleto, el formulario lo marcará y no dejará guardar.

Pulsa Crear webhook. Verás la confirmación y el webhook aparecerá en la lista.

Probar un webhook

Una vez creado, puedes comprobar que funciona sin esperar a que llegue un dato real. En la lista de webhooks, pulsa el botón Probar (icono de envío) de la fila.

Nescloud envía una petición de prueba real a la URL configurada y muestra el resultado:

•El código de estado y el tiempo de respuesta.

•Los encabezados y el cuerpo que se han enviado.

•La respuesta que devuelve tu sistema.

El cuerpo de prueba usa las métricas reales de los sensores del dispositivo, pero con valores de ejemplo. Si el webhook tiene varios dispositivos, se envía una petición por cada tipo de dispositivo, igual que en producción (donde cada dispositivo manda su propio dato, nunca todas las métricas juntas). Los dispositivos con la misma estructura se agrupan y se prueban como máximo 5 estructuras distintas.