n8n इंटीग्रेशन

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

आपको कौन सा प्लान चाहिए

Webhook नोड को अपने इवेंट Deskwoot के एक webhook से मिलते हैं। Webhooks के लिए Startup प्लान या उससे ऊपर का प्लान चाहिए, और ट्रायल में भी ये शामिल हैं। मुफ़्त Hacker प्लान पर webhooks कुछ नहीं भेजते।

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

n8n में Webhook नोड (Startup और उससे ऊपर)

n8n में सेट अप करें

1. n8n में अपना वर्कफ़्लो खोलें और पहले स्टेप के रूप में एक Webhook नोड जोड़ें।
2. HTTP Method को POST पर सेट करें।
3. Respond को Immediately पर ही रहने दें, ताकि n8n तुरंत Deskwoot को जवाब दे।
4. नोड का Production URL कॉपी करें।

Deskwoot में सेट अप करें

1. सेटिंग्स > Webhooks पर जाएं। यह पेज सिर्फ़ एडमिनिस्ट्रेटर देखते हैं।
2. Webhook जोड़ें पर क्लिक करें।
3. एंडपॉइंट URL में Production URL पेस्ट करें।
4. इवेंट्स की सदस्यता लें में वे इवेंट चुनें जिनकी आपके वर्कफ़्लो को ज़रूरत है। अगर कोई नहीं चुना, तो webhook को हर इवेंट मिलता है।
5. Webhook बनाएं पर क्लिक करें।

फिर n8n में वर्कफ़्लो पब्लिश करें: वर्कफ़्लो पब्लिश होने के बाद ही n8n Production URL पर सुनता है। तब से हर इवेंट वर्कफ़्लो का एक रन शुरू करता है, और आप रन उसके Executions टैब में देखते हैं।

n8n में क्या पहुँचता है

हर इवेंट JSON बॉडी वाली एक POST रिक्वेस्ट के रूप में आता है। Webhook नोड के आउटपुट में बॉडी में event (इवेंट का नाम), data (इवेंट का डेटा), timestamp और accountId होते हैं। हेडर में इवेंट के नाम के साथ x-deskwoot-event और x-deskwoot-signature होते हैं। जब एक webhook कई इवेंट भेजता है, तो अगले नोड से event जांचें, जैसे किसी If नोड से।

आप ये इवेंट चुन सकते हैं: बातचीत बनाई गई, बातचीत अपडेट हुई, बातचीत असाइन हुई, बातचीत हल हुई, संदेश बनाया गया, संपर्क बनाया गया, संपर्क अपडेट हुआ और CSAT सबमिट हुआ। हर इवेंट का डेटा API डॉक्स में है।

जानने लायक बातें

• Deskwoot ज़्यादा से ज़्यादा 10 सेकंड इंतज़ार करता है। अगर n8n समय पर जवाब नहीं देता या एरर देता है, तो Deskwoot 5 सेकंड बाद एक बार और कोशिश करता है। Respond को Immediately पर रखने से लंबा वर्कफ़्लो भी Deskwoot को इंतज़ार नहीं कराता।
• n8n इंटरनेट से HTTPS पर पहुँचने लायक होना चाहिए। Deskwoot सिर्फ़ सार्वजनिक HTTPS पतों पर भेजता है। आपके अपने सर्वर पर चल रहे n8n को एक सार्वजनिक HTTPS पता चाहिए, आपके अंदरूनी नेटवर्क का पता नहीं।
• Production URL इस्तेमाल करें, Test URL नहीं। Deskwoot हमेशा सेव किए गए पते पर भेजता है, इसलिए यह वही पता होना चाहिए जिस पर n8n वर्कफ़्लो पब्लिश रहने तक सुनता है।

n8n के लिए Deskwoot नोड (Enterprise)

n8n के लिए Deskwoot नोड एक कम्युनिटी नोड है, जिसका नाम n8n-nodes-deskwoot है। इसमें 2 नोड आते हैं: Deskwoot Trigger, जो Deskwoot में कुछ होने पर वर्कफ़्लो शुरू करता है, और Deskwoot नोड, जो Deskwoot में काम करता है। यह आपके अपने सर्वर पर चल रहे n8n के साथ काम करता है। n8n Cloud सिर्फ़ वही कम्युनिटी नोड देता है जिन्हें n8n ने जांचा है, और यह नोड अभी उनमें शामिल नहीं है।

इंस्टॉल करें और साइन इन करें

