Los webhooks permiten que Digital Permit Book avise a sus otros sistemas, como un TMS, nómina o una herramienta de automatización, en cuanto algo cambia. Por ejemplo, cuando se agrega un conductor, se actualiza un documento o se envía un DVIR.
Plan: Los webhooks suelen formar parte del plan Enterprise, por lo que es posible que no vea Webhooks en Configuración. Contacte a soporte para activarlos en su empresa.
Agregar un webhook
- Vaya a Configuración > Webhooks.
- Haga clic en + Agregar Webhook.
- Ingrese un Nombre para reconocerlo después, por ejemplo Sincronización TMS.
- Elija el Tipo e indique a dónde enviar los eventos:
- URL: ingrese la dirección web del sistema que recibe los eventos.
- Correo electrónico: ingrese una dirección de correo. Los mismos eventos se envían ahí como correos, útil para una persona o un buzón compartido.
- En Eventos, elija uno o más eventos para enviar (vea la lista abajo). Si elige un evento de documento, aparece el campo Tipo de Documento. Elija los tipos de documento a enviar, por ejemplo solo Tarjeta Médica y Registro del Vehículo. Escriba para buscar en la lista.
- Opcional: haga clic en + Agregar Encabezado Personalizado para enviar encabezados adicionales con cada evento, como una clave de API o un token que su sistema espera.
- Haga clic en Guardar.
El webhook aparece en la lista con su nombre, URL o correo, eventos y tipos de documento. Use la columna Acción para editarlo o eliminarlo.
Eventos que puede enviar
| Área | Eventos |
|---|---|
| Conductores | Driver Created, Driver Updated, Driver Deleted |
| Vehículos | Vehicle Created, Vehicle Updated, Vehicle Deleted |
| Remolques | Trailer Created, Trailer Updated, Trailer Deleted |
| Documentos | Document Created, Document Updated, Document Deleted |
| DVIR | DVIR Submitted |
| Formularios | Form Submitted |
Consejos
- Use Encabezados Personalizados para proteger su URL: agregue un encabezado secreto y haga que su sistema rechace las solicitudes que no lo traigan.
- Cree webhooks separados si distintos sistemas o personas necesitan eventos distintos.
- Use webhooks de Correo electrónico para avisar a alguien sin ninguna configuración de su lado, por ejemplo al gerente de seguridad cuando se envía un DVIR.
- ¿Quiere leer o cambiar datos en lugar de recibir eventos? Use la API. Para conectar un asistente de IA, consulte MCP.