¿Cómo configuro los webhooks y sus eventos?

Un webhook es una forma en que Urbantz proporciona información a las aplicaciones de nuestros clientes. Los webhooks se activan mediante eventos específicos.

Resumen

1. Configuración y ajustes
2. Resolución de problemas
3. Configuración y ajustes

Cada vez que ocurren eventos desencadenantes en la plataforma, el webhook se envía al endpoint HTTPS o SFTP que has proporcionado.

Si tu endpoint HTTPS requiere autenticación, es posible configurar encabezados.

Los detalles de los payloads se pueden encontrar aquí.

Los webhooks se pueden configurar a nivel de plataforma:

o a nivel de flujo:

• Los webhooks asociados con rutas, tickets y algunos eventos de tareas se configuran a nivel de plataforma

Administración > Plataforma > General > Integraciones

• round.created
• round.validated
• round.published
• round.in_preparation
• round.ongoing
• round.completed
• round.analytics
• ticketCreated
• ticketUpdated
• ticketClosed
• taskStatusChanged
• taskChanged

• taskRejected

  Es necesario seleccionar la URL, el protocolo y los eventos suscritos (1. Rutas, 2. tickets, y 3. tareas)

  Los webhooks asociados con tareas, optimizaciones y anuncios se configuran a nivel de flujo

Administración > Flujos > Modo avanzado > Webhooks

• taskStatusChanged
• taskChanged
• optimisationComplete
• announcementComplete
• announcementCancelled

• tasksAnnounced

  También puedes seleccionar un encabezado y una descripción, así como activar la notificación por no entrega en esta sección. Estas notificaciones por email pueden minimizar los problemas asociados con errores en los webhooks. Puedes encontrar más información sobre esto aquí.

  Resolución de problemas Para determinar por qué o dónde falla un webhook específico, puedes seguir los pasos a continuación:

   

  • Verificar si se cumplió el desencadenante
  • Verificar si el webhook se configuró correctamente (endpoint URL)
  • Verificar si hay un filtro en el webhook (Expedidor, Optimización)
  • Revisar el monitor del sistema (ver artículo para más detalles):
    • Si no se encuentra nada, por favor contacta a nuestro equipo de soporte y proporciona los resultados de la resolución de problemas inicial.