Webhooks enriquecidos

Los webhooks enriquecidos entregan datos de artículo procesados por IA con resolución de entidades de empresa, análisis de sentimiento y el conjunto completo de opciones de filtrado.

Capacidades clave de los webhooks enriquecidos:

Filtrado completo — filtra por tickers, países, categorías, fuentes, idioma y query
Enriquecimiento por IA — las cargas incluyen puntuaciones de sentimiento, coincidencias de empresa y valores de confianza
Contenido flexible — incluye opcionalmente el texto completo del artículo y las entidades extraídas mediante includeContent / includeEntities
Tipo inmutable — el tipo de entrega (enriched o raw) se establece al crear el webhook y no se puede cambiar después

Modelo de artículo

Los webhooks enriquecidos entregan la carga completa del artículo, incluidos los datos de empresa generados por IA, el análisis de sentimiento y la resolución de entidades.

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
sentiment
Type
string
Description
Sentimiento del artículo generado por IA. Valores posibles: positive | negative | neutral.
Name
confidence
Type
number
Description
Puntuación de confianza para el valor de sentimiento, entre 0 y 1.
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.
Name
companies
Type
Company[]
Description
Array de objetos de empresa coincidentes, resueltos por la coincidencia de entidades por IA. Cada empresa contiene los siguientes campos:
- companyId number — identificador interno de empresa de finlight
- confidence string — puntuación de confianza de la coincidencia de entidad
- name string — nombre completo de la empresa
- ticker string — símbolo de ticker principal. P. ej. AAPL
- exchange string — código de la bolsa. P. ej. XNAS
- country string — país de cotización principal (ISO 3166-1 alpha-2)
- sector string — clasificación de sector. P. ej. Technology
- industry string — clasificación de industria
- isin string — código ISIN principal
- openfigi string — identificador OpenFIGI
- primaryListing object — { ticker, exchangeCode, exchangeCountry }
- isins string[] — todos los ISIN conocidos de la empresa
- otherListings object[] — [{ ticker, exchangeCode, exchangeCountry }]

WEBHOOKTipo de entrega

Al crear un webhook en el panel de finlight, selecciona Enriched como tipo de entrega en el primer paso del asistente de configuración. Es la opción predeterminada. El paso de criterios mostrará todos los parámetros de filtro disponibles.

Los webhooks enriquecidos 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 operadores booleanos y filtrado a nivel de campo. Consulta la guía de Creación de consultas avanzadas.
Name
sources
Type
string[]
Description
Limita la entrega a artículos de fuentes específicas. P. ej. ["www.reuters.com", "www.cnbc.com"].
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
tickers
Type
string[]
Description
Filtra por símbolos de ticker. Solo se entregarán los artículos asociados a estas empresas por la resolución de entidades por IA. P. ej. ["AAPL", "GOOGL", "TSLA"].
Name
countries
Type
string[]
Description
Filtra por códigos de país (ISO 3166-1 alpha-2). Solo se entregarán los artículos asociados a empresas de estos países. P. ej. ["US", "GB", "DE"].
Name
categories
Type
string[]
Description
Filtra por categoría de artículo. Valores posibles: markets | economy | business | politics | geopolitics | regulation | technology | energy | commodities | crypto | health | climate | security.
Name
includeContent
Type
boolean
Description
Incluye el texto completo del cuerpo del artículo en la carga. Requiere un plan con acceso al artículo completo.
Name
includeEntities
Type
boolean
Description
Incluye las entidades extraídas (empresas, personas, ubicaciones) encontradas en el artículo.
Name
excludeEmptyContent
Type
boolean
Description
Entrega solo los artículos que tengan un resumen no vacío. Útil para filtrar artículos de baja calidad.
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",
  "sentiment": "positive",
  "confidence": 0.95,
  "images": [
    "https://www.example.com/image1.jpg",
    "https://www.example.com/image2.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets", "health"],
  "companies": [
    {
      "companyId": 41494,
      "confidence": "0.9335401058197021",
      "country": "US",
      "exchange": "XNAS",
      "industry": "Biotechnology: Pharmaceutical Preparations",
      "name": "Summit Therapeutics Inc. Common Stock",
      "sector": "Health Care",
      "ticker": "SMMT",
      "isin": "US86627T1088",
      "openfigi": "BBG01PH11VP5",
      "primaryListing": {
        "ticker": "SMMT",
        "exchangeCode": "XNAS",
        "exchangeCountry": "US"
      },
      "isins": ["US86627T1088", "US86627T2088"],
      "otherListings": [
        {
          "ticker": "SMMT.L",
          "exchangeCode": "XLON",
          "exchangeCountry": "GB"
        }
      ]
    }
  ]
}

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",
  "sentiment": "positive",
  "confidence": 0.95,
  "images": [
    "https://www.example.com/image1.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"],
  "companies": []
}

EXAMPLESFiltros combinados

Ejemplos de filtrado

Los webhooks enriquecidos admiten combinar todos los parámetros de filtro. Aquí tienes patrones comunes:

Feed de investigación de empresas:

tickers: ["AAPL", "GOOGL"]
sources: ["www.reuters.com", "www.bloomberg.com"]
includeEntities: true

Noticias de mercado de última hora:

query: "earnings OR revenue OR guidance"
categories: ["markets", "economy"]
language: "en"

Enfoque regional por sector:

countries: ["US", "CA"]
query: "tech OR technology OR semiconductor"
tickers: ["NVDA", "TSMC", "AMD"]

Noticias financieras europeas:

countries: ["GB", "DE", "FR"]
sources: ["www.reuters.com", "www.ft.com"]
language: "en"

La sintaxis de consulta admite operadores booleanos, frases entre comillas y exclusión:

"Apple earnings"                           simple phrase
(Apple OR iPhone) AND (earnings OR revenue)  boolean groups
Tesla NOT recall                           exclusion

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 enriquecidos

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

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

Para detalles completos sobre las opciones de filtrado de webhooks sin procesar, consulta la guía de Webhooks sin procesar.