इंटीग्रेशन: आउटबाउंड वेबहुक

सेटिंग्स → इंटीग्रेशन (पता /app/settings/integrations) इस वर्कस्पेस के इवेंट आपके किसी URL पर भेजता है, उदाहरण के लिए किसी ऑटोमेशन टूल (Zapier, Make, n8n) या आपके अपने सर्वर पर। केवल मालिक और एडमिन इसे देख और बदल सकते हैं।

चरण दर चरण: एंडपॉइंट जोड़ें

1. सेटिंग्स → इंटीग्रेशन खोलें।
2. एंडपॉइंट URL में अपने एंडपॉइंट का URL टाइप करें, जैसे https://your-system.example.com/omnibrand-hook। यह https होना चाहिए और सार्वजनिक इंटरनेट से पहुंच योग्य होना चाहिए; नहीं तो एक लाल पंक्ति बताती है कि कौन-सी बात गलत है ("एंडपॉइंट का पता https:// से शुरू होना चाहिए। सादा http:// स्वीकार नहीं किया जाता।", या यह कि इस तक इंटरनेट से नहीं पहुंचा जा सकता)।
3. इवेंट में वे इवेंट टिक करें जो यह एंडपॉइंट प्राप्त करेगा। हर बॉक्स में एक सरल विवरण और इवेंट का नाम होता है, जैसे post.published ("एक पोस्ट प्रकाशित हुई"), post.failed, social_account.token_expired या social_account.disconnected; सभी इवेंट, बाद में जोड़े जाने वाले इवेंट भी * है। workspace.created और invitation.accepted भी वहां हैं। कम से कम एक टिक करें, नहीं तो फ़ॉर्म कहता है "कम से कम एक इवेंट चुनें।"
4. एंडपॉइंट जोड़ें पर क्लिक करें।
5. साइनिंग सीक्रेट (अभी कॉपी करें - केवल एक बार दिखाया जाएगा): फॉर्म के ऊपर, रहस्य के साथ दिखाई देता है; पृष्ठ उस तक स्क्रॉल करता है ताकि आप इसे फोन पर भी देख सकें। यदि समापन बिंदु को अस्वीकार कर दिया जाता है, तो लाल संदेश उसी स्थान पर दिखाई देता है और पृष्ठ उस पर स्क्रॉल करता है। अभी रहस्य को अपने प्राप्त करने वाले सिस्टम में कॉपी करें; ओमनीब्रांड इसे फिर कभी नहीं दिखाता है (केवल इसके अंतिम चार वर्ण)। इसके बगल में सीक्रेट कॉपी करें करें इसे आपके लिए कॉपी करें।
6. समापन बिंदु पर परीक्षण भेजें पर क्लिक करें। आप अपने सर्वर द्वारा लौटाए गए HTTP स्थिति के साथ ✓ वितरित देखते हैं। जब यह विफल हो जाता है तो आप देखते हैं "वितरित नहीं किया गया: आपके सर्वर ने [स्थिति] का उत्तर दिया। " को ठीक करने के लिए, उदाहरण के लिए 405 विधि की अनुमति नहीं है "इसे इस पते पर POST अनुरोध स्वीकार करना होगा। URL की जाँच करें", रीडायरेक्ट के लिए "यह किसी अन्य पते पर रीडायरेक्ट करता है, और वेबहुक कभी भी रीडायरेक्ट का पालन नहीं करता है। इसके बजाय अंतिम URL पंजीकृत करें। या, जब सर्वर तक बिल्कुल भी नहीं पहुंचा जा सका, "वितरित नहीं किया गया: आपके सर्वर तक नहीं पहुंचा जा सका ([कारण])। URL की जाँच करें और सर्वर ऑनलाइन है। एक वेबहुक कैसे काम करते हैं लिंक इस लेख को खोलता है।

हर एंडपॉइंट

