> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Zendesk ## ओवरव्यू सपोर्ट टिकट्स, यूज़र्स और ऑर्गनाइज़ेशन्स मैनेज करने के लिए अपने ElevenLabs AI एजेंट्स को [Zendesk](https://www.zendesk.com/) से कनेक्ट करें। यह इंटीग्रेशन आपके एजेंट्स को टिकट बनाने और अपडेट करने, मौजूदा रिकॉर्ड्स खोजने, यूज़र्स मैनेज करने और आने वाले टिकट कमेंट्स का जवाब देने देता है। ## क्षमताएं | क्षमता | सहायता | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ज़ीरो रिटेंशन मोड (ZRM) | समर्थित नहीं | | ट्रिगर्स में अटैचमेंट | आने वाले टिकट कमेंट्स में मौजूद इमेजेज़ (PNG, JPEG, GIF, WebP) और PDF फ़ाइलें, जब एजेंट सेटिंग्स में **Allow file attachments** चालू हो और एजेंट का LLM इमेज या डॉक्यूमेंट इनपुट सपोर्ट करता हो | | टूल्स में अटैचमेंट | समर्थित नहीं — `zendesk_show_ticket` और `zendesk_list_ticket_comments` जैसे टूल्स टेक्स्ट फ़ील्ड्स लौटाते हैं और अटैचमेंट्स डाउनलोड नहीं करते | ## सेटअप यह इंटीग्रेशन तीन ऑथेंटिकेशन मेथड्स सपोर्ट करता है: ElevenLabs OAuth ऐप, आपका अपना OAuth क्लाइंट और API टोकन। > **Note** > > Zendesk ऑथेंटिकेशन मेथड के रूप में [API टोकन्स को बंद कर रहा है](https://support.zendesk.com/hc/en-us/articles/10851263566234) > और सिर्फ़ OAuth एक्सेस पर जा रहा है। मौजूदा API टोकन-आधारित Zendesk इंटीग्रेशन्स 30 अप्रैल, 2027 तक काम करते रहेंगे। > ElevenLabs इस माइग्रेशन को सपोर्ट करने पर काम कर रहा है और प्रभावित ग्राहकों को OAuth पर ट्रांज़िशन करने में मदद के लिए > उससे पहले सक्रिय रूप से संपर्क करेगा। आप कभी भी नीचे दिए गए **Custom OAuth client** मेथड पर स्विच कर सकते हैं। #### OAuth #### अपना सबडोमेन खोजें आपका Zendesk सबडोमेन आपके Zendesk URL का पहला हिस्सा है (जैसे `mycompany.zendesk.com` में `mycompany`)। #### ElevenLabs में कनेक्ट करें ElevenLabs इंटीग्रेशन सेटअप में **OAuth2** क्रेडेंशियल चुनें, अपना **subdomain** दर्ज करें और **Connect** पर क्लिक करें। #### कनेक्शन को अधिकृत करें Zendesk एक ऑथराइज़ेशन पेज दिखाता है, जिसमें ElevenLabs ऐप द्वारा मांगा गया एक्सेस होता है: आपके पूरे अकाउंट के लिए रीड एक्सेस, साथ ही टिकट्स, यूज़र्स, वेबहुक्स और ट्रिगर्स के लिए राइट एक्सेस। जिस यूज़र के पास आपके एजेंट के लिए ज़रूरी परमिशन्स हैं, उसके रूप में साइन इन करें और **Allow** पर क्लिक करें। Zendesk आपको वापस ElevenLabs पर रीडायरेक्ट करेगा और कनेक्शन बन जाएगा। अगर आप Zendesk ट्रिगर्स इस्तेमाल करने वाले हैं, तो एडमिनिस्ट्रेटर के रूप में अधिकृत करें — वेबहुक बनाना और ट्रिगर्स एडिट करना Zendesk एडमिन्स तक सीमित है। #### API टोकन #### API टोकन एक्सेस चालू करें [Zendesk Admin Center](https://support.zendesk.com/hc/en-us/articles/4581766374554-Using-Admin-Center) में **Apps and integrations > APIs > Zendesk API** पर जाएं और **Token Access** चालू करें। #### API टोकन जनरेट करें **Apps and integrations > APIs > API tokens** पर जाएं और **Add API token** पर क्लिक करें। टोकन तुरंत कॉपी करें — डायलॉग बंद करने के बाद यह दोबारा नहीं दिखेगा। #### अपना सबडोमेन खोजें आपका Zendesk सबडोमेन आपके Zendesk URL का पहला हिस्सा है (जैसे `mycompany.zendesk.com` में `mycompany`)। #### ElevenLabs में कनेक्ट करें ElevenLabs इंटीग्रेशन सेटअप में अपना **email**, **API token** और **subdomain** दर्ज करें। #### कस्टम OAuth क्लाइंट #### रीडायरेक्ट URL कॉपी करें ElevenLabs Zendesk इंटीग्रेशन सेटअप में **redirect URL** कॉपी करें। #### Zendesk में OAuth क्लाइंट बनाएं [Zendesk Admin Center](https://support.zendesk.com/hc/en-us/articles/4581766374554-Using-Admin-Center) में **Apps and integrations > APIs > OAuth clients** पर जाएं और **Add Client** पर क्लिक करें। एक **name** और यूनीक **identifier** दर्ज करें। #### रीडायरेक्ट URL जोड़ें ElevenLabs से कॉपी किया हुआ **redirect URL** OAuth क्लाइंट कॉन्फ़िगरेशन में पेस्ट करें। #### सीक्रेट सेव करें OAuth क्लाइंट सेव करें। Zendesk एक **secret** दिखाता है — इसे कॉपी करके सुरक्षित रूप से स्टोर करें। डायलॉग बंद करने के बाद यह दोबारा नहीं दिखेगा। #### ElevenLabs में कनेक्ट करें ElevenLabs इंटीग्रेशन सेटअप में क्लाइंट ID के रूप में **identifier** दर्ज करें और **secret** दें। Zendesk आपको कनेक्शन अधिकृत करने के लिए रीडायरेक्ट करेगा। ## OAuth स्कोप्स **OAuth2** क्रेडेंशियल से कनेक्ट करने पर ElevenLabs को ये [Zendesk OAuth स्कोप्स](https://developer.zendesk.com/api-reference/ticketing/oauth/grant_type_tokens/) मिलते हैं। रीड एक्सेस पूरे अकाउंट के लिए दिया जाता है, जबकि राइट एक्सेस हर रिसोर्स के लिए अलग से मांगा जाता है, ताकि टोकन उन रिसोर्सेज़ को संशोधित न कर सके जिनका इंटीग्रेशन उपयोग नहीं करता। | स्कोप | उद्देश्य | | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `read` | GET एंडपॉइंट्स का रीड एक्सेस। इसका इस्तेमाल टिकट्स, टिकट कमेंट्स और उनके अटैचमेंट्स, यूज़र्स, ऑर्गनाइज़ेशन्स, प्रॉब्लम टिकट्स और सर्च रिज़ल्ट्स पाने के लिए होता है और — जब ट्रिगर कनेक्ट हो — Zendesk ट्रिगर देखने और ElevenLabs द्वारा बनाए गए वेबहुक का साइनिंग सीक्रेट पढ़ने के लिए भी होता है। | | `tickets:write` | टिकट्स बनाएं, अपडेट करें, डिलीट करें और मर्ज करें, पब्लिक और इंटरनल कमेंट्स पोस्ट करें, और टैग्स जोड़ें या हटाएं। इसका इस्तेमाल टिकट टूल्स और Zendesk ट्रिगर चलने पर एजेंट का जवाब पोस्ट करने के लिए होता है। | | `users:write` | बल्क क्रिएट-या-अपडेट समेत यूज़र्स बनाएं, अपडेट करें और डिलीट करें। इसका इस्तेमाल यूज़र मैनेजमेंट टूल्स करते हैं। | | `webhooks:write` | Zendesk ट्रिगर एक्टिवेट करने पर आपके एजेंट तक टिकट इवेंट्स पहुंचाने वाला वेबहुक बनाएं और ट्रिगर डीऐक्टिवेट करने पर उस वेबहुक को डिलीट करें। | | `triggers:write` | आपके नाम वाले Zendesk ट्रिगर में ElevenLabs वेबहुक ऐक्शन जोड़ें और ट्रिगर डीऐक्टिवेट करने पर वह ऐक्शन हटा दें। | टोकन कभी भी उसे अधिकृत करने वाले यूज़र की परमिशन्स से ज़्यादा नहीं होता — प्रभावी एक्सेस इन स्कोप्स और उस यूज़र के Zendesk रोल का इंटरसेक्शन होता है। ये स्कोप्स बाकी दो ऑथेंटिकेशन मेथड्स पर लागू नहीं होते: कस्टम OAuth क्लाइंट `read` और `write` (पूरा रीड और राइट एक्सेस) मांगता है, और API टोकन के पास उस Zendesk यूज़र की सभी परमिशन्स होती हैं जिससे वह जुड़ा है। ## डेटा प्रकटीकरण नीचे दी गई तालिका में वे सभी फ़ील्ड दिए गए हैं जिन्हें इंटीग्रेशन आपके Zendesk अकाउंट में एक्सेस करता है, ElevenLabs उन्हें स्टोर करता है या नहीं, और उन्हें कब व क्यों एक्सेस किया जाता है। **पढ़ा गया** का मतलब है कि वैल्यू का इस्तेमाल प्रोसेसिंग के दौरान होता है, लेकिन उसे सेव नहीं किया जाता। **पढ़ा गया और स्टोर किया गया** का मतलब है कि उसे ElevenLabs के बातचीत रिकॉर्ड में सेव किया जाता है। **लिखा गया** का मतलब है कि इंटीग्रेशन उसे Zendesk को भेजता है। | डेटा | एक्सेस | कारण | | --------------------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | टिकट ID | पढ़ा गया और स्टोर किया गया | ट्रिगर वेबहुक पेलोड में आता है — Zendesk द्वारा ElevenLabs को भेजा जाने वाला यही एकमात्र टिकट डेटा है। बातचीत के external ID के रूप में, `integration__zendesk_ticket_id` डायनामिक वेरिएबल के रूप में और टिकट पर वापस जाने वाले लिंक के रूप में स्टोर किया जाता है। | | टिकट का विषय | पढ़ा गया और स्टोर किया गया | ट्रिगर चलने पर टिकट से पढ़ा जाता है। `integration__zendesk_ticket_subject` डायनामिक वेरिएबल के रूप में स्टोर किया जाता है, ताकि सिस्टम प्रॉम्प्ट और टूल्स टिकट के विषय को रेफर कर सकें। | | टिकट बनाने का टाइमस्टैम्प | पढ़ा गया और स्टोर किया गया | टिकट के साथ पढ़ा जाता है। प्रॉम्प्ट में इस्तेमाल के लिए `integration__zendesk_ticket_created_at` डायनामिक वेरिएबल के रूप में स्टोर किया जाता है, जैसे टिकट की उम्र समझने के लिए। | | अनुरोधकर्ता ID | पढ़ा गया और स्टोर किया गया | टिकट के साथ पढ़ा जाता है। `integration__zendesk_ticket_requester_id` डायनामिक वेरिएबल के रूप में स्टोर किया जाता है और टिप्पणियों का श्रेय देने के लिए इस्तेमाल होता है — अनुरोधकर्ता अगर स्टाफ सदस्य भी हो, तो भी उसे ग्राहक माना जाता है। | | टिकट टैग्स | पढ़ा गया | हर ट्रिगर रन पर `agent-rating-` टैग और `force-agent` टैग का पता लगाने के लिए पढ़ा जाता है। बातचीत में सिर्फ़ मिलने वाली रेटिंग स्टोर होती है; टैग सूची खुद सेव नहीं होती। | | सार्वजनिक और आंतरिक टिप्पणी का मुख्य भाग | पढ़ा गया और स्टोर किया गया | हर ट्रिगर रन पर टिकट की टिप्पणियों से पढ़ा जाता है। बातचीत के ट्रांसक्रिप्ट के रूप में स्टोर किया जाता है और एजेंट के LLM को भेजा जाता है — एजेंट इसी बातचीत का जवाब देता है। | | टिप्पणी IDs | पढ़ा गया और स्टोर किया गया | टिप्पणियों के साथ पढ़े जाते हैं। सबसे हाल का ID अंतिम-प्रोसेस किए गए मार्कर के रूप में स्टोर होता है, ताकि अगला ट्रिगर रन उन टिप्पणियों को छोड़ दे जिनका एजेंट पहले ही जवाब दे चुका है। | | टिप्पणी लेखक ID | पढ़ा गया और स्टोर किया गया | टिप्पणियों के साथ पढ़ा जाता है और लेखक को ढूंढने के लिए इस्तेमाल होता है। जब लेखक का कोई ईमेल पता नहीं होता, तो ट्रांसक्रिप्ट संदेश के यूज़र आइडेंटिफ़ायर के रूप में स्टोर किया जाता है। | | टिप्पणी लेखक की भूमिका | पढ़ा गया | हर टिप्पणी लेखक के लिए यह तय करने हेतु पढ़ा जाता है कि टिप्पणी ट्रांसक्रिप्ट में ग्राहक संदेश बनेगी या स्टाफ संदेश। भूमिका खुद सेव नहीं होती, सिर्फ़ हर संदेश का परिणामी श्रेय स्टोर होता है। | | टिप्पणी लेखक का ईमेल पता | पढ़ा गया और स्टोर किया गया | हर टिप्पणी लेखक के लिए पढ़ा जाता है। ग्राहक को श्रेय दिए गए ट्रांसक्रिप्ट संदेशों पर यूज़र आइडेंटिफ़ायर के रूप में स्टोर किया जाता है, ताकि टिकट्स के बीच बातचीत को किसी व्यक्ति से जोड़ा जा सके। | | अनुरोधकर्ता का ईमेल पता | पढ़ा गया और स्टोर किया गया | अनुरोधकर्ता के यूज़र रिकॉर्ड के साथ पढ़ा जाता है। `integration__zendesk_ticket_requester_email` डायनामिक वेरिएबल के रूप में स्टोर किया जाता है, ताकि प्रॉम्प्ट और टूल्स ग्राहक को संबोधित या खोज सकें। | | अटैचमेंट मेटाडेटा: फ़ाइलनाम, MIME टाइप, आकार | पढ़ा गया और स्टोर किया गया | टिप्पणियों के साथ यह जांचने के लिए पढ़ा जाता है कि अटैचमेंट समर्थित टाइप का है और आकार सीमा के भीतर है। जिस ट्रांसक्रिप्ट संदेश से अटैचमेंट जुड़ा है, उस पर स्टोर किया जाता है। | | अटैचमेंट फ़ाइल की सामग्री | पढ़ा गया और स्टोर किया गया | केवल तब डाउनलोड की जाती है, जब एजेंट पर **फ़ाइल अटैचमेंट की अनुमति दें** सक्षम हो और उसका LLM फ़ाइल टाइप को सपोर्ट करता हो। बातचीत फ़ाइलों के रूप में स्टोर की जाती है, ताकि एजेंट ग्राहक द्वारा भेजी गई सामग्री पढ़ सके। | | Zendesk सबडोमेन | पढ़ा गया और स्टोर किया गया | कनेक्ट करते समय आप देते हैं। इंटीग्रेशन की कनेक्शन सेटिंग्स में स्टोर किया जाता है, क्योंकि इससे API बेस URL बनता है। | | Zendesk अकाउंट ईमेल, केवल API टोकन ऑथेंटिकेशन | पढ़ा गया और स्टोर किया गया | कनेक्ट करते समय आप देते हैं। कनेक्शन सेटिंग्स में स्टोर किया जाता है, क्योंकि API टोकन ऑथेंटिकेशन टोकन के साथ अकाउंट ईमेल भेजता है। | | API टोकन, OAuth एक्सेस और रीफ़्रेश टोकन | पढ़ा गया और स्टोर किया गया | सेव किए जाने पर एन्क्रिप्ट रहते हैं और केवल API कॉल्स को ऑथेंटिकेट करने के लिए इस्तेमाल होते हैं। एजेंट, प्रॉम्प्ट या API को कभी एक्सपोज़ नहीं किए जाते। | | वेबहुक साइनिंग सीक्रेट | पढ़ा गया और स्टोर किया गया | ट्रिगर सक्रिय करने पर एक बार पढ़ा जाता है। एन्क्रिप्ट करके स्टोर किया जाता है और यह पुष्टि करने के लिए इस्तेमाल होता है कि इनबाउंड वेबहुक वास्तव में आपके Zendesk अकाउंट से आए हैं। | | ट्रिगर शीर्षक, शर्तें और कार्रवाइयाँ | पढ़ा गया | ट्रिगर सक्रिय करने पर नाम से ट्रिगर ढूंढने और ElevenLabs वेबहुक कार्रवाई जोड़ने के दौरान उसकी मौजूदा कार्रवाइयों को बनाए रखने के लिए पढ़ा जाता है। सेव नहीं किया जाता। | | एजेंट का जवाब | लिखा गया | टिकट पर सार्वजनिक टिप्पणी के रूप में पोस्ट किया जाता है या शैडो मोड चालू होने पर आंतरिक टिप्पणी के रूप में। यही इंटीग्रेशन का उद्देश्य है। | | बातचीत का लिंक | लिखा गया | हर टिकट पर एक बार आंतरिक टिप्पणी के रूप में पोस्ट किया जाता है, ताकि स्टाफ ElevenLabs में बातचीत खोल सके। | | अटैचमेंट त्रुटि सूचना | लिखा गया | जब किसी अटैचमेंट को असमर्थित टाइप, बहुत बड़ा होने या डाउनलोड न हो पाने के कारण छोड़ा जाता है, तब आंतरिक टिप्पणी के रूप में पोस्ट किया जाता है, ताकि स्टाफ जान सके कि एजेंट ने उसे नहीं देखा। | | ElevenLabs वेबहुक रजिस्ट्रेशन | लिखा गया | Zendesk ट्रिगर सक्रिय करने पर बनाया जाता है और निष्क्रिय करने पर हटा दिया जाता है। यह वह एंडपॉइंट है जिसे Zendesk टिकट इवेंट्स पर कॉल करता है। | | आपके ट्रिगर पर वेबहुक कार्रवाई | लिखा गया | सक्रिय करने पर आपके नाम वाले ट्रिगर में जोड़ी जाती है और निष्क्रिय करने पर हटा दी जाती है। ट्रिगर पर मौजूद कार्रवाइयाँ बनी रहती हैं। | | टिकट्स, टिप्पणियाँ, टैग्स, यूज़र्स और संगठन | लिखा गया | केवल एजेंट पर आपके द्वारा सक्षम किए गए Zendesk टूल्स द्वारा लिखा जाता है, बातचीत के दौरान एजेंट द्वारा दिए गए पैरामीटर्स के साथ। टूल कॉल या ट्रिगर जवाब के बाहर कोई राइट नहीं होता। | इंटीग्रेशन Zendesk API को केवल कनेक्टेड ट्रिगर चलने पर या एजेंट द्वारा Zendesk टूल इस्तेमाल करने पर कॉल करता है। यह आपके Zendesk अकाउंट को पोल नहीं करता और न ही बड़े पैमाने पर डेटा एक्सपोर्ट करता है। Zendesk टूल्स से लौटाए गए रिकॉर्ड्स को टूल कॉल परिणाम के हिस्से के रूप में बातचीत ट्रांसक्रिप्ट में स्टोर किया जाता है, इसलिए किसी रिकॉर्ड को पढ़ने वाला टूल उसे स्टोर भी करता है। स्टोर किए गए डेटा का रिटेंशन उस एजेंट की प्राइवेसी सेटिंग्स के अनुसार होता है जिसने टिकट संभाला था, जिसमें ट्रांसक्रिप्ट और PII डिलीशन शामिल है। ## Zendesk टूल्स बातचीत के दौरान टिकट, यूज़र और संगठनों को मैनेज करने के लिए अपने एजेंट में Zendesk टूल्स जोड़ें। इंटीग्रेशन कनेक्ट होने के बाद, आप एजेंट के कॉन्फ़िगरेशन पेज पर अलग-अलग टूल्स सक्षम कर सकते हैं। ### उपलब्ध टूल्स इंटीग्रेशन में निम्न श्रेणियों में व्यवस्थित 30 से ज़्यादा टूल्स शामिल हैं: * **टिकट** — टिकट बनाएं, अपडेट करें, हटाएं, सूचीबद्ध करें और खोजें। बल्क ऑपरेशन (एक साथ कई बनाना, अपडेट करना, हटाना) भी उपलब्ध हैं। * **कमेंट और टैग** — टिकट में सार्वजनिक या आंतरिक कमेंट जोड़ें, और टैग जोड़ें या हटाएं। * **यूज़र** — यूज़र खोजें, बनाएं, अपडेट करें और हटाएं। यूज़र डेटा सिंक करने के लिए बल्क create-or-update समर्थित है। * **संगठन** — संगठन की जानकारी पाएं और उसके टिकट सूचीबद्ध करें। * **खोज** — टिकट, यूज़र और संगठनों में Zendesk खोज क्वेरी चलाएं (जैसे, `type:ticket status:open`)। ### उदाहरण टूल्स #### zendesk_create_ticket नया सपोर्ट टिकट बनाता है। एजेंट कॉलर से जानकारी लेता है और उनकी ओर से टिकट खोलता है। | पैरामीटर | टाइप | विवरण | | ------------------------ | ------- | ------------------------------------------------------- | | `ticket.subject` | string | टिकट के लिए छोटा विषय | | `ticket.comment.body` | string | समस्या का विस्तृत विवरण | | `ticket.requester.email` | string | अनुरोधकर्ता का ईमेल पता | | `ticket.requester.name` | string | अनुरोधकर्ता का पूरा नाम | | `ticket.priority` | string | `urgent`, `high`, `normal`, या `low` | | `ticket.status` | string | `new`, `open`, `pending`, `hold`, `solved`, या `closed` | | `ticket.assignee_id` | integer | टिकट असाइन करने के लिए एजेंट ID | | `ticket.group_id` | integer | टिकट रूट करने के लिए ग्रुप ID | | `ticket.custom_fields` | array | कस्टम फ़ील्ड के लिए `{id, value}` ऑब्जेक्ट्स की ऐरे | #### zendesk_search Zendesk खोज क्वेरी सिंटैक्स का इस्तेमाल करके टिकट, यूज़र या संगठन खोजता है। | पैरामीटर | टाइप | विवरण | | -------- | ------ | ---------------------------------------------------------------------------------- | | `query` | string | खोज क्वेरी (जैसे, `type:ticket status:open` या `type:user email:user@example.com`) | #### zendesk_add_comment किसी मौजूदा टिकट में सार्वजनिक या आंतरिक कमेंट जोड़ता है — कॉल सारांश या फॉलो-अप नोट पोस्ट करने के लिए उपयोगी। | पैरामीटर | टाइप | विवरण | | -------------------------- | ------- | ----------------------------------- | | `ticket_id` | integer | वह टिकट जिस पर कमेंट करना है | | `ticket.comment.body` | string | सादा टेक्स्ट में कमेंट का टेक्स्ट | | `ticket.comment.html_body` | string | कमेंट का HTML संस्करण (वैकल्पिक) | | `ticket.comment.public` | boolean | कमेंट अनुरोधकर्ता को दिखेगा या नहीं | #### zendesk_get_user यूज़र की प्रोफ़ाइल पाता है, ताकि एजेंट कॉलर को नाम से संबोधित कर सके या उनकी पहचान सत्यापित कर सके। | पैरामीटर | टाइप | विवरण | | --------- | ------- | ----------------------------- | | `user_id` | integer | खोजने के लिए Zendesk यूज़र ID | ### टूल्स कॉन्फ़िगर करना #### इंटीग्रेशन टूल जोड़ें अपने एजेंट के कॉन्फ़िगरेशन पेज पर **टूल जोड़ें** पर क्लिक करें और **इंटीग्रेशन टूल जोड़ें** चुनें। ![इंटीग्रेशन टूल जोड़ें](/docs/_fern-img/ef3a82e0747f1b1da18fb6b4755812abe161d436582312e47836e621a44d83c7.webp) #### Zendesk टूल्स चुनें अपना Zendesk कनेक्शन चुनें और वे टूल्स टॉगल करें जिन्हें आप एजेंट से इस्तेमाल करवाना चाहते हैं। आप ज़रूरत के मुताबिक कम या ज़्यादा टूल्स सक्षम कर सकते हैं — उदाहरण के लिए, केवल पढ़ने वाला ट्रायेज एजेंट सिर्फ़ खोज और सूची टूल्स इस्तेमाल कर सकता है, जबकि फुल-सर्विस एजेंट टिकट बना और अपडेट भी कर सकता है। ![Zendesk टूल्स चुनें](/docs/_fern-img/9161ae75a4c514d477174622bd4857d6faf62a11825bc7d4d191176e52a72f91.webp) #### (वैकल्पिक) पैरामीटर दें हर टूल के पैरामीटर, कॉलर की बात के आधार पर, बातचीत के दौरान एजेंट भरता है। आपको पैरामीटर वैल्यू हार्ड-कोड करने की ज़रूरत नहीं है। हालांकि, एजेंट के व्यवहार को दिशा देने के लिए आप कुछ पैरामीटर पहले से भर सकते हैं या सीमित कर सकते हैं — जैसे, डिफ़ॉल्ट `priority` या `group_id` सेट करना। #### पुराना वेबहुक सेटअप > **Note** > > अगर आप नेटिव Zendesk इंटीग्रेशन इस्तेमाल करते हैं, तो टूल्स अपने आप कॉन्फ़िगर हो जाते हैं। नीचे दिए गए चरण > सिर्फ़ मैन्युअल वेबहुक सेटअप पर लागू होते हैं। पुराना इंटीग्रेशन सपोर्ट एजेंट बनाने के लिए तीन वेबहुक टूल्स का इस्तेमाल करता है। नीचे दिए गए टैब में हर टूल का कॉन्फ़िगरेशन देखें। #### zendesk_get_ticket_comments **नाम:** zendesk_get_ticket_comments **विवरण:** टिकट के कमेंट पाता है। **मेथड:** GET **URL:** `https://acmecorp.zendesk.com/api/v2/tickets/{ticket_id}/comments.json` **हेडर:** * **Content-Type:** `application/json` * **Authorization:** *(सीक्रेट: `zendesk_key`)* **पाथ पैरामीटर:** * **ticket_id:** get_resolved_tickets के नतीजों में `id` फ़ील्ड से वैल्यू निकालें। **टूल JSON:** ```json { "type": "webhook", "name": "zendesk_get_ticket_comments", "description": "Retrieves the comments of a ticket.", "api_schema": { "url": "https://acmecorp.zendesk.com/api/v2/tickets/{ticket_id}/comments.json", "method": "GET", "path_params_schema": [ { "id": "ticket_id", "type": "string", "description": "Extract the value from the id field in the get_resolved_tickets results.", "dynamic_variable": "", "constant_value": "", "required": false, "value_type": "llm_prompt" } ], "query_params_schema": [], "request_body_schema": null, "request_headers": [ { "type": "secret", "name": "Authorization", "secret_id": "zendesk_api_token" }, { "type": "value", "name": "Content-Type", "value": "application/json" } ] }, "response_timeout_secs": 20, "dynamic_variables": { "dynamic_variable_placeholders": {} } } ``` #### zendesk_get_resolved_tickets **नाम:** zendesk_get_resolved_tickets **विवरण:** Zendesk से सभी हल किए गए सपोर्ट टिकट पाता है। **मेथड:** GET **URL:** `https://acmecorp.zendesk.com/api/v2/search.json?query=type:ticket+status:solved` **हेडर:** * **Content-Type:** `application/json` * **Authorization:** *(सीक्रेट: `zendesk_key`)* **टूल JSON:** ```json { "type": "webhook", "name": "zendesk_get_resolved_tickets", "description": "Retrieves all resolved support tickets from Zendesk.", "api_schema": { "url": "https://acmecorp.zendesk.com/api/v2/search.json?query=type:ticket+status:solved", "method": "GET", "path_params_schema": [], "query_params_schema": [], "request_body_schema": null, "request_headers": [ { "type": "secret", "name": "Authorization", "secret_id": "zendesk_api_token" }, { "type": "value", "name": "Content-Type", "value": "application/json" } ] }, "response_timeout_secs": 20, "dynamic_variables": { "dynamic_variable_placeholders": {} } } ``` #### zendesk_open_ticket **नाम:** zendesk_open_ticket **विवरण:** नया सपोर्ट टिकट खोलता है। **मेथड:** POST **URL:** `https://acmecorp.zendesk.com/api/v2/tickets.json` **हेडर:** * **Content-Type:** `application/json` * **Authorization:** *(सीक्रेट: `zendesk_key`)* **बॉडी पैरामीटर:** * **ticket:** इसमें शामिल एक ऑब्जेक्ट: * **comment:** * **body:** सपोर्ट समस्या का विस्तृत विवरण। * **subject:** एक छोटा विषय। * **requester:** * **name:** अनुरोधकर्ता का पूरा नाम। * **email:** एक मान्य ईमेल पता। **टूल JSON:** ```json { "type": "webhook", "name": "zendesk_open_ticket", "description": "API endpoint to open a customer support ticket\nMake sure the authorization header is formated as \"Authorization: Basic \".", "api_schema": { "url": "https://acmecorp.zendesk.com/api/v2/tickets.json", "method": "POST", "path_params_schema": [], "query_params_schema": [], "request_body_schema": { "id": "body", "type": "object", "description": "Details for the support ticket", "required": false, "properties": [ { "id": "ticket", "type": "object", "description": "This is the main ticket body which contains all of the information needed to open a ticket.", "required": true, "properties": [ { "id": "comment", "type": "object", "description": "This is the comment with information about the issue.", "required": true, "properties": [ { "id": "body", "type": "string", "description": "Body of the issue. Include all relevant details for the issue. ", "dynamic_variable": "", "constant_value": "", "required": true, "value_type": "llm_prompt" } ] }, { "id": "subject", "type": "string", "description": "Create a short subject line for the support issue. Add \"DEMO: \" before the subject.", "dynamic_variable": "", "constant_value": "", "required": true, "value_type": "llm_prompt" }, { "id": "requester", "type": "object", "description": "The details of the support requester", "required": true, "properties": [ { "id": "email", "type": "string", "description": "The email address of the requester. This should look like \njohnsmith@hotmail.com\nYou MUST use the @ symbol and remove any spaces.", "dynamic_variable": "", "constant_value": "", "required": true, "value_type": "llm_prompt" }, { "id": "name", "type": "string", "description": "The full name of the requester. ", "dynamic_variable": "", "constant_value": "", "required": true, "value_type": "llm_prompt" } ] } ] } ] }, "request_headers": [ { "type": "secret", "name": "Authorization", "secret_id": "zendesk_api_token" }, { "type": "value", "name": "Content-Type", "value": "application/json" } ] }, "response_timeout_secs": 20, "dynamic_variables": { "dynamic_variable_placeholders": {} } } ``` > **Warning** > > पक्का करें कि आपने अपने वर्कस्पेस का Zendesk सीक्रेट एजेंट के सीक्रेट्स में जोड़ा है। ## Zendesk ट्रिगर्स आने वाले टिकट कमेंट्स को मॉनिटर करने और उन पर प्रतिक्रिया देने के लिए Zendesk ट्रिगर्स कॉन्फ़िगर करें, ताकि आपका एजेंट शुरुआती स्तर का सपोर्ट दे सके। ### सेटअप #### Zendesk में ट्रिगर बनाएं Zendesk Admin Center में **Objects and rules > Business rules > Triggers** पर जाएं और **Add trigger** पर क्लिक करें। वे शर्तें कॉन्फ़िगर करें जो तय करती हैं कि एजेंट को किन टिकट इवेंट्स पर प्रतिक्रिया देनी चाहिए (जैसे, किसी खास ग्रुप में नए टिकट या किसी खास टैग वाले टिकट कमेंट्स)। ट्रिगर का नाम नोट कर लें — अगले चरण में इसकी ज़रूरत होगी। अगर किसी ऐक्शन के न होने से आप ट्रिगर सेव नहीं कर पा रहे हैं, तो टिकट में "agent is processing" टैग जोड़ने जैसा सरल ऐक्शन जोड़ें। #### ElevenLabs में ट्रिगर कनेक्ट करें अपने एजेंट के कॉन्फ़िगरेशन पेज पर नया ट्रिगर जोड़ें और **Zendesk Trigger** चुनें। फ़ील्ड कॉन्फ़िगर करें: * **एजेंट**: आने वाली बातचीत संभालने वाला एजेंट। * **ट्रिगर नियम का नाम**: पिछले चरण में बनाए गए Zendesk ट्रिगर का नाम। * **दैनिक टिकट सीमा** (वैकल्पिक): एजेंट रोज़ जितने टिकट संभाल सकता है उनकी अधिकतम संख्या। असीमित के लिए खाली छोड़ दें। ट्रिगर सक्रिय करने पर ElevenLabs आपके Zendesk अकाउंट में वेबहुक बनाता है और इसे आपके बताए ट्रिगर में ऐक्शन के रूप में जोड़ता है। ट्रिगर निष्क्रिय करने पर वेबहुक और ऐक्शन हट जाते हैं। #### (वैकल्पिक) Zendesk में अपना ट्रिगर जांचें Zendesk Admin Center में **Objects and rules > Business rules > Triggers** पर जाएं और अपना पहले बनाया हुआ ट्रिगर देखें। उसमें नया ऐक्शन जुड़ा दिखेगा। अगर आपने पहले कोई और ऐक्शन बनाया था, तो अब उसे फिर से हटा सकते हैं। ### शैडो मोड एजेंट को ग्राहकों को सीधे जवाब दिए बिना जवाबों का निरीक्षण और ड्राफ़्ट करने देने के लिए Zendesk ट्रिगर पर शैडो मोड सक्षम करें। शैडो मोड सक्रिय होने पर, एजेंट सार्वजनिक जवाबों की जगह टिकट पर **आंतरिक कमेंट्स** के रूप में जवाब लिखता है। आंतरिक कमेंट्स सिर्फ़ Zendesk एजेंट और एडमिन देख सकते हैं — एंड यूज़र को सूचना नहीं मिलती। > **Warning** > > शैडो मोड सिर्फ़ इस बात को प्रभावित करता है कि एजेंट अपने जवाब कैसे पोस्ट करता है। अगर एजेंट ऐसे टूल्स इस्तेमाल करता है जो > टिकट में बदलाव करते हैं (जैसे, स्टेटस बदलना, टैग जोड़ना या टिकट असाइन करना), तो वे बदलाव फिर भी > लागू होंगे। अनचाहे बदलाव रोकने के लिए, एजेंट की एक अलग ब्रांच इस्तेमाल करें जिसमें बदलाव करने वाले टूल > कॉल्स हटा दिए गए हों। लाइव होने से पहले एजेंट की गुणवत्ता जांचने के लिए शैडो मोड उपयोगी है। सटीकता और टोन की तुलना करने के लिए वास्तविक सपोर्ट जवाबों के साथ आंतरिक कमेंट्स की समीक्षा करें, फिर एजेंट के आउटपुट पर भरोसा होने पर उसे सक्रिय मोड में प्रमोट करें। ### लूप से बचना जब एजेंट Zendesk API के ज़रिए टिकट कमेंट का जवाब देता है, तो वह जवाब खुद एक नया कमेंट होता है — जो एजेंट को फिर से ट्रिगर कर सकता है और अनंत लूप बना सकता है। इसे रोकने के लिए अपने Zendesk ट्रिगर में नीचे दी गई किसी एक शर्त को जोड़ें। **ट्रिगर से सर्विस अकाउंट को बाहर रखें।** इंटीग्रेशन के लिए अलग Zendesk यूज़र बनाएं (जैसे, `ai-agent@yourcompany.com`) और ElevenLabs में कनेक्ट करते समय इस अकाउंट के क्रेडेंशियल्स का इस्तेमाल करें। फिर अपने Zendesk ट्रिगर में यह शर्त जोड़ें: * **Current User**, **Is Not**, **\<आपका सर्विस अकाउंट>** **ट्रिगर से API अपडेट्स को बाहर रखें।** यह Zendesk API से किए गए सभी अपडेट्स को फ़िल्टर कर देता है, भले ही उन्हें किसी भी यूज़र ने किया हो: * **Ticket > Update Via**, **Is Not**, **Web Service (API)** ## उपयोगी लिंक * [Zendesk API दस्तावेज़](https://developer.zendesk.com/api-reference/) * [API टोकन मैनेज करना](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API) * [Zendesk ट्रिगर्स गाइड](https://support.zendesk.com/hc/en-us/articles/203662246-About-triggers-and-how-they-work)