Webhooks Salientes
Los webhooks salientes permiten que Dinaup envie notificaciones HTTP automaticas a tus sistemas cuando se producen eventos en tus datos. Esto elimina la necesidad de consultar periodicamente la API (polling) y te permite reaccionar en tiempo real.
Como funcionan
[Dinaup] -> evento detectado -> validacion de condiciones -> HTTP POST -> [Tu servidor]
- Un usuario o un proceso crea o modifica un registro en Dinaup
- El sistema comprueba si hay webhooks configurados para esa seccion
- Si se cumplen las condiciones definidas, Dinaup envia una peticion HTTP POST a la URL configurada
- Tu servidor recibe los datos y ejecuta la logica que necesites
Configuracion
Los webhooks se configuran desde Dinaup Flex o desde el modulo de Desarrollo en Play Dinaup.
1. Seleccionar la seccion
Elige la seccion (tabla de datos) que quieres monitorizar. Por ejemplo: Ventas/Ingresos, Entidades (clientes), Productos, etc.
2. Definir disparadores
| Opcion | Descripcion |
|---|---|
| Disparar en modificaciones | Se activa cuando se actualiza un registro existente |
| Disparar en nuevos | Se activa cuando se crea un nuevo registro |
| Campos disparadores | Solo se activa si cambian estos campos especificos |
3. Requisitos de datos
Para aumentar la precision, puedes definir campos obligatorios que deben estar completados antes de enviar la notificacion:
| Modo | Descripcion |
|---|---|
| Todos los campos | La notificacion solo se envia si todos los campos obligatorios estan rellenos |
| Al menos uno | Basta con que uno de los campos obligatorios tenga valor |
Esto evita que se envien notificaciones con datos incompletos (por ejemplo, un borrador de factura sin cliente asignado).
4. Configurar la URL de destino
Introduce la URL de tu servidor que recibira las notificaciones.
5. Seguridad
Configura un Bearer Token que Dinaup incluira en la cabecera Authorization de cada peticion:
Authorization: Bearer <tu-token-de-seguridad>
Tu servidor debe verificar este token para confirmar que la notificacion proviene de Dinaup.
Payload de la notificacion
Dinaup envia una peticion HTTP POST con los datos del registro en formato JSON:
- ID del registro afectado
- ID de la seccion
- Valores de los campos del registro
- Tipo de evento (creacion o modificacion)
Buenas practicas
| Practica | Motivo |
|---|---|
Responde con 2xx en menos de 10 segundos | Dinaup espera confirmacion; tiempos largos causan reintentos |
| Verifica el Bearer Token | Asegurate de que la peticion proviene de Dinaup |
| Procesa de forma asincrona | Si necesitas operaciones largas, encola y responde rapido |
| Registra las notificaciones | Facilita la depuracion |
| Usa campos disparadores especificos | Evita notificaciones por cambios irrelevantes |
Casos de uso
| Caso de uso | Configuracion |
|---|---|
| Notificar a Slack al crear una venta | Seccion: Ventas/Ingresos, Disparar: Nuevos, URL: n8n/Make > Slack |
| Sincronizar clientes con CRM externo | Seccion: Entidades, Disparar: Nuevos + Modificaciones |
| Actualizar stock en tienda online | Seccion: Productos, Disparar: Modificaciones, Campo: Stock |
| Email de bienvenida a nuevos clientes | Seccion: Entidades, Disparar: Nuevos, Requisito: Email relleno |
| Generar albaran automatico | Seccion: Ventas/Ingresos, Campo: Estado = "Confirmada" |