Webhook

Webhook mengirim pesan kecil ke URL yang Anda kontrol setiap kali sesuatu terjadi di PeekHire — sehingga Anda bisa merespons secara real time, bukan terus melakukan polling API.

Cara kerja webhook

1. Anda membuat endpoint (URL di server Anda atau alat otomatisasi) di Alat developer → Webhooks.
2. Anda memilih event mana yang harus diterima.
3. Saat sebuah event terjadi, PeekHire mengirim HTTP POST dengan payload JSON ke endpoint Anda.

Payload sengaja dibuat kecil — payload mengidentifikasi apa yang terjadi dan objek yang terkait, sehingga Anda bisa mengambil detail lengkap dari REST API jika membutuhkannya.

Event yang tersedia

Event mencakup siklus perekrutan, termasuk:

• Lamaran — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Komentar lamaran — application.comment.created, application.comment.updated, application.comment.deleted.
• Campaigns — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Memverifikasi pengiriman

Setiap pengiriman ditandatangani agar Anda bisa memastikan pengiriman tersebut benar-benar berasal dari PeekHire. Verifikasi tanda tangan di endpoint Anda sebelum memercayai payload, dan respons dengan status 2xx untuk mengonfirmasi penerimaan.

Memeriksa pengiriman

Tampilan Pengiriman menampilkan percobaan webhook terbaru beserta hasilnya, sehingga Anda bisa memastikan event tiba dan men-debug endpoint yang tidak merespons.

Tips

• Respons dengan cepat menggunakan 2xx dan jalankan pekerjaan berat secara asinkron.
• Buat handler Anda idempoten — event yang sama terkadang dapat dikirim lebih dari sekali.
• Mulai dengan alat seperti Make, Zapier, atau n8n jika Anda tidak ingin menjalankan server.