Webhooks Shifton को आपकी कंपनी में विशिष्ट इवेंट होने पर आपके बाहरी सिस्टम को रियल-टाइम नोटिफिकेशन भेजने की अनुमति देते हैं।
यह क्या है?
Developer पृष्ठ पर Webhooks टैब आपको webhook endpoints बनाने देता है जो Shifton से स्वचालित नोटिफिकेशन प्राप्त करते हैं। जब आपके खाते में इवेंट होते हैं — जैसे कि कोई शिफ्ट बनाई जाती है, कोई कर्मचारी क्लॉक इन करता है, या कोई शेड्यूल प्रकाशित होता है — Shifton आपके निर्दिष्ट URL पर एक डेटा payload भेजता है। इससे आपके सिस्टम को अपडेट के लिए Shifton को लगातार poll करने की जरूरत नहीं रहती, जिससे इंटीग्रेशन तेज़ और अधिक कुशल बनता है।
पूर्व-आवश्यकताएँ
| आवश्यकता | विवरण |
|---|---|
| भूमिका | Owner या |
| Endpoint | webhook payloads प्राप्त करने के लिए आपके सर्वर पर एक सार्वजनिक रूप से एक्सेस योग्य URL |
| ज्ञान | HTTP अनुरोधों और webhooks की बुनियादी समझ (या किसी डेवलपर तक एक्सेस) |
चरण-दर-चरण निर्देश
Webhooks टैब तक पहुँचना

नया Webhook बनाना


| फ़ील्ड | विवरण |
|---|---|
| URL | वह endpoint URL जहाँ Shifton इवेंट डेटा भेजेगा |
| घटनाएँ | चुनें कि कौन से Shifton इवेंट इस webhook को ट्रिगर करें |
| सक्रिय | webhook सक्षम या अक्षम करने के लिए टॉगल |
मौजूदा Webhooks प्रबंधित करना
Webhook परीक्षण करना
एक्सेस अनुमतियाँ

| भूमिका | 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 या भूमिका है |