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

# Telegram

## ओवरव्यू

अपने ElevenLabs AI एजेंट्स को Telegram से कनेक्ट करें, ताकि वे आपके बॉट को भेजे गए मैसेज का जवाब दे सकें। यह इंटीग्रेशन आपके एजेंट्स को प्राइवेट चैट और ग्रुप्स में आने वाले मैसेज पाने, चैट की जानकारी देखने, जवाब भेजने और Telegram Bot API के ज़रिए मैसेज पर रिएक्ट करने देता है।

## क्षमताएं

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

## सेटअप

#### Telegram बॉट बनाएं

Telegram खोलें और [@BotFather](https://t.me/BotFather) के साथ बातचीत शुरू करें। `/newbot` भेजें और अपने बॉट के लिए नाम और यूज़रनेम चुनने के प्रॉम्प्ट्स का पालन करें। BotFather आपको बॉट टोकन के साथ जवाब देगा।

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

ElevenLabs इंटीग्रेशन सेटअप में **Connect** पर क्लिक करें और BotFather से मिला बॉट टोकन पेस्ट करें।

#### ट्रिगर चालू करें

कनेक्ट करने के बाद **Telegram Message** ट्रिगर चालू करें और आने वाले मैसेज संभालने वाला एजेंट चुनें। ElevenLabs Telegram के साथ अपने-आप एक वेबहुक रजिस्टर करेगा, ताकि आपका बॉट मैसेज पाना शुरू कर दे।

## ग्रुप्स में बॉट का इस्तेमाल

बॉट का ग्रुप एडमिन होना **ज़रूरी नहीं** है और आपको Telegram का [प्राइवेसी मोड](https://core.telegram.org/bots/features#privacy-mode) बंद करने की भी **ज़रूरत नहीं** है। प्राइवेसी मोड चालू होने पर (जो डिफ़ॉल्ट है), Telegram उन मैसेज को डिलीवर करता है जिनमें बॉट को सीधे संबोधित किया गया हो। यह इंटीग्रेशन भी इन्हीं मैसेज को सुनता है:

* बॉट के यूज़रनेम के \*\*`@`-मेंशन्स \*\*, जैसे `@my_bot स्टेटस क्या है?`।
* **बॉट के अपने मैसेज के रिप्लाई**, जिसमें उसी बातचीत के फ़ॉलो-अप मैसेज भी शामिल हैं।

जो मैसेज बॉट को संबोधित नहीं करते, उन्हें डिज़ाइन के अनुसार अनदेखा किया जाता है। बॉट दूसरे बॉट्स के मैसेज को भी अनदेखा करता है और एडिट या डिलीट किए गए मैसेज पर कोई कार्रवाई नहीं करता।

> **Note**
>
> Telegram प्राइवेसी-मोड और एडमिन-रोल में बदलाव सिर्फ़ उन ग्रुप्स पर लागू करता है, जिनमें बॉट बदलाव
> के **बाद** शामिल होता है। अगर आपने पहले [@BotFather](https://t.me/BotFather) में प्राइवेसी मोड टॉगल किया था या
> मेंशन्स को "ठीक" करने के लिए बॉट को ग्रुप एडमिन बनाया था, तो बॉट को ग्रुप से हटाकर दोबारा जोड़ें, ताकि नई
> सेटिंग लागू हो सके — आमतौर पर मेंशन्स को काम करना शुरू कराने वाली चीज़ यही होती है, न कि एडमिन रोल
> खुद।

ग्रुप और सुपरग्रुप चैट में एजेंट का जवाब ट्रिगर करने वाले मैसेज के कोट-रिप्लाई के रूप में भेजा जाता है, ताकि व्यस्त चैट में भी जवाब सवाल से साफ़ तौर पर जुड़ा रहे। प्राइवेट 1:1 चैट में कोट-रिप्लाई नहीं भेजा जाता, क्योंकि वह अनावश्यक होता है।

## एजेंट टूल्स

जब आप किसी एजेंट में Telegram टूल्स जोड़ते हैं, तो ये बिल्ट-इन टूल्स उपलब्ध होते हैं:

| टूल                         | विवरण                                                                                                                                                                                                                                                                                                                                                                                              |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `telegram_get_chat`         | मौजूदा चैट का मेटाडेटा देखता है, जैसे टाइप, टाइटल, यूज़रनेम और डिस्क्रिप्शन। `chat_id` मौजूदा बातचीत से बंधा होता है और इसे किसी दूसरी चैट पर नहीं बदला जा सकता।                                                                                                                                                                                                                                   |
| `telegram_send_message`     | मौजूदा चैट में टेक्स्ट मैसेज भेजता है। `chat_id` बंधा होता है; मॉडल `text` और वैकल्पिक `parse_mode` (`HTML`, `Markdown`, या `MarkdownV2`) को नियंत्रित करता है।                                                                                                                                                                                                                                    |
| `telegram_react_to_message` | Telegram के बॉट-अनुमत [रिएक्शन सेट](https://core.telegram.org/bots/api#reactiontypeemoji) से एक ही इमोजी के साथ ट्रिगर करने वाले मैसेज पर रिएक्ट करता है — जब छोटा-सा स्वीकार (`👍`, `🎉`, `❤`) टेक्स्ट जवाब से ज़्यादा स्वाभाविक हो, तब उपयोगी है। `chat_id` और `message_id`, दोनों मूल टर्न से बंधे होते हैं। नया रिएक्शन सेट करने पर बॉट का उसी मैसेज पर पहले सेट किया गया रिएक्शन बदल जाता है। |

> **Info**
>
> कुछ चैट्स में Telegram की **Available reactions** सेटिंग से अनुमत इमोजी सीमित होते हैं। अगर
> रिएक्शन कॉल अस्वीकार हो जाए, तो एजेंट को टेक्स्ट जवाब पर वापस आने का निर्देश दें।

## डायनामिक वेरिएबल्स

जब कोई एजेंट Telegram से चलता है, तो प्रॉम्प्ट्स और टूल्स में ये डायनामिक वेरिएबल्स उपलब्ध होते हैं:

| वेरिएबल                               | विवरण                                                                         |
| ------------------------------------- | ----------------------------------------------------------------------------- |
| `integration__telegram_chat_id`       | Telegram चैट ID, जहाँ बातचीत हो रही है।                                       |
| `integration__telegram_message_id`    | उस यूज़र मैसेज की Telegram `message_id`, जिसने मौजूदा एजेंट टर्न ट्रिगर किया। |
| `integration__telegram_connection_id` | ElevenLabs इंटीग्रेशन कनेक्शन ID।                                             |

प्रॉम्प्ट्स और टूल कॉल्स में इन्हें रेफ़र करने का तरीका जानने के लिए [डायनामिक वेरिएबल्स](/docs/hi/eleven-agents/customization/personalization/dynamic-variables) देखें।

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

* [Telegram Bot API दस्तावेज़](https://core.telegram.org/bots/api)
* [प्राइवेसी मोड](https://core.telegram.org/bots/features#privacy-mode)
* [BotFather — बॉट बनाएं और मैनेज करें](https://t.me/BotFather)