Webhooks

Τα webhooks στέλνουν ένα μικρό μήνυμα σε ένα URL που ελέγχετε κάθε φορά που συμβαίνει κάτι στο PeekHire — ώστε να μπορείτε να αντιδράτε σε πραγματικό χρόνο αντί να κάνετε polling στο API.

Πώς λειτουργούν τα webhooks

1. Δημιουργείτε ένα endpoint (ένα URL στον server σας ή σε ένα εργαλείο αυτοματισμού) στην ενότητα Εργαλεία προγραμματιστή → Webhooks.
2. Επιλέγετε ποια συμβάντα θα πρέπει να λαμβάνει.
3. Όταν προκύπτει ένα συμβάν, το PeekHire στέλνει ένα HTTP POST με JSON payload στο endpoint σας.

Τα payloads είναι σκόπιμα μικρά — προσδιορίζουν τι συνέβη και ποιο αντικείμενο αφορά, ώστε να μπορείτε να ανακτήσετε όλες τις λεπτομέρειες από το REST API αν τις χρειάζεστε.

Διαθέσιμα συμβάντα

Τα συμβάντα καλύπτουν τον κύκλο ζωής των προσλήψεων, όπως:

• Αιτήσεις — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Σχόλια αιτήσεων — application.comment.created, application.comment.updated, application.comment.deleted.
• Καμπάνιες — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Επαλήθευση παραδόσεων

Κάθε παράδοση υπογράφεται, ώστε να μπορείτε να επιβεβαιώσετε ότι προήλθε πράγματι από το PeekHire. Επαληθεύστε την υπογραφή στο endpoint σας πριν εμπιστευτείτε το payload και απαντήστε με κατάσταση 2xx για να επιβεβαιώσετε τη λήψη.

Έλεγχος παραδόσεων

Η προβολή Παραδόσεις εμφανίζει πρόσφατες προσπάθειες webhook και τα αποτελέσματά τους, ώστε να μπορείτε να επιβεβαιώνετε ότι τα συμβάντα φτάνουν και να εντοπίζετε προβλήματα σε ένα endpoint που δεν ανταποκρίνεται.

Συμβουλές

• Απαντήστε γρήγορα με ένα 2xx και εκτελέστε τις βαριές εργασίες ασύγχρονα.
• Κάντε τον handler σας idempotent — το ίδιο συμβάν μπορεί περιστασιακά να παραδοθεί περισσότερες από μία φορές.
• Ξεκινήστε με ένα εργαλείο όπως το Make, το Zapier ή το n8n αν προτιμάτε να μη διαχειρίζεστε server.