Esta página foi traduzida automaticamente. A versão em inglês é a fonte e pode ser mais precisa ou estar mais atualizada. Ver em inglês

Webhooks brutos

Os webhooks brutos são uma alternativa leve e de entrega rápida aos webhooks padrão (enriquecidos). Eles entregam os dados básicos do artigo no momento em que é publicado, ignorando completamente o pipeline de enriquecimento por IA.

Diferenças principais em relação aos webhooks enriquecidos:

  • Entrega mais rápida — os artigos são enviados assim que são ingeridos, sem esperar pela análise de sentimento, resolução de entidades ou correspondência de empresas.
  • Filtros simplificados — apenas query, sources, excludeSources, language e includeUpdates são suportados. tickers, countries, categories, includeContent, includeEntities e excludeEmptyContent não estão disponíveis.
  • Sem enriquecimento por IA — as cargas não contêm dados de sentiment, confidence ou companies.
  • Filtragem em nível de campo na query — o parâmetro query suporta a sintaxe de nível de campo apenas para source, title e summary.
  • Tipo imutável — o tipo de entrega (raw ou enriched) é definido na criação e não pode ser alterado depois.

Modelo de artigo

Os webhooks brutos entregam uma carga de artigo simplificada. Não são incluídas entidades de empresa, pontuações de sentimento ou enriquecimentos gerados por IA.

  • Name
    link
    Type
    string
    Description

    URL do artigo completo.

  • Name
    source
    Type
    string
    Description

    Site de origem. Ex.: www.reuters.com

  • Name
    title
    Type
    string
    Description

    Título do artigo.

  • Name
    summary
    Type
    string
    Description

    Resumo do artigo, se disponível. Pode ser nulo.

  • Name
    publishDate
    Type
    Date
    Description

    Data de publicação como string de data ISO 8601.

  • Name
    createdAt
    Type
    Date
    Description

    Data de criação interna do artigo no sistema do finlight, como string de data ISO 8601.

  • Name
    revisedDate
    Type
    Date | null
    Description

    Data da última revisão do artigo após a publicação inicial. null quando o artigo nunca foi revisado. Presente quando includeUpdates está habilitado e o artigo foi revisado.

  • Name
    isUpdate
    Type
    boolean
    Description

    true quando esta entrega é acionada por uma atualização pós-publicação. Presente apenas quando includeUpdates está habilitado.

  • Name
    language
    Type
    string
    Description

    Código de idioma em ISO 639-1. Ex.: en | de | fr

  • Name
    images
    Type
    string[]
    Description

    Array de URLs de imagens do artigo.

  • Name
    countries
    Type
    string[]
    Description

    Array de códigos de país no formato ISO 3166-1 alpha-2. Ex.: ["US", "GB"]. Pode estar vazio.

  • Name
    categories
    Type
    string[]
    Description

    Array de categorias do artigo. Valores possíveis: markets | economy | business | politics | geopolitics | regulation | technology | energy | commodities | crypto | health | climate | security. Pode estar vazio.

WEBHOOKTipo de entrega

Criar um webhook bruto

Ao criar um webhook no painel do finlight, selecione Raw como tipo de entrega no primeiro passo do assistente de configuração. O passo de critérios mostrará então apenas os quatro parâmetros de filtro suportados.

Os webhooks brutos entregam apenas artigos recém-publicados que correspondem aos seus critérios. Cada entrega é uma única carga de artigo enviada como requisição HTTP POST ao seu endpoint.

  • Name
    query
    Type
    string
    Description

    Consulta de busca para encontrar artigos relevantes. Suporta filtragem em nível de campo para source, title e summary. Consulte filtragem em nível de campo na query abaixo.

  • Name
    sources
    Type
    string[]
    Description

    Limita a entrega a artigos de fontes específicas. Ex.: ["www.reuters.com", "www.cnbc.com"]. Consulte o endpoint de fontes para os valores válidos.

  • Name
    excludeSources
    Type
    string[]
    Description

    Exclui artigos de fontes específicas. Ex.: ["www.example.com"].

  • Name
    language
    Type
    string
    Description

    Filtra pelo idioma do artigo (ISO 639-1). O padrão é en, que retorna apenas inglês e exclui outros idiomas — consulte Idioma e cobertura.

  • Name
    includeUpdates
    Type
    boolean
    Description

    Reentrega os artigos quando são atualizados após a publicação inicial. As cargas atualizadas incluem isUpdate=true e uma marca de tempo 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"]
}

Filtragem em nível de campo na query

O parâmetro query dos webhooks brutos suporta filtragem em nível de campo limitada apenas a estes campos:

  • source — filtra pelo domínio de origem do artigo
  • title — filtra pelo conteúdo do título do artigo
  • summary — filtra pelo conteúdo do resumo do artigo

Exemplos:

query=title:Nvidia

Entrega artigos cujo título contém "Nvidia".

query=summary:earnings +title:Tesla

Entrega artigos cujo resumo menciona "earnings" e cujo título contém "Tesla".

query=source:www.reuters.com -crypto

Entrega artigos da Reuters, excluindo os que mencionam "crypto".

Consulte o guia de Criação de consultas avançadas para a referência completa da sintaxe de consulta.

GUIDEAjuda para decidir

Quando usar webhooks brutos

Escolha Raw quando você:

  • Precisa da menor latência de entrega possível
  • Está construindo um pipeline de alta taxa de transferência em que dados de enriquecimento não são necessários
  • Só precisa filtrar por palavras-chave, fontes ou idioma
  • Quer uma carga mais enxuta para reduzir a sobrecarga de processamento do seu lado

Escolha Enriched quando você:

  • Precisa de filtragem em nível de empresa/ticker (tickers, countries, categories)
  • Quer pontuações de sentimento, valores de confiança ou resolução de entidades na carga
  • Precisa incluir o conteúdo completo do artigo ou entidades extraídas via includeContent / includeEntities
  • Está construindo monitoramento de ações, acompanhamento de resultados ou feeds de notícias específicos de setor

Para detalhes completos sobre as opções de filtragem de webhooks enriquecidos, consulte o guia de Critérios de filtragem.