Webhooks

Webhookurile trimit un mesaj scurt către un URL pe care îl controlezi ori de câte ori se întâmplă ceva în PeekHire — astfel încât să poți reacționa în timp real, în loc să interoghezi API.

Cum funcționează webhookurile

1. Creezi un endpoint (un URL pe serverul tău sau într-un instrument de automatizare) în Instrumente pentru dezvoltatori → Webhooks.
2. Alegi ce evenimente ar trebui să primească.
3. Când are loc un eveniment, PeekHire trimite un POST HTTP cu un payload JSON către endpointul tău.

Payloadurile sunt intenționat mici — identifică ce s-a întâmplat și obiectul la care se referă, astfel încât să poți prelua detaliile complete din REST API dacă ai nevoie de ele.

Evenimente disponibile

Evenimentele acoperă ciclul de recrutare, inclusiv:

• Candidaturi — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Comentarii la candidaturi — application.comment.created, application.comment.updated, application.comment.deleted.
• Campanii — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Verificarea livrărilor

Fiecare livrare este semnată, astfel încât să poți confirma că a venit cu adevărat de la PeekHire. Verifică semnătura pe endpointul tău înainte de a avea încredere în payload și răspunde cu un status 2xx pentru a confirma primirea.

Inspectarea livrărilor

Vizualizarea Livrări afișează încercările recente de webhook și rezultatele lor, astfel încât să poți confirma că evenimentele ajung și să depanezi un endpoint care nu răspunde.

Sfaturi

• Răspunde rapid cu un 2xx și procesează operațiunile grele asincron.
• Fă ca handlerul tău să fie idempotent — același eveniment poate fi livrat ocazional de mai multe ori.
• Începe cu un instrument precum Make, Zapier sau n8n dacă preferi să nu rulezi un server.