• URL और एक बैज सक्रिय या अक्षम।
• "घटनाएँ: ... · गुप्त ••••1234", प्रत्येक घटना के साथ उसके विवरण के अनुसार (उदाहरण के लिए "एक पोस्ट प्रकाशित की गई थी"), साथ ही "· N लगातार विफलताएँ" जब डिलीवरी विफल हो रही हो।
• स्विच सक्षम / अक्षम डिलीवरी को रोकता है या फिर से शुरू करता है। जबकि परिवर्तन सहेजा जाता है, कार्ड कहता है "काम कर रहा है ..." और इसका टेस्ट भेजें और हटाएं; यदि स्विच या हटाएं विफल हो जाता है, तो कारण उस समापन बिंदु के कार्ड के नीचे लाल रंग में दिखाई देता है, और पृष्ठ उस पर स्क्रॉल करता है।
• टेस्ट भेजें webhook.test नाम का एक इवेंट भेजता है।
• हटाएं पूछता है "(address) वाला वेबहुक डिलीट करें? इस पर इवेंट भेजना तुरंत बंद हो जाता है और इसका साइनिंग सीक्रेट हमेशा के लिए चला जाता है। इसकी जगह इसे रोकने के लिए, इसका स्विच बंद करें।" विंडो का शीर्षक वेबहुक हटाएं? होता है; एंडपॉइंट को तुरंत हटाने के लिए हटाएं पर क्लिक करें, या उसे रखने के लिए रद्द करें।

आपके सर्वर को क्या मिलता है

JSON बॉडी वाला एक POST अनुरोध: id (इवेंट की id - डुप्लिकेट अनदेखा करने के लिए इसका उपयोग करें), event (उदाहरण के लिए post.published), occurredAt, और data (इवेंट का विवरण)। हेडर:

• X-OmniBrand-Signature: sha256= के बाद रॉ बॉडी का HMAC-SHA256, जो आपके साइनिंग सीक्रेट से बनाया गया है।
• X-OmniBrand-Timestamp और X-OmniBrand-Signature-V2: टाइमस्टैम्प, एक बिंदु और बॉडी का HMAC-SHA256 - पुराने दोहराए गए अनुरोध (रीप्ले) अस्वीकार करने के लिए इसका उपयोग करें।

5 सेकंड के भीतर किसी भी 2xx स्टेटस के साथ जवाब दें।

अगर कुछ गलत हो जाए

• नेटवर्क त्रुटियाँ, 5xx और 429 जवाब उसी डिलीवरी में 3 बार तक फिर से आज़माए जाते हैं; अन्य 4xx जवाब फिर से नहीं आज़माए जाते।
• रीडायरेक्ट का कभी पालन नहीं किया जाता है; अंतिम URL पंजीकृत करें। यदि आपका रीडायरेक्ट करता है, तो परीक्षण कहता है "वितरित नहीं किया गया: आपके सर्वर ने 301 स्थायी रूप से स्थानांतरित कर दिया है। यह किसी अन्य पते पर रीडायरेक्ट हो जाता है, और वेबहुक कभी भी रीडायरेक्ट का अनुसरण नहीं करते हैं। इसके बजाय अंतिम URL पंजीकृत करें। (आपके सर्वर द्वारा भेजे गए स्टेटस के साथ)।
• लगातार 20 डिलीवरी विफल होने के बाद एंडपॉइंट अपने आप अक्षम हो जाता है और एडमिन को सूचित किया जाता है। प्राप्त करने वाले सिस्टम को ठीक करें, फिर स्विच को वापस सक्षम पर करें।

जानने योग्य बातें

• एंडपॉइंट को केवल इसी वर्कस्पेस के इवेंट मिलते हैं, साथ में पूरे खाते के इवेंट (बिलिंग और खाते के इवेंट)।
• एंडपॉइंट जोड़ते समय आप जिस वर्कस्पेस में होते हैं, एंडपॉइंट उसी का होता है।