Início rápido
Receba notificações instantâneas quando surgirem notícias de última hora. Os webhooks entregam atualizações de artigos em tempo real diretamente à sua aplicação, eliminando a necessidade de consultar a API constantemente.
O que são webhooks?
Pense nos webhooks como notificações instantâneas para sua aplicação. Quando surge uma notícia que corresponde aos seus critérios, o finlight envia imediatamente os dados do artigo para o endpoint que você especificou.
Como os webhooks funcionam
Aqui está o fluxo completo em termos simples:
- Configurar - Defina seu webhook com critérios de notícias específicos
- Monitorar - Nosso sistema observa novos artigos 24 horas por dia, 7 dias por semana
- Combinar - Quando um artigo atende aos seus critérios, detectamos instantaneamente
- Entregar - Enviamos os dados do artigo diretamente para o seu endpoint
Essa abordagem de "API inversa" significa que sua aplicação recebe as atualizações no momento em que acontecem, em vez de solicitá-las repetidamente.
Primeiros passos
O que você vai precisar
Antes de criar seu primeiro webhook, certifique-se de ter:
- Assinatura ativa do finlight com acesso a webhooks
- Endpoint HTTPS público pronto para receber as chamadas do webhook
- Acesso ao painel em app.finlight.me
Acesso rápido
Vá direto para a criação de webhooks visitando app.finlight.me/news-webhooks e fazendo login na sua conta do finlight.
Criando seu primeiro webhook
Siga este processo simples de 4 etapas para configurar seu webhook e começar a receber atualizações de notícias em tempo real.
Etapa 1: Acesse o criador de webhooks
- Faça login no seu painel do finlight em app.finlight.me
- Navegue até "Webhooks" no menu principal
- Clique em "New Webhook" para abrir o assistente de configuração
Etapa 2: Detalhes básicos
Dê ao seu webhook uma identidade clara e escolha um tipo de entrega:
- Nome - Escolha algo descritivo como "Notícias de tecnologia de última hora" ou "Atualizações do mercado"
- Descrição - Explicação breve e opcional do propósito do webhook
- Tipo de entrega - Selecione como os artigos devem ser entregues:
- Enriquecido (padrão) — Carga processada por IA com dados da empresa, sentimento e opções de filtragem completas. Consulte o guia de Webhooks enriquecidos.
- Bruto — Entrega mais rápida, carga simplificada, filtros limitados. Consulte o guia de Webhooks brutos.
Etapa 3: Defina seus critérios de notícias
Configure a filtragem para receber apenas artigos relevantes. As opções disponíveis dependem do tipo de entrega escolhido.
Consulte Webhooks enriquecidos ou Webhooks brutos para a referência completa de filtros do seu tipo.
Etapa 4: Defina o destino e a segurança
Destino do webhook
Forneça a URL do seu endpoint para onde enviaremos as notícias:
- Deve ser uma URL HTTPS pública
- Deve responder rapidamente (menos de 5 segundos)
Configuração de segurança
Escolha como proteger o endpoint do seu webhook:
- Nenhuma - Sem autenticação adicional (não recomendado para produção)
- Autenticação básica - Proteção por usuário/senha via HTTP Basic Auth
- Cabeçalho personalizado - Envie sua chave de API no cabeçalho
X-Finlight-Key - Validação de assinatura - Sempre incluída para verificação da carga via cabeçalho
X-Webhook-Signature
Observação: A validação de assinatura é ativada automaticamente em todos os webhooks para verificação de integridade da carga, independentemente do método de autenticação escolhido.
Saiba mais sobre como implementar essas opções de segurança em nosso guia de autenticação.
Testando sua integração
Ferramentas de teste integradas
Antes de ir ao ar, valide a configuração do seu webhook:
- Recurso de teste do painel - Envie cargas de amostra para o seu endpoint
- Monitoramento de entregas - Acompanhe as taxas de sucesso e os tempos de resposta
- Diagnóstico de erros - Depure entregas com falha
Para instruções de teste completas, exemplos de carga e dicas de solução de problemas, visite nosso guia de testes de webhooks.
Precisa de ajuda?
Opções rápidas de suporte
Carga e filtragem
Consulte Webhooks enriquecidos ou Webhooks brutos para o modelo de artigo e a referência de filtros do seu tipo.
Configuração técnica
Visite nosso guia de autenticação e o guia de testes para obter ajuda detalhada de implementação.
Suporte geral
Confira nossa página de suporte para recursos adicionais e informações de contato.
Problemas do painel
Acesse o gerenciamento dos seus webhooks em app.finlight.me ou entre em contato com o suporte pela plataforma.
Pronto para começar?
Os webhooks transformam a forma como você recebe atualizações de notícias - de consultar a cada poucos minutos para a entrega instantânea no momento em que a notícia surge.
Comece de forma simples com critérios de filtragem básicos e depois expanda gradualmente à medida que descobre o que funciona melhor para sua aplicação. O painel do finlight facilita modificar e otimizar seus webhooks a qualquer momento.