Webhooks
Un webhook es una notificación automática enviada desde el servidor de TARGPatrol al suyo cuando ocurre un evento específico en el sistema, como la creación, actualización o finalización de una tarea. Los webhooks son esenciales para agilizar procesos, integrarse con otros sistemas y responder a cambios en tiempo real. Cuando ocurre un evento, por ejemplo un cambio de estado de tarea, TARGPatrol envía una solicitud POST a una URL predefinida. Esta solicitud incluye una carga útil: un objeto JSON con detalles del evento, como ID de tarea, estado y otros datos relevantes.
Cómo configurar webhooks en TARGPatrol
Para crear un webhook:
Inicie sesión en TARGPatrol.
Vaya a la sección "Gestión" -> "Webhooks".
Añada un nuevo webhook:
Haga clic en el botón Añadir webhook.
Introduzca la URL donde deben enviarse las notificaciones. Asegúrese de que su servidor esté preparado para recibir solicitudes POST y procesar datos JSON.
Seleccione los tipos de eventos que activarán el webhook. TARGPatrol admite varios disparadores.
Opcional: añada encabezados de solicitud. Si es necesario, especifique encabezados como Content-Type para personalizar el formato.
Haga clic en "Guardar".
Probar el webhook:
Después de guardar, TARGPatrol permite probar el webhook simulando un evento.
Por ejemplo, si su webhook está configurado para activarse con task.created, recibirá una notificación cuando se cree una nueva tarea.
Ver registros de webhooks en TARGPatrol
Acceda a los registros del webhook:
Abra la sección “Webhooks” en TARGPatrol.
Haga clic en la URL del webhook o en su icono para ver los detalles.
Una ventana mostrará la lista de eventos activados, incluidos su estado, cargas de solicitud y respuestas del servidor.
Revise los errores: si un webhook falla, la solicitud correspondiente se marcará con un icono de error en los registros. TARGPatrol desactivará automáticamente un webhook después de 25 solicitudes fallidas consecutivas.
Consejos para gestionar webhooks
Gestione los errores correctamente: Los webhooks funcionan en tiempo real, pero si su servidor no responde, TARGPatrol reintenta la solicitud automáticamente.
Supervise y analice errores: Problemas recurrentes, como tiempos de espera, pueden indicar problemas de rendimiento del servidor o configuraciones de enrutamiento incorrectas.
Manténgase informado: TARGPatrol envía alertas por correo cuando se crean nuevos webhooks, ocurren errores o un webhook se desactiva automáticamente. Esto le mantiene informado sobre el estado de la integración.
Use HTTPS por seguridad: Los webhooks de TARGPatrol solo admiten URLs HTTPS seguras para proteger los datos.
Configurar webhooks en TARGPatrol le permite automatizar tareas, integrarse con otros sistemas y gestionar datos en tiempo real de forma eficaz. Siga estos consejos para evitar errores comunes y lograr una integración fluida. Use HTTPS por seguridad, supervise errores para resolverlos rápidamente y manténgase informado sobre el estado de sus webhooks con las alertas de TARGPatrol. Con la configuración adecuada, optimizará los flujos de trabajo y aumentará la productividad del equipo.