Inicio rápido
Recibe notificaciones instantáneas cuando se produzcan noticias de última hora. Los webhooks entregan actualizaciones de artículos en tiempo real directamente a tu aplicación, eliminando la necesidad de sondear constantemente la API.
¿Qué son los webhooks?
Piensa en los webhooks como notificaciones instantáneas para tu aplicación. Cuando surge una noticia que coincide con tus criterios, finlight envía de inmediato los datos del artículo al endpoint que hayas indicado.
Cómo funcionan los webhooks
Aquí tienes el flujo completo en términos simples:
- Configurar - Define tu webhook con criterios de noticias específicos
- Monitorear - Nuestro sistema vigila los nuevos artículos 24/7
- Coincidir - Cuando un artículo cumple tus criterios, lo detectamos al instante
- Entregar - Enviamos los datos del artículo directamente a tu endpoint
Este enfoque de "API inversa" significa que tu aplicación recibe las actualizaciones en el momento en que ocurren, en lugar de solicitarlas repetidamente.
Primeros pasos
Lo que necesitarás
Antes de crear tu primer webhook, asegúrate de tener:
- Suscripción activa de finlight con acceso a webhooks
- Endpoint HTTPS público listo para recibir las llamadas del webhook
- Acceso al panel en app.finlight.me
Acceso rápido
Ve directo a la creación de webhooks visitando app.finlight.me/news-webhooks e iniciando sesión en tu cuenta de finlight.
Crear tu primer webhook
Sigue este sencillo proceso de 4 pasos para configurar tu webhook y empezar a recibir actualizaciones de noticias en tiempo real.
Paso 1: Accede al creador de webhooks
- Inicia sesión en tu panel de finlight en app.finlight.me
- Navega a "Webhooks" en el menú principal
- Haz clic en "New Webhook" para abrir el asistente de configuración
Paso 2: Detalles básicos
Dale a tu webhook una identidad clara y elige un tipo de entrega:
- Nombre - Elige algo descriptivo como "Noticias tecnológicas de última hora" o "Actualizaciones del mercado"
- Descripción - Explicación breve y opcional del propósito del webhook
- Tipo de entrega - Selecciona cómo se deben entregar los artículos:
- Enriquecido (predeterminado) — Carga procesada por IA con datos de empresa, sentimiento y opciones de filtrado completas. Consulta la guía de Webhooks enriquecidos.
- Sin procesar — Entrega más rápida, carga simplificada, filtros limitados. Consulta la guía de Webhooks sin procesar.
Paso 3: Define tus criterios de noticias
Configura el filtrado para recibir solo artículos relevantes. Las opciones disponibles dependen del tipo de entrega que elijas.
Consulta Webhooks enriquecidos o Webhooks sin procesar para la referencia completa de filtros de tu tipo.
Paso 4: Configura el destino y la seguridad
Destino del webhook
Proporciona la URL de tu endpoint donde enviaremos las noticias:
- Debe ser una URL HTTPS pública
- Debe responder rápidamente (menos de 5 segundos)
Configuración de seguridad
Elige cómo proteger el endpoint de tu webhook:
- Ninguna - Sin autenticación adicional (no recomendado para producción)
- Autenticación básica - Protección con usuario/contraseña mediante HTTP Basic Auth
- Encabezado personalizado - Envía tu clave de API en el encabezado
X-Finlight-Key - Validación de firma - Siempre incluida para la verificación de la carga mediante el encabezado
X-Webhook-Signature
Nota: La validación de firma se habilita automáticamente en todos los webhooks para verificar la integridad de la carga, independientemente del método de autenticación que elijas.
Aprende más sobre cómo implementar estas opciones de seguridad en nuestra guía de autenticación.
Prueba tu integración
Herramientas de prueba integradas
Antes de salir a producción, valida la configuración de tu webhook:
- Función de prueba del panel - Envía cargas de muestra a tu endpoint
- Monitoreo de entregas - Rastrea las tasas de éxito y los tiempos de respuesta
- Diagnóstico de errores - Depura las entregas fallidas
Para obtener instrucciones de prueba completas, ejemplos de carga y consejos de solución de problemas, visita nuestra guía de pruebas de webhooks.
¿Necesitas ayuda?
Opciones rápidas de soporte
Carga y filtrado
Consulta Webhooks enriquecidos o Webhooks sin procesar para el modelo de artículo y la referencia de filtros de tu tipo.
Configuración técnica
Visita nuestra guía de autenticación y la guía de pruebas para obtener ayuda detallada con la implementación.
Soporte general
Consulta nuestra página de soporte para obtener recursos adicionales e información de contacto.
Problemas del panel
Accede a la gestión de tus webhooks en app.finlight.me o contacta con soporte a través de la plataforma.
¿Listo para empezar?
Los webhooks transforman la manera en que recibes actualizaciones de noticias: de sondear cada pocos minutos a la entrega instantánea en el momento en que surge la noticia.
Empieza de forma sencilla con criterios de filtrado básicos y luego amplía gradualmente a medida que descubras qué funciona mejor para tu aplicación. El panel de finlight facilita modificar y optimizar tus webhooks en cualquier momento.