Pruebas de webhooks - Herramientas del panel y monitoreo
El panel de finlight ofrece herramientas completas de prueba y monitoreo para garantizar que tu integración de webhooks funcione de forma fiable. Usa estas funciones integradas para validar, probar y depurar tus endpoints de webhook.
Resumen de funciones del panel
Herramientas clave del panel
Lista de webhooks:
- Ver todos tus webhooks configurados
- Ver el estado (habilitado/deshabilitado) de un vistazo
- Acceso rápido a los detalles del webhook
Página de detalles del webhook:
- Pestaña de configuración - Ver/editar los ajustes del webhook
- Pestaña de historial de llamadas - Ver todos los intentos de entrega
- Botón de prueba - Funcionalidad de prueba manual
Funciones del historial de llamadas:
- Filtrado por estado - Mostrar solo éxitos o fallos
- Registros detallados - Haz clic en las entradas para ver los datos completos de solicitud/respuesta
Panel de detalles del webhook
Accede a tu interfaz de gestión de webhooks en app.finlight.me/news-webhooks para ver y gestionar todos tus webhooks.
Acceder a los detalles del webhook
- Navega a tu lista de webhooks en el panel
- Haz clic en el botón "Show" del webhook para ver su página de detalles
- Consulta información completa sobre la configuración y el rendimiento de tu webhook
La página de detalles del webhook ofrece:
- Resumen de configuración - Ajustes actuales y criterios de filtrado
- Historial de llamadas - Registro completo de todos los intentos de webhook
- Controles de prueba - Funcionalidad de prueba manual
- Controles de edición - Edición manual después de la creación
Pruebas manuales
Función de prueba de webhook
El panel incluye un botón "Test" que envía una carga de muestra a tu endpoint:
Cómo usarlo:
- Abre la página de detalles de tu webhook
- Haz clic en el botón "Test" del panel superior
- Espera unos segundos a que se complete la solicitud de prueba
- Revisa los resultados de la prueba en el historial de llamadas (quizá tengas que actualizar la página)
Qué ocurre:
- Envía una carga de muestra realista a tu endpoint configurado
- Usa tus ajustes de autenticación reales
- Incluye los encabezados de validación de firma adecuados
- Registra el intento de prueba en tu historial de llamadas
Carga de prueba: La prueba envía un evento de artículo simulado que sigue la misma estructura que las entregas reales de webhook, lo que te permite validar:
- La accesibilidad y la respuesta del endpoint
- La configuración de autenticación
- La lógica de procesamiento de la carga
- Las capacidades de manejo de errores
Historial de llamadas y monitoreo
Ver el historial de llamadas
La página de detalles del webhook muestra un historial de llamadas completo con todos los intentos de entrega:
Información mostrada:
- Marca de tiempo - Cuándo se envió el webhook
- Estado - Éxito (2xx) o fallo (4xx/5xx)
- Código de respuesta - Código de estado HTTP devuelto por tu endpoint
- Tiempo de respuesta - Cuánto tardó tu endpoint en responder
- Respuesta - La respuesta completa (encabezado y cuerpo) dentro del contenido desplegable al hacer clic en "Show"
Solicitudes exitosas vs. fallidas
Solicitudes exitosas (✅):
- Códigos de estado HTTP 200-299
- Respuesta recibida dentro del tiempo límite
- Confirmación adecuada de tu endpoint
Solicitudes fallidas (❌):
- Códigos de estado HTTP 400-599
- Tiempos de espera de red o errores de conexión
- Fallos de autenticación
- URLs de endpoint inválidas
Depuración con el panel
Usar el historial de llamadas para depurar
El historial de llamadas es tu herramienta principal para diagnosticar problemas de webhook:
Identificar patrones:
- Filtrar por estado - Ver solo las solicitudes fallidas para identificar problemas
- Revisar marcas de tiempo - Buscar patrones temporales en los fallos
- Examinar los códigos de respuesta - Entender qué devuelve tu endpoint
- Examinar los reintentos - Ver cuántas veces se intentó la entrega
Indicadores comunes de fallo:
- HTTP 401/403 - Problemas de autenticación o autorización
- HTTP 404 - URL de endpoint incorrecta
- HTTP 500 - Errores internos del servidor en tu aplicación
- Tiempos de espera - Tu endpoint tarda demasiado en responder
- Errores de conexión - Problemas de conectividad de red
Información detallada del error
Haz clic en cualquier entrada del historial de llamadas para ver:
- Los encabezados de solicitud completos enviados a tu endpoint
- Los encabezados de respuesta recibidos de tu endpoint
- El contenido del cuerpo de la respuesta (si lo hay)
- La información de tiempo exacto
- El historial de reintentos de los intentos fallidos
Requisitos del endpoint
Requisitos de respuesta
Tu endpoint de webhook debe:
Respuesta HTTP:
- Devolver códigos de estado 200-299 para un procesamiento exitoso
- Responder en menos de 30 segundos para evitar tiempos de espera
- Aceptar solicitudes POST con cargas JSON
Encabezados:
- Procesar
X-Webhook-Signaturepara la validación de firma - Manejar
X-Webhook-Timestamppara la prevención de ataques de repetición - Admitir los encabezados de tu método de autenticación elegido
Para orientación sobre la configuración de webhooks, consulta la documentación principal de webhooks. Para detalles de autenticación, consulta la guía de autenticación.