Webhook

I webhook inviano un piccolo messaggio a un URL che controlli ogni volta che succede qualcosa in PeekHire, così puoi reagire in tempo reale invece di interrogare periodicamente l'API.

Come funzionano i webhook

1. Crei un endpoint (un URL sul tuo server o uno strumento di automazione) in Strumenti per sviluppatori → Webhooks.
2. Scegli quali eventi deve ricevere.
3. Quando si verifica un evento, PeekHire invia un POST HTTP con un payload JSON al tuo endpoint.

I payload sono volutamente piccoli: identificano cosa è successo e quale oggetto riguardano, così puoi recuperare i dettagli completi dalla REST API se ti servono.

Eventi disponibili

Gli eventi coprono il ciclo di selezione, tra cui:

• Candidature — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Commenti alle candidature — application.comment.created, application.comment.updated, application.comment.deleted.
• Campagne — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Verificare le consegne

Ogni consegna è firmata, così puoi confermare che provenga davvero da PeekHire. Verifica la firma sul tuo endpoint prima di considerare affidabile il payload e rispondi con uno stato 2xx per confermare la ricezione.

Ispezionare le consegne

La vista Consegne mostra i tentativi webhook recenti e i relativi risultati, così puoi confermare che gli eventi stiano arrivando e fare debug di un endpoint che non risponde.

Suggerimenti

• Rispondi rapidamente con un 2xx ed esegui le attività pesanti in modo asincrono.
• Rendi il tuo handler idempotente: lo stesso evento può occasionalmente essere consegnato più di una volta.
• Inizia con uno strumento come Make, Zapier o n8n se preferisci non gestire un server.