El uso de webhooks le permite recibir notificaciones en tiempo real en sus aplicaciones cada vez que se realiza un cambio en una intervención de su cuenta de AntsRoute.
En concreto, un webhook permite enviar automáticamente datos a una URL específica cuando se produce un evento en AntsRoute.
El envío automatizado de estos datos puede desencadenar acciones en la aplicación receptora. Por ejemplo, puede crear automáticamente una factura en QuickBooks en cuanto se complete una entrega con AntsRoute.
💡 Solo los usuarios con el rol «Administrador» pueden acceder a la configuración de los webhooks.
Ejemplo de solicitud HTTP:
Eventos que se pueden enviar:
- Cambio de estado: Entrega cancelada, Entrega confirmada, Entrega creada, Entrega pendiente, Entrega eliminada, Entrega realizada, Estado confirmado eliminado, Estado pendiente eliminado.
- Planificación: Entrega puesta en estado no asignada, Entrega adelantada o retrasada o asignada a otra ruta, Entrega asignada a una ruta, Entrega asignada a una ruta en curso, Entrega planificada desde la cesta, Entrega trasladada a la cesta, Fecha de planificación cambiada.
- Pruebas de entrega: Foto de prueba añadida, Firma del cliente añadida.
- Otros: Entrega bloqueada, Entrega actualizada.
- Ruta: Ruta en proceso, Ruta finalizada.
- Notificación: Notificación enviada.
- Pick-up & Delivery: Carga realizada, Descarga realizada, Carga cancelada, Descarga cancelada.
Añadir un webhook
Primero necesitas obtener la URL del webhook de la aplicación a la que quiere enviar datos.
- Pincha en el círculo azul de la parte superior derecha.
- Pincha en “Integraciones”.
- Pincha en la pestaña “Webhooks”.
- Pincha en el botón “+”.
- Complete la información solicitada: nombre, dirección URL, modo de autenticación, etc.
- Elija los eventos que desea enviar.
- Elija si desea incluir o no toda la información de las intervenciones (ID, estado, etc.).
- Si tiene varios sitios, seleccione los sitios correspondientes.
- Pincha en el botón “Guardar”.
¿Cómo consultar los registros de un webhook?
La pestaña «Registros» le permite consultar el historial de los datos enviados a sus aplicaciones de terceros. En particular, le permite comprobar si la información se ha transmitido correctamente e identificar posibles errores.
Para acceder a los registros:
- En la lista de webhooks, localice el webhook que desea consultar.
- Haga clic en «…».
- Haga clic en «Registros».
Para cada envío, puede consultar su estado, el evento correspondiente, la fecha de envío y los datos enviados.
💡 El estado «Éxito» indica que la información se ha transmitido correctamente. El estado «Fallo» indica que el envío no se ha realizado correctamente.
Si se produce un error, haga clic en la línea correspondiente para consultar los detalles del envío y la respuesta devuelta por la aplicación de terceros. Esta información puede ayudarle a identificar el origen del problema.
¿Cómo filtrar los registros?
Para encontrar más fácilmente un envío en el historial, haga clic en el botón «Filtrar».
Puede filtrar los registros según cuatro criterios:
- Estado: muestre únicamente los envíos con error o realizados correctamente.
- Evento: encuentre los envíos asociados a un evento específico, por ejemplo, una entrega bloqueada.
- Fecha de envío: busque los datos enviados en una fecha determinada.
- ID de entrega: encuentre los envíos asociados a una entrega específica utilizando su identificador.
Estos filtros le permiten encontrar rápidamente la información que busca, especialmente cuando su webhook contiene un gran número de registros.
💡 Si tiene algún problema con una entrega específica, utilice el filtro «ID de entrega» para encontrar rápidamente los diferentes eventos enviados para esa entrega.
¿Qué hacer si un envío falla?
Si un registro muestra el estado «Fallo», ábralo para consultar los detalles de la respuesta devuelta por la aplicación receptora.
En particular, puede consultar el código de respuesta HTTP y el mensaje de error. Esta información le ayudará a determinar por qué la aplicación no ha aceptado los datos enviados.
Después de solucionar el problema que ha provocado el error, puede hacer clic en «Reenviar» para realizar un nuevo intento de envío.
💡 Si es necesario, también puede utilizar el botón «Copiar» para copiar la información del registro y compartirla con su equipo técnico o con el servicio de soporte de la aplicación correspondiente.
Puntos clave
Los webhooks permiten automatizar el intercambio de información entre AntsRoute y sus otras aplicaciones. Gracias a los registros y a los filtros Estado, Evento, Fecha de envío e ID de entrega, puede realizar un seguimiento más sencillo de los datos enviados e identificar rápidamente posibles errores.
¿Necesita ayuda?
Si tiene dificultades para utilizar esta función o tiene alguna pregunta, nuestro equipo de soporte está a su disposición.
Puede ponerse en contacto con AntsRoute a través del chat disponible directamente en el software o por correo electrónico:
📧 contact@antsroute.com