1. n8n में Settings > Community Nodes पर जाएं, Install पर क्लिक करें, n8n-nodes-deskwoot डालें और इंस्टॉल करें। यह पेज सिर्फ़ आपके n8n के owner और admins देखते हैं।
2. Deskwoot में सेटिंग्स > API टोकन पर जाएं और टोकन बनाएं पर क्लिक करें। पढ़ना और लिखना स्कोप चुनें और टोकन बनाएं। उसे कॉपी करें: Deskwoot इसे सिर्फ़ एक बार दिखाता है। यह पेज सिर्फ़ एडमिनिस्ट्रेटर देखते हैं।
3. n8n में एक Deskwoot API क्रेडेंशियल बनाएं। API Token में टोकन पेस्ट करें। Account ID में वह ID डालें जो उसी Deskwoot पेज पर आपकी खाता ID में दिखती है। Base URL को जैसा है वैसा ही रहने दें।
4. क्रेडेंशियल सेव करें। n8n आपके वर्कस्पेस के इनबॉक्स की सूची लेकर उसे तुरंत जांचता है।

अगर जांच फ़ेल हो, तो टोकन रद्द हो गया है या उसकी मियाद खत्म हो गई है, खाता ID किसी दूसरे वर्कस्पेस की है, वर्कस्पेस Enterprise प्लान पर नहीं है, या टोकन में पढ़ना स्कोप नहीं है। AI एजेंट के लिए MCP टोकन यहाँ काम नहीं करता: सेटिंग्स > API टोकन में एक REST API टोकन बनाएं।

Deskwoot Trigger

Event में इनमें से एक इवेंट चुनें:

• Conversation Created: कोई बातचीत शुरू होती है, चाहे ग्राहक ने लिखा हो या आपकी टीम ने शुरू की हो।
• Customer Message Received: कोई ग्राहक किसी बातचीत में लिखता है। आपकी टीम के जवाब और नोट नहीं गिने जाते।
• Conversation Assigned: किसी बातचीत को नया ज़िम्मेदार मिलता है। नई बातचीत पर राउंड रॉबिन और ऑटोमेशन नियम इसे शुरू नहीं करते।
• Conversation Resolved: कोई बातचीत हल के रूप में मार्क की जाती है।
• Contact Created: कोई साथी Deskwoot में संपर्क जोड़ता है, या कोई ऐप API से जोड़ता है। आने वाले संदेशों से Deskwoot जो संपर्क बनाता है, वे इसकी जगह Conversation Created शुरू करते हैं।
• Conversation Rated: कोई ग्राहक संतुष्टि सर्वे में बातचीत को रेटिंग देता है।

हर इवेंट सादे फ़ील्ड वाले एक आइटम के रूप में आता है। बातचीत के साथ उसकी ID, नंबर, लिंक, स्टेटस, विषय, चैनल, इनबॉक्स, ज़िम्मेदार व्यक्ति, टीम, लेबल, ग्राहक का नाम, ईमेल पता और फ़ोन नंबर, और ग्राहक का पहला संदेश आता है।

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

• किसी एडमिनिस्ट्रेटर का बनाया हुआ टोकन। सिर्फ़ ऐसा टोकन ही Deskwoot ट्रिगर चालू कर सकता है।
• इंटरनेट से HTTPS पर पहुँचने लायक n8n। अगर n8n किसी reverse proxy के पीछे चलता है, तो n8n का WEBHOOK_URL उसके सार्वजनिक पते पर सेट करें।

Deskwoot नोड

Resource और Operation चुनें:

• Conversation > Start: आपके किसी इनबॉक्स से किसी संपर्क को पहला संदेश भेजता है, ईमेल पते, फ़ोन नंबर या संपर्क ID से। यह वहाँ काम करता है जहाँ कोई कंपनी पहले लिख सकती है, जैसे ईमेल या SMS। जिस शुरुआत को चैनल डिलीवर नहीं कर सकता (लाइव चैट, बिना मंज़ूर टेम्पलेट के WhatsApp, या Telegram, LINE या X का ऐसा यूज़र जिसने उस इनबॉक्स को कभी नहीं लिखा), उसे Deskwoot मना कर देता है, और नोड वजह दिखाता है।
• Conversation > Reply: बातचीत के चैनल से ग्राहक को जवाब भेजता है।
• Conversation > Add Private Note: ऐसा नोट जोड़ता है जो सिर्फ़ आपकी टीम देखती है।
• Conversation > Assign: बातचीत को किसी साथी को, किसी टीम को या दोनों को असाइन करता है।
• Conversation > Add Label: आपके किसी लेबल को बातचीत पर लगाता है।
• Contact > Create or Update: इस ईमेल पते वाले संपर्क को अपडेट करता है, या कोई न हो तो बनाता है।
• Contact > Find: वह एक संपर्क लौटाता है जो किसी ईमेल पते, फ़ोन नंबर या नाम से सबसे अच्छी तरह मेल खाता है।

