Esta página fue traducida automáticamente. La versión en inglés es la fuente y puede ser más precisa o estar más actualizada. Ver en inglés

Webhooks sin procesar

Los webhooks sin procesar son una alternativa ligera y de entrega rápida a los webhooks estándar (enriquecidos). Entregan los datos básicos del artículo en el momento en que se publica, omitiendo por completo el pipeline de enriquecimiento por IA.

Diferencias clave con los webhooks enriquecidos:

  • Entrega más rápida — los artículos se envían en cuanto se ingieren, sin esperar al análisis de sentimiento, la resolución de entidades o la coincidencia de empresas.
  • Filtros simplificados — solo se admiten query, sources, excludeSources, language e includeUpdates. tickers, countries, categories, includeContent, includeEntities y excludeEmptyContent no están disponibles.
  • Sin enriquecimiento por IA — las cargas no contienen datos de sentiment, confidence ni companies.
  • Filtrado a nivel de campo en query — el parámetro query admite la sintaxis de nivel de campo solo para source, title y summary.
  • Tipo inmutable — el tipo de entrega (raw o enriched) se establece al crear el webhook y no se puede cambiar después.

Modelo de artículo

Los webhooks sin procesar entregan una carga de artículo simplificada. No se incluyen entidades de empresa, puntuaciones de sentimiento ni enriquecimientos generados por IA.

  • Name
    link
    Type
    string
    Description

    URL del artículo completo.

  • Name
    source
    Type
    string
    Description

    Sitio web de origen. P. ej. www.reuters.com

  • Name
    title
    Type
    string
    Description

    Título del artículo.

  • Name
    summary
    Type
    string
    Description

    Resumen del artículo si está disponible. Puede ser nulo.

  • Name
    publishDate
    Type
    Date
    Description

    Fecha de publicación como cadena de fecha ISO 8601.

  • Name
    createdAt
    Type
    Date
    Description

    Fecha de creación interna del artículo en el sistema de finlight, como cadena de fecha ISO 8601.

  • Name
    revisedDate
    Type
    Date | null
    Description

    Fecha de la última revisión del artículo tras la publicación inicial. null cuando el artículo nunca se ha revisado. Presente cuando includeUpdates está habilitado y el artículo ha sido revisado.

  • Name
    isUpdate
    Type
    boolean
    Description

    true cuando esta entrega se desencadena por una actualización posterior a la publicación. Solo presente cuando includeUpdates está habilitado.

  • Name
    language
    Type
    string
    Description

    Código de idioma en ISO 639-1. P. ej. en | de | fr

  • Name
    images
    Type
    string[]
    Description

    Array de URLs de imágenes del artículo.

  • Name
    countries
    Type
    string[]
    Description

    Array de códigos de país en formato ISO 3166-1 alpha-2. P. ej. ["US", "GB"]. Puede estar vacío.

  • Name
    categories
    Type
    string[]
    Description

    Array de categorías del artículo. Valores posibles: markets | economy | business | politics | geopolitics | regulation | technology | energy | commodities | crypto | health | climate | security. Puede estar vacío.

WEBHOOKTipo de entrega

Crear un webhook sin procesar

Al crear un webhook en el panel de finlight, selecciona Raw como tipo de entrega en el primer paso del asistente de configuración. El paso de criterios mostrará entonces solo los cuatro parámetros de filtro admitidos.

Los webhooks sin procesar entregan únicamente artículos recién publicados que coincidan con tus criterios. Cada entrega es una única carga de artículo enviada como solicitud HTTP POST a tu endpoint.

  • Name
    query
    Type
    string
    Description

    Consulta de búsqueda para encontrar artículos relevantes. Admite filtrado a nivel de campo para source, title y summary. Consulta filtrado a nivel de campo en query más abajo.

  • Name
    sources
    Type
    string[]
    Description

    Limita la entrega a artículos de fuentes específicas. P. ej. ["www.reuters.com", "www.cnbc.com"]. Consulta el endpoint de fuentes para los valores válidos.

  • Name
    excludeSources
    Type
    string[]
    Description

    Excluye artículos de fuentes específicas. P. ej. ["www.example.com"].

  • Name
    language
    Type
    string
    Description

    Filtra por idioma del artículo (ISO 639-1). Por defecto es en, que devuelve solo inglés y excluye otros idiomas — consulta Idioma y cobertura.

  • Name
    includeUpdates
    Type
    boolean
    Description

    Reentrega los artículos cuando se actualizan tras la publicación inicial. Las cargas actualizadas incluyen isUpdate=true y una marca de tiempo revisedDate.

Response

{
  "link": "https://www.example.com/article1",
  "source": "www.example.com",
  "title": "Stock Market Hits New Highs",
  "summary": "A brief summary of the article...",
  "publishDate": "2023-10-01T12:34:56Z",
  "createdAt": "2023-10-01T12:35:10Z",
  "language": "en",
  "images": [
    "https://www.example.com/image1.jpg",
    "https://www.example.com/image2.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"]
}

Response (includeUpdates: true)

{
  "link": "https://www.example.com/article1",
  "source": "www.example.com",
  "title": "Stock Market Hits New Highs — Updated",
  "summary": "An updated summary of the article...",
  "publishDate": "2023-10-01T12:34:56Z",
  "createdAt": "2023-10-01T12:35:10Z",
  "revisedDate": "2023-10-02T08:00:00Z",
  "isUpdate": true,
  "language": "en",
  "images": [
    "https://www.example.com/image1.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"]
}

Filtrado a nivel de campo en query

El parámetro query de los webhooks sin procesar admite filtrado a nivel de campo limitado únicamente a estos campos:

  • source — filtra por el dominio de origen del artículo
  • title — filtra por contenido del título del artículo
  • summary — filtra por contenido del resumen del artículo

Ejemplos:

query=title:Nvidia

Entrega artículos cuyo título contiene "Nvidia".

query=summary:earnings +title:Tesla

Entrega artículos cuyo resumen menciona "earnings" y cuyo título contiene "Tesla".

query=source:www.reuters.com -crypto

Entrega artículos de Reuters, excluyendo los que mencionan "crypto".

Consulta la guía de Creación de consultas avanzadas para la referencia completa de la sintaxis de consulta.

GUIDEAyuda para decidir

Cuándo usar webhooks sin procesar

Elige Raw cuando:

  • Necesitas la menor latencia de entrega posible
  • Estás construyendo un pipeline de alto rendimiento donde no se requieren datos de enriquecimiento
  • Solo necesitas filtrar por palabras clave, fuentes o idioma
  • Quieres una carga más ligera para reducir la sobrecarga de procesamiento en tu lado

Elige Enriched cuando:

  • Necesitas filtrado a nivel de empresa/ticker (tickers, countries, categories)
  • Quieres puntuaciones de sentimiento, valores de confianza o resolución de entidades en la carga
  • Necesitas incluir el contenido completo del artículo o entidades extraídas mediante includeContent / includeEntities
  • Estás construyendo monitoreo de acciones, seguimiento de resultados o feeds de noticias específicos de sector

Para detalles completos sobre las opciones de filtrado de webhooks enriquecidos, consulta la guía de Criterios de filtrado.