भाषा चुनें

Webhooks

Webhooks Shifton को आपकी कंपनी में विशिष्ट इवेंट होने पर आपके बाहरी सिस्टम को रियल-टाइम नोटिफिकेशन भेजने की अनुमति देते हैं।


यह क्या है?

Developer पृष्ठ पर Webhooks टैब आपको webhook endpoints बनाने देता है जो Shifton से स्वचालित नोटिफिकेशन प्राप्त करते हैं। जब आपके खाते में इवेंट होते हैं — जैसे कि कोई शिफ्ट बनाई जाती है, कोई कर्मचारी क्लॉक इन करता है, या कोई शेड्यूल प्रकाशित होता है — Shifton आपके निर्दिष्ट URL पर एक डेटा payload भेजता है। इससे आपके सिस्टम को अपडेट के लिए Shifton को लगातार poll करने की जरूरत नहीं रहती, जिससे इंटीग्रेशन तेज़ और अधिक कुशल बनता है।


पूर्व-आवश्यकताएँ

आवश्यकताविवरण
भूमिकाOwner या
Endpointwebhook payloads प्राप्त करने के लिए आपके सर्वर पर एक सार्वजनिक रूप से एक्सेस योग्य URL
ज्ञानHTTP अनुरोधों और webhooks की बुनियादी समझ (या किसी डेवलपर तक एक्सेस)

चरण-दर-चरण निर्देश

Webhooks टैब तक पहुँचना

Shifton screenshot
1
बाईं साइडबार से इंटीग्रेशन पर क्लिक करें।
2
डेवलपर
पृष्ठ पर जाएँ।
3
वेबहुक
टैब पर क्लिक करें।
4
यदि अभी तक कोई webhook नहीं बनाया गया है, तो आपको एक puzzle चित्रण के साथ खाली स्थिति दिखेगी।

नया Webhook बनाना

Shifton screenshot
Shifton screenshot
1
“नया वेबहुक”
बटन पर क्लिक करें।
2
webhook कॉन्फ़िगरेशन भरें:
फ़ील्डविवरण
URLवह endpoint URL जहाँ Shifton इवेंट डेटा भेजेगा
घटनाएँचुनें कि कौन से Shifton इवेंट इस webhook को ट्रिगर करें
सक्रियwebhook सक्षम या अक्षम करने के लिए टॉगल
1
webhook सहेजें।
2
Shifton अब चुने गए इवेंट होने पर आपके URL पर HTTP POST अनुरोध भेजेगा।

मौजूदा Webhooks प्रबंधित करना

1
Webhooks टैब पर, आपको सभी बनाए गए webhooks की सूची दिखेगी।
2
उसकी कॉन्फ़िगरेशन संपादित करने के लिए किसी webhook पर क्लिक करें।
3
आप URL बदल सकते हैं, इवेंट चयन अपडेट कर सकते हैं, या सक्रिय स्थिति टॉगल कर सकते हैं।
4
कोई webhook हटाने के लिए delete विकल्प का उपयोग करें।

Webhook परीक्षण करना

1
webhook बनाने के बाद, Shifton में संबंधित इवेंट ट्रिगर करें (उदाहरण के लिए, एक परीक्षण शिफ्ट बनाएँ)।
2
यह पुष्टि करने के लिए अपने endpoint सर्वर लॉग जाँचें कि webhook payload प्राप्त हुई।
3
यदि payload नहीं आई, तो सत्यापित करें कि URL सही और सार्वजनिक रूप से एक्सेस योग्य है।

एक्सेस अनुमतियाँ

Shifton screenshot
भूमिकाWebhooks देखेंWebhooks बनाएँ/संपादित करेंWebhooks हटाएँ
Ownerहाँहाँहाँ
हाँहाँहाँ
Managerनहींनहींनहीं
Employeeनहींनहींनहीं

FAQ

प्र: शिफ्टon webhook वेतनloads के लिए कौन सा फ़ॉर्मेट उपयोग करता है?
उ: Webhooks JSON बॉडी के साथ HTTP POST अनुरोधों के रूप में भेजे जाते हैं। प्रत्येक इवेंट प्रकार के लिए सटीक payload संरचना के लिए API दस्तावेज़ीकरण देखें।

प्र: क्या मैं एक ही इवेंट के लिए कई वेबहुक सेट कर सकता हूँ?
उ: हाँ, आप ऐसे कई webhooks बना सकते हैं जो एक ही इवेंट सुनते हों, प्रत्येक अलग URL पर।

प्र: यदि webhook फायर होने पर मेरा सर्वर डाउन हो तो क्या होता है?
उ: यदि आपका endpoint अनुपलब्ध है, तो webhook delivery विफल हो सकती है। retry policies और विफलता प्रबंधन के विवरण के लिए API दस्तावेज़ीकरण जाँचें।

प्र: क्या मैं वेबहुक को केवल विशिष्ट कर्मचारियों या प्रोजेक्ट के लिए ट्रिगर करने के लिए फ़िल्टर कर सकता हूँ?
उ: Webhook इवेंट चयन सामान्यतः इवेंट-प्रकार स्तर पर होता है। विशिष्ट कर्मचारियों या प्रोजेक्ट के लिए आने वाले डेटा को संभालने के लिए आपको अपने सर्वर साइड पर डेटा फ़िल्टर करना होगा।

प्र: मैं अपने webhook अंतpoint को कैसे सुरक्षित करूँ?
उ: यह सत्यापित करने के लिए कि आने वाले अनुरोध वास्तव में Shifton से आते हैं, एक secret token या signature verification का उपयोग करने पर विचार करें। सुरक्षा अनुशंसाओं के लिए API दस्तावेज़ीकरण देखें।


संभावित समस्याएँ और समाधान

समस्यासंभावित कारणसमाधान
Webhook फायर नहीं हो रहाWebhook inactive पर सेट हैWebhook संपादित करें और सुनिश्चित करें कि Active टॉगल सक्षम है
Endpoint एरर लौटा रहा हैURL गलत है या सर्वर डाउन हैसत्यापित करें कि URL सही है और आपका सर्वर चल रहा है और सार्वजनिक रूप से एक्सेस योग्य है
Payload प्राप्त नहीं हुईफ़ायरवॉल आने वाले अनुरोधों को ब्लॉक कर रहा हैShifton से आने वाले POST अनुरोधों को अनुमति देने के लिए अपने सर्वर फ़ायरवॉल सेटिंग्स जाँचें
Webhook फायर होता है लेकिन डेटा अधूरा हैगलत इवेंट प्रकार चुना गयाWebhook संपादित करें और सत्यापित करें कि सही इवेंट चुने गए हैं
मौजूदा webhooks के बावजूद खाली स्थिति दिख रही हैपृष्ठ रिफ्रेश नहीं किया गयानवीनतम डेटा लोड करने के लिए Webhooks टैब रिफ्रेश करें
“नया वेबहुक” बटन दिखाई नहीं देताअपर्याप्त अनुमतियाँसुनिश्चित करें कि आपके पास Owner या भूमिका है