Webhooks

Webhooks permitem que sua aplicação receba notificações em tempo real quando eventos acontecem na Partnr API — sem precisar fazer polling. Isso é útil para alertas de carteira, automação de relatórios, monitoramento de proventos e pipelines de dados.

Em breve

A funcionalidade de Webhooks está em desenvolvimento e será disponibilizada em breve.

O que você poderá fazer com Webhooks da Partnr

Quando estiver disponível, você poderá configurar um endpoint (URL) no seu backend para receber eventos como:

• Relatórios publicados — novos demonstrativos e atualizações de documentos
• Proventos e eventos corporativos — dividendos/JCP e outros eventos de caixa
• Transações de insiders — novas movimentações registradas
• Notícias relevantes — publicações relacionadas a ativos acompanhados
• Mudanças em indicadores — variações em métricas e sinais acompanhados

Casos de uso comuns

• Alertas de carteira: notificar clientes quando um ativo da carteira tiver notícia relevante ou novo relatório.
• Automação de research: disparar rotinas quando sair DRE/DFP/ITR, provento ou insider transaction.
• ETL orientado a eventos: atualizar banco, dashboards e caches conforme eventos acontecem.
• Sinalização de risco: monitorar mudanças em indicadores e acionar modelos/rotinas internas.

Como funciona (alto nível)

1. Você registra uma URL de webhook no seu backend.
2. A Partnr envia um POST com um payload JSON quando um evento ocorre.
3. Seu servidor valida a requisição e processa o evento (armazenar, notificar, disparar jobs, etc.).

Recomendação: use webhooks para eventos e mantenha polling apenas como fallback.

Segurança (o que recomendamos)

Quando o recurso for lançado, as integrações seguirão boas práticas como:

• Assinatura de payload (ex.: X-Partnr-Signature) para verificar autenticidade
• Replays e idempotência (eventos com id único)
• Retries automáticos em falhas temporárias (ex.: 5xx, timeout)

Eventos previstos (primeira versão)

Os nomes finais podem sofrer ajustes, mas a primeira versão será focada em eventos de maior valor operacional:

• reports.published
• corporate_actions.announced
• insiders.transaction_created
• news.published
• indicators.updated

Status e acesso antecipado

Quer ser avisado quando lançarmos Webhooks (e participar do acesso antecipado)?
Fale com um especialista.