Dinaup DocsWebhooks Salientes
Crear, editar y acotar los webhooks salientes de la empresa y probar su entrega con el simulador de la pantalla.
Desarrollo → Conectar → Webhooks Salientes configura los avisos que Dinaup envía a tu servidor. Cuando se crea o se modifica un registro de la sección que vigilas, Dinaup hace un POST a la URL que le das con los datos del registro. La pantalla lista los webhooks, abre el editor de cada uno y trae un simulador para probar la entrega.
El formato del aviso, las condiciones de disparo y lo que espera Dinaup de tu servidor están en Webhooks salientes.
Antes de empezar
- La aplicación Desarrollo en la licencia y el interruptor Desarrollador en tu usuario. Ver Desarrollo.
- Una URL de tu servidor que acepte un POST con JSON.
Cómo se organiza la pantalla
Tres pasos en la cabecera: 1. Crea un webhook, 2. Configura tu URL destino, 3. Prueba con el simulador. Debajo, el simulador Probar webhooks salientes y la lista Webhooks configurados, los dos con la etiqueta Beta.
Crear o editar un webhook
Abre el editor
En Webhooks configurados, pulsa Nuevo. Para editar uno que ya existe, pulsa su fila: se abre el mismo editor, Webhook Saliente, con sus datos.
Rellena General
- Título: el nombre con el que identificas el webhook. Obligatorio.
- Sección: pulsa la caja y elige la tabla en la ventana Elegir la tabla que vigila el webhook. Aquí salen también las plantillas base y las tablas de líneas, con su etiqueta, porque se vigila una tabla y no una ficha: una tabla de líneas cambia igual que su cabecera. Obligatoria.
- Disparar modificaciones: avisa cuando se actualiza un registro que ya existía.
- Disparar nuevos: avisa cuando se crea un registro.
- URL: la dirección a la que llega el POST.
- Bearer Token: opcional. Si lo rellenas, Dinaup lo manda en la cabecera
Authorizationde cada aviso y tu servidor puede comprobarlo.
Acota el disparo
- Campos disparadores: los campos cuyo cambio activa el webhook. Sin ninguno, cualquier cambio dispara.
- Campos obligatorios: los campos que tienen que estar rellenos para que el aviso salga. Si eliges alguno, elige también el modo en el desplegable: Todos los campos seleccionados. o Al menos un campo.
Los dos selectores muestran cada campo con su etiqueta, su nombre interno y el icono de su formato. Si cambias la sección, las dos listas se vacían: eran campos de la tabla anterior.
Guarda
Pulsa Guardar. El webhook queda activo desde ese momento. Cerrar descarta los cambios.
| Aviso al guardar | Qué hacer |
|---|---|
| Falta la sección | Elige la tabla en Sección. |
| Falta el título | Rellena Título. |
| Falta el modo de campos | Has elegido campos obligatorios sin decir si valen todos o al menos uno. Elige el modo en el desplegable de Campos obligatorios. |
| Esa sección no está en el esquema | El esquema se guarda 24 horas: una tabla recién creada todavía no aparece. |
Probar con el simulador
Probar webhooks salientes envía un aviso real con los datos de un registro:
- En Webhook, elige uno de los configurados.
- En Registro, elige un registro de la sección que vigila ese webhook. La tarjeta muestra el cuerpo JSON que va a salir:
previousDataynewData, los dos con los campos del registro. En la prueba son iguales. - En Pruébalo, escribe la URL de destino y pulsa Enviar. El POST sale con el cuerpo de la vista previa y, si el webhook tiene token, con la cabecera
Authorization: Bearer <token>.
La prueba sale por la pasarela gw.dinaup.com. La pantalla no muestra la respuesta de tu servidor: comprueba en tu lado que el aviso llegó. Si la petición no llega a salir, aparece una notificación con el error.
Webhooks configurados
La lista de la sección Webhook Salientes, con su buscador. Pulsa una fila para abrir el editor. Sobre la lista, un aviso fijo: los webhooks son gratuitos en la fase beta y en el futuro pueden aplicarse cuotas por uso.
El aviso que recibe tu servidor
Un POST con JSON: previousData (el registro antes del cambio) y newData (después). Los valores viajan como texto con los formatos de Dinaup: fechas ISO en UTC, decimales con punto, booleanos 1 y 0. El detalle y los ejemplos están en Webhooks salientes.