Webhooks

Webhooks sender en liten melding til en URL du kontrollerer hver gang noe skjer i PeekHire — slik at du kan reagere i sanntid i stedet for å polle API.

Slik fungerer webhooks

1. Du oppretter et endepunkt (en URL på serveren din eller et automatiseringsverktøy) under Utviklerverktøy → webhooks.
2. Du velger hvilke hendelser det skal motta.
3. Når en hendelse oppstår, sender PeekHire en HTTP POST med en JSON-nyttelast til endepunktet ditt.

Nyttelaster er med vilje små — de identifiserer hva som skjedde og hvilket objekt det gjelder, slik at du kan hente fullstendige detaljer fra REST API hvis du trenger dem.

Tilgjengelige hendelser

Hendelser dekker rekrutteringslivssyklusen, inkludert:

• Søknader — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Søknadskommentarer — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampanjer — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Verifisere leveranser

Hver leveranse signeres, slik at du kan bekrefte at den faktisk kom fra PeekHire. Verifiser signaturen på endepunktet ditt før du stoler på nyttelasten, og svar med en 2xx-status for å bekrefte mottak.

Inspisere leveranser

Visningen Leveranser viser nylige webhook-forsøk og resultatene deres, slik at du kan bekrefte at hendelser kommer frem og feilsøke et endepunkt som ikke svarer.

Tips

• Svar raskt med en 2xx, og gjør tungt arbeid asynkront.
• Gjør behandleren din idempotent — samme hendelse kan av og til leveres mer enn én gang.
• Start med et verktøy som Make, Zapier eller n8n hvis du helst ikke vil kjøre en server.