Deskwoot इवेंट उसी पल आपके अपने URL पर

Webhooks Deskwoot से इवेंट आपके चुने हुए URL पर उसी पल भेजते हैं जब वे होते हैं: नई बातचीत, नया संदेश, असाइनमेंट, हल हुई बातचीत, संपर्क में बदलाव या CSAT रेटिंग। हर इवेंट साइन किए गए POST अनुरोध में JSON के रूप में आता है, ताकि आपके अपने सिस्टम बार बार API से पूछने की जगह इवेंट पर काम करें।

अवलोकन

आपका सपोर्ट डेटा अक्सर किसी दूसरे सिस्टम तक पहुँचना चाहिए: ऐसा CRM जिसे हर नए संपर्क का पता हो, ऐसा डेटाबेस जो हल हुई बातचीत गिने, आपका अपना ऑटोमेशन जो ग्राहक के चैट रेट करने पर चले। Webhooks यह काम उस कोड के बिना करते हैं जो बार बार Deskwoot से बदलाव पूछता है। कुछ होते ही Deskwoot आपका URL कॉल करता है।

हर webhook के लिए आप इवेंट चुनते हैं: बातचीत बनाई गई, अपडेट हुई, असाइन हुई और हल हुई, संदेश बनाया गया, संपर्क बनाया गया और अपडेट हुआ, और CSAT सबमिट हुआ। Enterprise प्लान पर टिकट चालू हों तो टिकट बनाया गया, अपडेट हुआ, असाइन हुआ और हल हुआ भी मिलते हैं। जिस webhook में कोई इवेंट न चुना हो, उसे टिकट इवेंट छोड़कर सारे इवेंट मिलते हैं, और टिकट इवेंट सिर्फ़ उन्हीं webhooks को जाते हैं जो उन्हें चुनते हैं। कई URL के लिए हर एक का अलग webhook बनाएं, उसके अपने इवेंट के साथ।

हर इवेंट एक POST अनुरोध है, जिसकी JSON बॉडी में event (इवेंट का नाम), data (इवेंट का डेटा, API दस्तावेज़ में बताया गया), timestamp और accountId होते हैं। X-Deskwoot-Event हेडर इवेंट का नाम बताता है, और X-Deskwoot-Signature में sha256= और कच्ची बॉडी का HMAC SHA256 होता है, जो webhook के secret से साइन होता है।

Deskwoot हर इवेंट तुरंत भेजता है, बिना कतार के। आपके endpoint के पास 2xx स्टेटस से जवाब देने के लिए 10 सेकंड हैं। अगर अनुरोध फ़ेल हो, एरर आए या ज़्यादा समय लगे, तो Deskwoot 5 सेकंड बाद एक बार फिर कोशिश करता है, और उसके बाद इवेंट छोड़ दिया जाता है। कभी कभार कोई इवेंट दो बार आता है। बॉडी में कोई इवेंट ID नहीं होती, लेकिन दोहराया गया इवेंट उसी timestamp के साथ बिल्कुल वैसी ही कॉपी होता है, इसलिए पहले से प्रोसेस किए इवेंट छोड़ने के लिए इवेंट का नाम, data में ऑब्जेक्ट की ID और timestamp एक साथ इस्तेमाल करें। Deskwoot सिर्फ़ सार्वजनिक HTTPS पतों पर भेजता है।

Webhook सिर्फ़ Deskwoot से डेटा बाहर भेजता है। अपने सर्वर से ग्राहकों को जवाब देने के लिए सेटिंग्स → बॉट्स में Custom Webhook बॉट इस्तेमाल करें (Startup प्लान और उससे ऊपर)। अपने कोड से बातचीत असाइन करने, लेबल लगाने, हल करने या संपर्क अपडेट करने के लिए REST API इस्तेमाल करें, जिसके लिए पेड Enterprise प्लान चाहिए। Webhooks के लिए Startup प्लान या उससे ऊपर चाहिए, और 7 दिन के ट्रायल में ये शामिल हैं। Free प्लान पर पहले बनाए गए webhooks दिखते रहते हैं, लेकिन तब तक कुछ नहीं भेजते जब तक आपके प्लान में फिर से webhooks न हों।

Webhooks इंटीग्रेशन के साथ आपको क्या मिलता है

