# تكوين منصة Telegram

اربط بوت Telegram الخاص بك بـ Pushwoosh لتشغيل Telegram كجزء من رحلاتك متعددة القنوات من مكان واحد وتتبع نتائج التسليم في تحليلات Journey.

## المتطلبات الأساسية

قبل تكوين Telegram، تأكد من استيفاء المتطلبات التالية:

* **حساب Telegram:** استخدم حساب Telegram نشطًا يمكنه الوصول إلى [@BotFather](https://t.me/BotFather).
* **بوت Telegram:** أنشئ بوت Telegram في BotFather.

## نسخ رمز API لبوت Telegram الخاص بك

للحصول على رمز API لبوت موجود:

1. في Telegram، افتح **@BotFather**.
2. أرسل `/mybots` واختر البوت الخاص بك.
3. اضغط على **API Token** وانسخ الرمز.

إذا لم يكن لديك بوت، فأنشئ واحدًا في **@BotFather** باتباع [الدليل الرسمي لـ Telegram](https://core.telegram.org/bots/features#botfather).


## إعداد تكوين Telegram في Pushwoosh

لإعداد تكوين Telegram، اتبع الخطوات التالية:

1. انتقل إلى **Settings > Configure platforms** وافتح **Telegram**.

2. إذا كان لديك بوت بالفعل، انقر فوق **Add token**. إذا لم يكن لديك، انقر فوق **Create a bot**.

عندما تنقر على **Create a bot**، يفتح Pushwoosh تعليمات لإنشاء البوت في Telegram عبر **@BotFather**. أكمل إنشاء البوت في Telegram، ثم عد إلى Pushwoosh واربط رمز البوت.

<img src="/configure-project-telegram-configuration-1.webp" alt="شاشة تكامل Telegram في Configure platforms مع Add token وتعليمات لـ BotFather."/>

3. في مربع حوار **Connect Telegram bot**، أدخل **API token** الذي نسخته من BotFather. [تعلم كيفية الحصول على الرمز](#copy-your-telegram-bot-api-token).

<img src="/configure-project-telegram-configuration-3.webp" alt="مربع حوار Connect Telegram bot مع Display name، حقل API token، Check token، Cancel، و Connect."/>


4. انقر على **Check token** للتحقق من الرمز.
<img src="/configure-project-telegram-configuration-2.webp" alt="مربع حوار Connect Telegram bot مع Display name، حقل API token، Check token، Cancel، و Connect."/>

5. انقر على **Connect** للحفظ. لتجاهل التغييرات، انقر على **Cancel**.

## إدارة رموز بوت Telegram

<Aside type="caution">

يمكن لكل مشروع استخدام رمز API لبوت Telegram **واحد** في كل مرة. لاستخدام بوت مختلف، استبدل الرمز في **Configure platforms** أو استخدم مشروعًا آخر.
إذا قمت بتغيير رمز API للبوت، فسيتم إيقاف رحلات Telegram (Journeys) النشطة مؤقتًا.
</Aside> 

### إضافة رمز جديد

1. في إعدادات **Telegram**، انقر على **Add token**.
2. في مربع حوار **Connect Telegram bot**، أدخل **API token** الجديد.
3. انقر على **Check token**.
4. انقر على **Connect**.

### حذف رمز

1. انقر على **قائمة الثلاث نقاط** بجوار رمز البوت.
2. انقر على **Delete**.

يؤدي حذف الرمز إلى إيقاف جميع رحلات Telegram النشطة مؤقتًا.

## إرسال رسائل Telegram

بعد الإعداد، يمكنك إرسال رسائل Telegram في **Customer Journey Builder**.

<LinkCard title="اعرف المزيد" href="/product/messaging-channels/telegram/send-telegram-via-customer-journey/" />