Webhooks

Os webhooks enviam uma pequena mensagem para um URL que controlas assim que algo acontece na PeekHire — para reagires em tempo real em vez de consultar a API.

Como funcionam

1. Crias um endpoint (um URL no teu servidor ou numa ferramenta de automação) em Ferramentas para programadores → Webhooks.
2. Escolhes que eventos deve receber.
3. Quando ocorre um evento, a PeekHire envia um POST HTTP com carga JSON para o teu endpoint.

As cargas são propositadamente pequenas — indicam o que aconteceu e que objeto é afetado. Obtém os detalhes através da API REST.

Eventos disponíveis

Os eventos cobrem o ciclo de recrutamento, incluindo:

• Candidaturas — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Comentários — application.comment.created, application.comment.updated, application.comment.deleted.
• Campanhas — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Verificar as entregas

Cada entrega é assinada para confirmares que vem mesmo da PeekHire. Verifica a assinatura antes de confiar na carga e responde com 2xx para confirmar a receção.

Inspecionar entregas

A vista Entregas mostra as tentativas recentes e os resultados — para confirmar que os eventos chegam e depurar um endpoint que não responde.

Sugestões

• Responde depressa com 2xx e faz o trabalho pesado de forma assíncrona.
• Torna o teu handler idempotente — o mesmo evento pode chegar mais do que uma vez.
• Começa com o Make, o Zapier ou o n8n se preferires não gerir um servidor.