वेबहुक

वेबहुक, PeekHire में कुछ भी होने पर आपके नियंत्रण वाले URL पर छोटा-सा संदेश भेजते हैं—इससे आप API को बार-बार चेक करने के बजाय रियल टाइम में प्रतिक्रिया दे सकते हैं।

वेबहुक कैसे काम करते हैं

1. Developer tools → Webhooks में एक एंडपॉइंट (आपके सर्वर या ऑटोमेशन टूल का URL) बनाएँ।
2. चुनें कि उसे कौन-से इवेंट मिलने चाहिए।
3. कोई इवेंट होने पर, PeekHire आपके एंडपॉइंट पर JSON पेलोड के साथ HTTP POST भेजता है।

पेलोड जानबूझकर छोटे रखे जाते हैं—इनसे पता चलता है कि क्या हुआ और वह किस ऑब्जेक्ट से जुड़ा है। ज़रूरत पड़ने पर, पूरी जानकारी 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 से आई है। पेलोड पर भरोसा करने से पहले अपने एंडपॉइंट पर हस्ताक्षर की पुष्टि करें और डिलीवरी मिलने की पुष्टि के लिए 2xx स्टेटस भेजें।

डिलीवरी देखना

डिलीवरी व्यू में हाल ही के वेबहुक प्रयास और उनके नतीजे दिखते हैं। इससे आप पुष्टि कर सकते हैं कि इवेंट मिल रहे हैं और जवाब न देने वाले एंडपॉइंट की समस्या का पता लगा सकते हैं।

सुझाव

• जल्दी से 2xx जवाब दें और बाकी काम एसिंक्रोनस तरीके से करें।
• अपना हैंडलर इडेम्पोटेंट बनाएँ—कभी-कभी वही इवेंट एक से ज़्यादा बार भेजा जा सकता है।
• अगर आप सर्वर नहीं चलाना चाहते, तो Make, Zapier या n8n जैसे टूल से शुरुआत करें।