इवेंट उसी पल
नई बातचीत, संदेश, असाइनमेंट, हल हुई बातचीत, संपर्क बदलाव और CSAT रेटिंग तुरंत आपके URL तक पहुँचते हैं, बार बार पूछे बिना।
साइन किया हुआ JSON
हर अनुरोध JSON बॉडी वाला POST है, जिसमें X-Deskwoot-Event में इवेंट का नाम और X-Deskwoot-Signature में HMAC SHA256 सिग्नेचर होता है।
सिर्फ़ ज़रूरी इवेंट
हर webhook के लिए इवेंट चुनें, और अलग अलग इवेंट अलग अलग URL पर भेजें, हर एक के लिए एक webhook।
बिना हटाए रोकें
एक स्विच webhook को बंद और फिर चालू करता है, और संपादित करें से उसका URL या इवेंट बदलते हैं।

शुरुआत कैसे करें

Webhooks को 3 चरणों में जोड़ें।

Deskwoot में सेटिंग्स → Webhooks खोलें और Webhook जोड़ें पर क्लिक करें। यह पेज सिर्फ़ एडमिनिस्ट्रेटर देखते हैं।
एंडपॉइंट URL में सार्वजनिक HTTPS पता डालें और इवेंट्स की सदस्यता लें में अपने चाहे इवेंट चुनें।
Webhook बनाएं पर क्लिक करें। इसके बाद जब भी इनमें से कोई इवेंट होता है, Deskwoot आपके URL पर POST अनुरोध भेजता है।

सेटअप गाइड पढ़ें

Webhooks इंटीग्रेशन FAQ

छोटे जवाब यहाँ हैं। बाकी किसी भी सवाल के लिए नीचे Fynn से पूछें।

Deskwoot में हेल्पडेस्क webhooks कैसे काम करते हैं?

आप Deskwoot को एक URL देते हैं और इवेंट चुनते हैं। जब भी इनमें से कोई होता है, Deskwoot उस URL पर इवेंट को JSON के रूप में POST अनुरोध से भेजता है, webhook के secret से साइन करके। आपका सिस्टम API से बदलाव पूछने की जगह तुरंत काम करता है।

Webhooks के लिए कौन सा प्लान चाहिए?

Startup या उससे ऊपर, और 7 दिन के ट्रायल में ये शामिल हैं। Free प्लान पर पहले बनाए गए webhooks दिखते रहते हैं और हटाए जा सकते हैं, लेकिन तब तक कुछ नहीं भेजते जब तक आपके प्लान में फिर से webhooks न हों।

मैं किन इवेंट की सदस्यता ले सकता हूँ?

बातचीत बनाई गई, अपडेट हुई, असाइन हुई और हल हुई, संदेश बनाया गया, संपर्क बनाया गया और अपडेट हुआ, और CSAT सबमिट हुआ। Enterprise प्लान पर टिकट चालू हों तो टिकट बनाया गया, अपडेट हुआ, असाइन हुआ और हल हुआ भी। कोई इवेंट न चुना हो तो webhook को टिकट इवेंट छोड़कर सारे इवेंट मिलते हैं।

क्या हर डिलीवरी साइन होती है?

हाँ। X-Deskwoot-Signature हेडर में sha256= और कच्ची बॉडी का HMAC SHA256 होता है, जो webhook के secret से साइन होता है, और X-Deskwoot-Event इवेंट का नाम बताता है। डैशबोर्ड secret नहीं दिखाता। REST API से बनाया गया webhook उसे अपने जवाब में एक बार लौटाता है।

अगर मेरा endpoint बंद हो तो क्या होता है?

Deskwoot 5 सेकंड बाद एक बार फिर कोशिश करता है। वह भी फ़ेल हो तो इवेंट छोड़ दिया जाता है, क्योंकि Deskwoot उस एक दोबारा कोशिश के अलावा कुछ नहीं रखता। पेड Enterprise प्लान पर आप REST API से छूटा हुआ डेटा ले सकते हैं, जैसे सबसे नई गतिविधि वाली बातचीत की सूची से।

क्या webhook Deskwoot में कुछ बदल सकता है?

नहीं, webhook सिर्फ़ इवेंट बाहर भेजता है। अपने सर्वर से ग्राहकों को जवाब देने के लिए सेटिंग्स → बॉट्स में Custom Webhook बॉट इस्तेमाल करें (Startup और उससे ऊपर)। अपने कोड से बातचीत असाइन करने, लेबल लगाने, हल करने या संपर्क अपडेट करने के लिए पेड Enterprise प्लान पर REST API कॉल करें।