> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/ar/messenger-channels/telegram.md).

# Telegram

وصّل Crew بـ Telegram باستخدام بوت شخصي خاص بك. يمنحك هذا مساعداً ذكياً مخصصاً لا يستخدمه سواك.

## دليل الإعداد

### الخطوة ١: أنشئ بوتاً على Telegram

1. افتح Telegram وابحث عن **@BotFather**
2. أرسل الأمر `/newbot`
3. اتبع التعليمات:
   * اختر **اسماً** لبوتك (مثل: "مساعد Crew الذكي")
   * اختر **اسم مستخدم** ينتهي بـ `bot` (مثل: `my_crew_assistant_bot`)
4. سيعطيك BotFather **رمز API** — انسخه (يبدو مثل `123456789:ABCdef...`)

### الخطوة ٢: ربط البوت بـ Crew

1. اذهب إلى **تطبيقات المراسلة** في تطبيق Crew على الويب
2. انقر **ربط** بجانب Telegram
3. الصق **رمز البوت** في الحقل
4. انقر **ربط**

سيتحقق Crew من الرمز ويُهيئ webhook البوت تلقائياً.

### الخطوة ٣: ابدأ المحادثة

1. افتح Telegram وابحث عن بوتك (ابحث عن اسم المستخدم الذي اخترته)
2. اضغط **ابدأ** أو أرسل أي رسالة
3. مساعد Crew الخاص بك أصبح حياً على Telegram!

## لماذا بوت خاص بك؟

على عكس القنوات الأخرى حيث تتحدث مع بوت Crew مشترك، يستخدم Telegram نموذج **البوت الشخصي**:

* **بوتك، علامتك التجارية**: اختر أي اسم وصورة ملف شخصي
* **خصوصية كاملة**: البوت حصري لك — لا بنية تحتية مشتركة
* **اسم مستخدم مخصص**: شارك رابط البوت مع نفسك عبر الأجهزة

## أمثلة الاستخدام

> "لخّص الرسائل غير المقروءة اليوم."

> "أنشئ تقرير PDF بهذه النقاط: \[محتواك]"

> "ما الذي يحدث في عالم التقنية اليوم؟ أعطني أهم ٥ أخبار."

> \[أرسل رسالة صوتية] "ذكّرني بالاتصال بالطبيب غداً الساعة ٣."

## المميزات

* **الرسائل النصية**: ردود غنية بتنسيق كامل
* **مشاركة الملفات**: إرسال واستقبال الصور والمستندات والملفات الصوتية
* **الرسائل الصوتية**: تفريغ نصي تلقائي للملاحظات الصوتية
* **مؤشرات الكتابة**: شاهد متى يعالج Crew طلبك
* **الرسائل الطويلة**: تُقسَّم تلقائياً إلى رسائل متعددة إذا تجاوزت حد Telegram البالغ ٤,٠٩٦ حرفاً

## استكشاف الأخطاء

### البوت لا يستجيب؟

* تأكد أنك بدأت البوت بالضغط على **ابدأ** أو إرسال `/start`
* تحقق من حالة الاتصال في صفحة تطبيقات المراسلة — يجب أن تظهر "متصل"
* جرّب قطع الاتصال وإعادة الربط بنفس الرمز

### فقدت رمز البوت؟

* اذهب إلى @BotFather على Telegram
* أرسل `/mybots`، اختر بوتك، ثم **API Token** لعرضه

## قطع الاتصال

لقطع الاتصال:

1. اذهب إلى **تطبيقات المراسلة** في تطبيق Crew على الويب
2. انقر **قطع الاتصال** بجانب Telegram

سيتوقف البوت عن الاستجابة. يمكنك إعادة الربط بنفس رمز البوت أو رمز مختلف في أي وقت.