> 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.

# Freshdesk

## खास जानकारी

कस्टमर सपोर्ट workflows चलाने के लिए अपने ElevenLabs AI एजेंट्स को Freshdesk से कनेक्ट करें। इंटीग्रेशन के दो दायरे हैं:

* **Tools**: एजेंट को tickets और contacts देखने, helpdesk खोजने, replies और internal notes पोस्ट करने, और बातचीत के दौरान नए tickets बनाने दें।
* **Triggers**: एजेंट से नए tickets या मौजूदा tickets पर ग्राहक के replies का अपने-आप जवाब दिलवाएं। जवाब Freshdesk Conversations API के ज़रिए admin reply के रूप में या shadow mode चालू होने पर private note के रूप में वापस पोस्ट होते हैं।

## क्षमताएं

| क्षमता                    | सहायता                                                                                   |
| ------------------------- | ---------------------------------------------------------------------------------------- |
| Zero retention mode (ZRM) | समर्थित नहीं                                                                             |
| ट्रिगर्स में अटैचमेंट्स   | समर्थित नहीं — आने वाले tickets और replies के अटैचमेंट्स एजेंट को फ़ॉरवर्ड नहीं किए जाते |
| टूल्स में अटैचमेंट्स      | समर्थित नहीं — टूल्स सिर्फ़ टेक्स्ट पर काम करते हैं                                      |

## सेटअप

#### अपनी Freshdesk API key पाएं

Freshdesk में अपनी प्रोफ़ाइल तस्वीर (ऊपर-दाएं) पर क्लिक करें → **Profile settings**। आपकी API key change-password सेक्शन के नीचे दिखती है। इसे कॉपी करें।

#### अपना Freshdesk subdomain ढूंढें

यह आपके portal URL का `.freshdesk.com` से पहले वाला हिस्सा है। उदाहरण के लिए, अगर आपका portal `acme.freshdesk.com` है, तो आपका subdomain `acme` है।

#### ElevenLabs में कनेक्ट करें

ElevenLabs Freshdesk integration page में **Connect** पर क्लिक करें और ये जानकारी दें:

* **API Key**: चरण 1 का token।
* **Subdomain**: चरण 2 का slug।

ElevenLabs आपकी API key को username और `X` को password के रूप में इस्तेमाल करके HTTP Basic auth से ऑथेंटिकेट करता है — यह मानक Freshdesk authentication scheme है।

#### ट्रिगर चालू करें (वैकल्पिक)

अगर आप चाहते हैं कि एजेंट tickets पर ग्राहक की गतिविधि का अपने-आप जवाब दे, तो **Freshdesk Ticket Event** trigger चालू करें और चुनें:

* **Agent**: आने वाली बातचीत संभालने वाला एजेंट।
* **Responder**: वह Freshdesk एजेंट identity जिसके रूप में bot replies पोस्ट करता है।
* **Shadow Mode** (वैकल्पिक): चालू होने पर एजेंट सार्वजनिक reply भेजने के बजाय स्टाफ़ समीक्षा के लिए private note लिखता है।

ट्रिगर सक्रिय करने पर ElevenLabs आपके अकाउंट में Freshdesk automation rule बनाता है, जो ticket बनने और customer reply पर हमारे webhook को POST करता है। निष्क्रिय करने पर rule हट जाता है। Freshdesk admin में कोई मैन्युअल चरण ज़रूरी नहीं हैं।

> **Warning**
>
> **नए tickets के लिए automation rule का क्रम।** Freshdesk **Ticket Creation** automation rules को
> ऊपर से नीचे चलाता है और नए ticket से मेल खाने वाली शर्तों के केवल **पहले** rule को चलाता है — फिर
> रुक जाता है। अगर आपके पास पहले से एक या अधिक Ticket Creation rules हैं जो उन्हीं tickets से मेल खाते हैं और
> ElevenLabs rule के **ऊपर** हैं, तो हमारा rule कभी नहीं चलेगा और एजेंट नए
> tickets का जवाब नहीं देगा। ऐसा होने पर **Admin → Workflows → Automations → Ticket Creation** खोलें और
> `ElevenLabs agent …` rule को किसी भी conflicting rule के ऊपर ले जाएं। (Ticket-reply triggers में **Ticket
> Updates** category इस्तेमाल होती है, जहां सभी matching rules चलते हैं, इसलिए यह सिर्फ़ बिल्कुल नए
> tickets के जवाबों को प्रभावित करता है।)

### Shadow mode

एजेंट को ग्राहकों तक भेजे बिना जवाब ड्राफ़्ट करने देने के लिए Freshdesk trigger पर shadow mode चालू करें। Shadow mode सक्रिय होने पर एजेंट public replies के बजाय ticket पर **private notes** के रूप में अपने जवाब लिखता है। Private notes सिर्फ़ Freshdesk agents देख सकते हैं — requester को सूचना नहीं मिलती।

Freshdesk ticket-reply draft API उपलब्ध नहीं कराता। Private notes इसका समर्थित विकल्प हैं: स्टाफ़ सुझाए गए जवाब को ticket के reply editor में कॉपी करता है, ज़रूरत होने पर एडिट करता है और भेजता है।

> **Warning**
>
> Shadow mode सिर्फ़ एजेंट के जवाब पोस्ट करने के तरीके को प्रभावित करता है। अगर एजेंट ticket में बदलाव करने वाले
> tools इस्तेमाल करता है (जैसे status बदलना, tags जोड़ना या ticket assign करना), तो वे बदलाव
> फिर भी लागू होंगे। अनचाहे बदलावों को रोकने के लिए, modifying tool calls हटाकर एजेंट की अलग branch
> इस्तेमाल करें।

लाइव होने से पहले एजेंट की गुणवत्ता जांचने के लिए shadow mode उपयोगी है। सटीकता और टोन की तुलना करने के लिए असली support responses के साथ private notes की समीक्षा करें, फिर output पर भरोसा होने पर shadow mode बंद कर दें।

### CLI

> **Note**
>
> इस इंटीग्रेशन के लिए CLI documentation जल्द आ रही है।

### SDK

> **Note**
>
> इस इंटीग्रेशन के लिए SDK documentation जल्द आ रही है।

## उपयोगी लिंक

* [Freshdesk REST API reference](https://developers.freshdesk.com/api/)
* [Freshdesk search query syntax](https://developers.freshdesk.com/api/#filter_tickets)
* [webhooks के साथ Freshdesk automation rules](https://support.freshdesk.com/en/support/solutions/articles/132589-using-webhooks-in-automation-rules-that-run-on-ticket-updates)