बातचीत की ID आप Deskwoot Trigger के आउटपुट से ले सकते हैं। n8n से आए जवाब और नोट उस व्यक्ति का नाम दिखाते हैं जिसने API टोकन बनाया था। यह नोड n8n के AI एजेंट के लिए टूल के रूप में भी काम करता है।

अक्सर पूछे जाने वाले प्रश्न

मुझे कौन सा प्लान चाहिए?

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

मेरा वर्कफ़्लो शुरू क्यों नहीं होता?

जांचें कि वर्कफ़्लो n8n में पब्लिश है, Deskwoot के webhook में Production URL है और Test URL नहीं, इवेंट चुना हुआ है (या कोई भी नहीं चुना), और n8n इंटरनेट से HTTPS पर पहुँचने लायक है। मुफ़्त Hacker प्लान पर webhooks कुछ भी नहीं भेजते।

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

हाँ, Enterprise प्लान पर n8n के लिए Deskwoot नोड से: यह जवाब देता है, निजी नोट जोड़ता है, असाइन करता है, लेबल लगाता है, बातचीत शुरू करता है और संपर्क बनाता या अपडेट करता है। बाकी कामों के लिए, जैसे किसी बातचीत को हल करना, n8n के HTTP Request नोड से REST API को कॉल करें, यह भी Enterprise पर। Webhook सिर्फ़ इवेंट बाहर भेजता है। Enterprise के बिना, सेटिंग्स > बॉट्स में Custom Webhook बॉट (Startup और उससे ऊपर) से n8n बॉट की तरह ग्राहकों के संदेशों का जवाब दे सकता है।

मैं Deskwoot Trigger वाला वर्कफ़्लो पब्लिश क्यों नहीं कर पा रहा?

सिर्फ़ किसी एडमिनिस्ट्रेटर का बनाया हुआ API टोकन ही Deskwoot ट्रिगर चालू कर सकता है, क्योंकि ट्रिगर को webhook की तरह हर बातचीत के इवेंट मिलते हैं। एडमिनिस्ट्रेटर के रूप में टोकन बनाएं और उसे Deskwoot API क्रेडेंशियल में इस्तेमाल करें। n8n को इंटरनेट से HTTPS पर पहुँचने लायक भी होना चाहिए, और एक वर्कस्पेस में ऐसी ज़्यादा से ज़्यादा 100 सदस्यताएं हो सकती हैं, Zapier के लिए Deskwoot ऐप के ट्रिगर मिलाकर।

टोकन रद्द करने पर क्या होता है?

उस टोकन से चालू हुआ हर ट्रिगर तुरंत रुक जाता है, और नोड के एक्शन फ़ेल हो जाते हैं। नया टोकन बनाएं, Deskwoot API क्रेडेंशियल अपडेट करें, फिर वर्कफ़्लो को अनपब्लिश करके दोबारा पब्लिश करें।

मैं कैसे जानूँ कि कोई इवेंट सच में Deskwoot से आया है?

हर रिक्वेस्ट में x-deskwoot-signature हेडर होता है: sha256= के बाद रॉ बॉडी का hex HMAC SHA256, जो webhook के secret से साइन होता है। Deskwoot Trigger इसे आपके लिए जांचता है। Webhook नोड के लिए डैशबोर्ड यह secret नहीं दिखाता, इसलिए Production URL को पासवर्ड की तरह रखें: n8n उसे एक रैंडम पाथ देता है, और सिर्फ़ Deskwoot को उसका पता होना चाहिए। REST API से बनाया गया webhook अपना secret जवाब में एक बार लौटाता है।

क्या यह n8n Cloud के साथ काम करता है?

Webhook नोड n8n Cloud पर भी काम करता है और आपके अपने सर्वर पर चल रहे n8n पर भी। n8n के लिए Deskwoot नोड सिर्फ़ आपके अपने सर्वर पर चल रहे n8n के साथ काम करता है, क्योंकि n8n Cloud सिर्फ़ वही कम्युनिटी नोड देता है जिन्हें n8n ने जांचा है। अपने सर्वर पर n8n को एक सार्वजनिक HTTPS पता चाहिए, ताकि Deskwoot उस तक पहुँच सके।

क्या मैं कई वर्कफ़्लो शुरू कर सकता हूँ?

हाँ। Deskwoot में हर वर्कफ़्लो के Production URL के लिए एक अलग webhook बनाएं, हर एक के अपने इवेंट के साथ। Deskwoot नोड के साथ, Deskwoot Trigger वाले हर पब्लिश किए गए वर्कफ़्लो की अपनी सदस्यता होती है।

अगर n8n कुछ देर बंद रहे तो क्या होता है?

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