इंटीग्रेशन

वेबहुक

कुछ प्रोवाइडर अगले सिंक का इंतज़ार किए बिना घटनाओं की सूचना तुरंत देते हैं। इसके लिए आप उनके यहाँ VentionDesk का एक वेबहुक पता डालते हैं। हर पता आपके वर्कस्पेस के ठीक एक कनेक्शन का होता है।

वेबहुक पता कहाँ मिलेगा (Where to find the URL)

संचालन › स्रोत, कनेक्शन पर “वेबहुक पता दिखाएँ” (केवल मालिक)। API यही पता GET /v1/integrations/:id/webhook पर देता है। कनेक्शन दोबारा जोड़ने पर भी यह वही रहता है।

प्रोवाइडर	URL	जाँच
Stripe	`https://api.ventiondesk.com/webhooks/stripe/<workspace>`	`Stripe-Signature` हेडर में सिग्नेचर
Sentry	`https://api.ventiondesk.com/webhooks/errors/sentry/<connection>`	`Sentry-Hook-Signature` हेडर में सिग्नेचर
Bugsnag	`https://api.ventiondesk.com/webhooks/errors/bugsnag/<connection>/<secret>`	URL में सीक्रेट
Rollbar	`https://api.ventiondesk.com/webhooks/errors/rollbar/<connection>/<secret>`	URL में सीक्रेट

कोण कोष्ठक वाले प्लेसहोल्डर VentionDesk भरता है — पता हमेशा “वेबहुक पता दिखाएँ” से कॉपी करें, उसे ख़ुद न जोड़ें।

Stripe

इसे Stripe › Developers › Webhooks › “Add endpoint” में ठीक इन इवेंट के साथ बनाएँ:

checkout.session.completed
checkout.session.async_payment_succeeded
checkout.session.async_payment_failed
charge.refunded

फिर एंडपॉइंट का साइनिंग सीक्रेट (whsec_…) कॉपी करें और उसके साथ VentionDesk में Stripe कनेक्शन फिर से सेव करें। तभी इनवॉइस ईमेल और दस्तावेज़ में भुगतान लिंक दिखता है — वेबहुक के बिना भुगतान आ जाता, लेकिन VentionDesk उसे दर्ज नहीं करता।

VentionDesk इस सीक्रेट से सिग्नेचर जाँचता है (टाइमस्टैम्प और बॉडी पर HMAC-SHA256) और केवल वे संदेश स्वीकार करता है जिनका टाइमस्टैम्प अधिकतम पाँच मिनट अलग हो। आपकी कुंजी से दूसरे मोड के इवेंट (लाइव की जगह टेस्ट या उल्टा) स्वीकार होते हैं और छोड़ दिए जाते हैं। VentionDesk भुगतान लिंक से आए भुगतान और रिफ़ंड दर्ज होते हैं। पूरी गाइड: Stripe जोड़ें।

Sentry

इंटरनल इंटीग्रेशन में “Webhooks” के नीचे “issue” पर टिक करें और URL को “Webhook URL” में डालें। इंटीग्रेशन का client secret आप VentionDesk में डालते हैं; VentionDesk इससे Sentry-Hook-Signature सिग्नेचर जाँचता है (बॉडी पर HMAC-SHA256)। नई और फिर से खुली त्रुटियाँ तब तुरंत दिखती हैं। गाइड: Sentry जोड़ें।

Bugsnag

प्रोजेक्ट में Project settings › “Integrations and email” › “Webhook” के नीचे इसे डालें और “New errors”, “Frequently occurring errors” और “Reopened errors” चुनें। Bugsnag साइन नहीं करता; इसलिए सीक्रेट URL में होता है और उसकी तुलना की जाती है। गाइड: Bugsnag जोड़ें।

Rollbar

प्रोजेक्ट में Settings › Notifications › “Webhook” के नीचे इसे डालें और “New Item”, “Reactivated Item”, “Resolved Item” और “10^nth Occurrence” चालू करें। Bugsnag की तरह सीक्रेट URL में होता है। गाइड: Rollbar जोड़ें।

एरर ट्रैकर से VentionDesk केवल मेटाडेटा लेता है — ID, छोटा शीर्षक, स्तर, स्थिति, काउंटर, पहली और आख़िरी घटना और लिंक। स्टैक ट्रेस, इवेंट बॉडी, यूज़र डेटा और IP पते प्रोवाइडर के पास ही रहते हैं, भले ही वे वेबहुक के साथ आएँ।

GitHub

GitHub के लिए आपको कुछ नहीं डालना होता: VentionDesk ऐप इंस्टॉल होते ही पुश, पुल रिक्वेस्ट, चेक रन और डिप्लॉयमेंट स्थिति अपने-आप भेजता है। देखें GitHub जोड़ें।

सिस्टम कैसे जवाब देता है (How VentionDesk responds)

हर डिलीवरी एक बार गिनी जाती है। उसी ID वाली दोहराई गई डिलीवरी पहचानी जाती है और दो बार प्रोसेस नहीं होती।
ग़लत सिग्नेचर या ग़लत सीक्रेट: डिलीवरी अस्वीकार कर दी जाती है।
अगर VentionDesk कोई डिलीवरी सेव नहीं कर पाता, तो वह 200 की जगह त्रुटि से जवाब देता है — तब प्रोवाइडर फिर से भेजता है, और कुछ भी चुपचाप नहीं खोता।
प्रति IP पता हर वेबहुक रूट प्रति मिनट 600 डिलीवरी तक स्वीकार करता है।