# روبوت دردشة لحساب تيليجرام للأعمال

يمكنك الآن إنشاء **مساعدين أعمال شخصيين** — روبوتات خاصة تتكامل مباشرةً مع محادثات تيليجرام الفردية. تعالج هذه الروبوتات تلقائيًا الطلبات الواردة وترد نيابةً عن مالك الحساب، مما يقلل بشكل كبير الوقت المستغرق في المهام الروتينية ويحسن كفاءة التواصل.

**حالات الاستخدام:**\
يمكن إعداد هؤلاء المساعدين لأغراض مختلفة، مثل:

* تقديم استشارات حول المنتجات أو الخدمات.
* الإجابة عن الأسئلة المتكررة.
* تنفيذ مجموعة واسعة من المهام الآلية الأخرى.

**الميزة الرئيسية: تحكم سلس**

يمكن للمستخدم **التحول فورًا إلى التواصل اليدوي** في أي وقت دون إيقاف تشغيل الروبوت أو تعطيل عمله، مما يضمن تحكمًا كاملًا في المحادثة.

{% hint style="warning" %}
انتباه! 

يملك حساب Telegram Business نافذة مدتها 24 ساعة.

بمجرد أن يرسل المستخدم رسالته الأولى، يكون لدى الروبوت **نافذة مدتها 24 ساعة** للرد ومتابعة المحادثة. تتم إعادة ضبط هذه النافذة في كل مرة يرد فيها المستخدم.

* **إذا ردّ المستخدم:** تُعاد بدء نافذة الـ 24 ساعة، مما يسمح بحوار متواصل.
* **إذا لم يردّ المستخدم خلال 24 ساعة:** تُغلق النافذة. وسيُمنع الروبوت من إرسال المزيد من الرسائل حتى يرسل المستخدم رسالة جديدة لإعادة بدء الاتصال.
  {% endhint %}

## ربط الروبوت

الخطوة 1. الإعداد في **الرسائل** .

1.  **إذا كنت تربط روبوت تيليجرام لأول مرة.**

أولًا، انتقل إلى تبويب القنوات في قسم Mavibot لربط روبوت الدردشة الخاص بتيليجرام (إذا لم يكن موجودًا بعد).

<div data-with-frame="true"><figure><img src="/files/e8a1a1b1cbc814b16d59d6a59d857cb7fe875cb3" alt="" width="563"><figcaption></figcaption></figure></div>

بعد ذلك، نربط روبوت تيليجرام وفقًا لـ[ التعليمات](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/chatbot.md) .&#x20;

2. **إذا كان تيليجرام متصلاً**.&#x20;

في حال كان لديك بالفعل روبوت تيليجرام متصل، فابحث عن هذا الروبوت في القنوات:

<div data-with-frame="true"><figure><img src="/files/aa4d5738b4dfd53505ed8e43da61b43bf29453b6" alt="" width="563"><figcaption></figcaption></figure></div>

بعد ذلك، انقر على زر الإعدادات، وبعدها ستظهر لك نافذة منبثقة تحتوي على حقول الرمز المميز، إلخ:

<div data-with-frame="true"><figure><img src="/files/2be00804fc0aa04b882909cd445b1dba24d5dfc3" alt="" width="563"><figcaption></figcaption></figure></div>

في النافذة المنبثقة التي تفتح، انقر على DONE لتحديث إعدادات روبوت تيليجرام الخاص بك (لا تحتاج إلى تغيير أي إعدادات أخرى):

<div data-with-frame="true"><figure><img src="/files/9d3a5081dacc19acbfac731110c8ae2ca0836514" alt="" width="563"><figcaption></figcaption></figure></div>

في هذه المرحلة، يكتمل العمل مع القنوات. انتقل إلى إعدادات المراسِل.&#x20;

الخطوة 2. إعدادات المراسِل.

لربط روبوت الدردشة الخاص بتيليجرام بحسابك التجاري، انتقل إلى إعدادات ملفك الشخصي، حيث تحتاج إلى العثور على تبويب "Telegram Business":

<div data-with-frame="true"><figure><img src="/files/eef3a31c40414bfec33eaf196722d6c5aa3406fd" alt="" width="375"><figcaption></figcaption></figure></div>

بعد ذلك، سترى تبويب "Chatbots"، الذي تحتاج إلى الانتقال إليه:

<div data-with-frame="true"><figure><img src="/files/b02f0cb638a4b361aedbee54a8e7ed9324ca9115" alt="" width="375"><figcaption></figcaption></figure></div>

ثم، في التبويب الذي فُتح حديثًا، أدخل رابط روبوت تيليجرام المطلوب أو اسم المستخدم الخاص به (ويُفضَّل إدخال الرابط).

<div data-with-frame="true"><figure><img src="/files/45a1c4945ae203ec98e5b66d202ea2e338ad5c0a" alt="" width="375"><figcaption></figcaption></figure></div>

في التبويب نفسه، اضبط الإذن (خانة "Reply to messages") لتمكين روبوت الدردشة من الرد على الرسائل.

في هذه المرحلة، يكتمل إعداد روبوت الدردشة في الحساب التجاري. تابع.

الخطوة 3. إعدادات BotFather.

بعد ربط روبوت الدردشة بالحساب التجاري، تحتاج إلى تحديث إعدادات روبوت الدردشة في BotFather، حيث أنشأت روبوت تيليجرام في البداية.

للقيام بذلك، افتح الدردشة مع BotFather وفعّل العمل مع الحساب التجاري:

<div data-with-frame="true"><figure><img src="/files/3857fb6d0b7691fce756686d8751eee4b09ea656" alt="" width="375"><figcaption></figcaption></figure></div>

انتقل إلى إعدادات الروبوت:

<div data-with-frame="true"><figure><img src="/files/e2ee9940ba21f3da9ef7afc4945ae8309efd73a2" alt="" width="375"><figcaption></figcaption></figure></div>

بعد ذلك، انقر على زر "Business Mode" لتفعيل وضع الأعمال لروبوت الدردشة:

<div data-with-frame="true"><figure><img src="/files/04bbb002c67df77e970604cfd4e0514673ca05ec" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
تم! اكتملت جميع إعدادات روبوت الدردشة اللازمة مع الحساب التجاري.
{% endhint %}

الآن، في إعدادات القناة، ستجد روبوت تيليجرام وسترى معرف الأعمال وكذلك اسم مالك الحساب التجاري:

<div data-with-frame="true"><figure><img src="/files/24382177c43701fd6cd06438818abe8c6b1ba869" alt=""><figcaption></figcaption></figure></div>

### كيفية التعطيل&#x20;

لتعطيل روبوت الدردشة بوضع الأعمال، انتقل إلى القنوات وابحث عن روبوت الدردشة الذي تريد تعطيل هذا الإعداد له. انقر على زر الإعدادات:

<div data-with-frame="true"><figure><img src="/files/287f71d4b4c3694a393797f8f5ecfd678bc2265a" alt=""><figcaption></figcaption></figure></div>

انقر على زر "Disable Business Account".

<div data-with-frame="true"><figure><img src="/files/1e6ee6b37c7beeb37ea58a9d14734c7c5eae0e7e" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
إذا عطلت حساب الأعمال الخاص بك، فسيستمر روبوت الدردشة في العمل في الوضع القياسي.
{% endhint %}

## الوظائف المتاحة

1. (API) دالة في الحاسبة:

**tg\_callback(platform\_id , callback\_message,group\_id, tg\_business)**

<details>

<summary><strong>tg_callback</strong></summary>

المعلمات:

**! platform\_id** - معرّف عميل Telegram

**! callback\_message** - رسالة النداء العكسي&#x20;

**group\_id** - معرّف روبوت Telegram

**tg\_business -** للتعامل مع عملاء الأعمال، يأخذ القيمة "1".

</details>

**tg\_send\_poll(platform\_id, question, options, is\_anonymous, allows\_multiple\_answers, reply\_markup, disable\_notification, protect\_content, token, reply\_to\_message\_id, message\_thread\_id, business\_connection\_id)**

<details>

<summary><strong>tg_send_poll</strong></summary>

المعلمات:&#x20;

**! platform\_id** - معرّف الدردشة داخل Telegram [**\***](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/api.md)

**! question** - سؤال

**! options** - مصفوفة خيارات الإجابة

**is\_anonymous** - 1 - استطلاع مجهول، '' - غير مجهول

**allows\_multiple\_answers** - 1 - يُسمح بإجابات متعددة، '' - إجابة واحدة فقط

**reply\_markup** - لوحة مفاتيح، أو '' - بدون لوحة مفاتيح

**disable\_notification** — علامة للإرسال مع إشعار صوتي (الافتراضي 0)؛ 1 - إرسال بصمت، 0 - إرسال مع إشعار

**protect\_content** - 1 - الحماية من النسخ ولقطات الشاشة، '' - بدون حماية

**token** - رمز الروبوت؛ إذا لم يُقدَّم، فسيُستخدم الرمز الحالي

**reply\_to\_message\_id** - معرّف الرسالة المقتبسة

**message\_thread\_id** — معرّف الخيط (متاح في المجموعات الفائقة التي تحتوي على وظيفة المنتدى)

**business\_connection\_id -**&#x627;لقيمة المستخدمة عند ربط الروبوت (معرّف الأعمال، يظهر في القنوات)؛ يجب تمريرها إذا تم توفير رمز الروبوت ويجب إرسال الرسالة عبر حساب المستخدم المرتبط بالروبوت

</details>

**tg\_send\_quiz\_poll(platform\_id, question, options, explanation, correct\_option\_id, is\_anonymous, reply\_markup, parse\_mode, protect\_content, disable\_notification, token, reply\_to\_message\_id, message\_thread\_id )**

<details>

<summary><strong>tg_send_quiz_poll</strong></summary>

**! platform\_id** - معرّف الدردشة داخل Telegram [**\***](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/api.md)

**! question** - سؤال

**! options** - مصفوفة خيارات الإجابة

**! explanation** - نص يظهر عندما يختار المستخدم إجابة خاطئة أو ينقر على أيقونة المصباح في استطلاع بنمط اختبار؛ من 0 إلى 200 حرفًا، وبحد أقصى سطرين جديدين بعد تحليل العناصر.

**! correct\_option\_id** - رقم الإجابة الصحيحة، بدءًا من 1.

**is\_anonymous** -1 - استطلاع مجهول، '' - غير مجهول

**reply\_markup** -  لوحة مفاتيح، أو '' - بدون لوحة مفاتيح

**parse\_mode** - markdown أو html لـ *explanation*، أو '' بدون تنسيق.

**protect\_content** - 1 حماية من النسخ ولقطات الشاشة، '' - بدون حماية.

**disable\_notification** —  علامة للإرسال مع إشعار صوتي (الافتراضي 0)؛ 1 - إرسال بصمت، 0 - إرسال مع إشعار

**token** -رمز الروبوت؛ إذا لم يُقدَّم، فسيُستخدم الرمز الحالي.

**reply\_to\_message\_id** - معرّف الرسالة المقتبسة

**message\_thread\_id** —معرّف الخيط (متاح في المجموعات الفائقة التي تحتوي على وظيفة المنتدى)

**open\_period** - الوقت المسموح به لإكمال الاختبار/الاستبيان؛ قيمة رقمية من 5 إلى 600، تمثل الثواني.

**business\_connection\_id -** القيمة المستخدمة عند ربط الروبوت (معرّف الأعمال، يظهر في القنوات)؛ يجب تمريرها إذا تم توفير رمز الروبوت ويجب إرسال الرسالة عبر حساب المستخدم المرتبط بالروبوت

</details>

**tg\_send\_message\_1(token, platform\_id, text, client\_message\_id, reply\_markup, parse\_mode, disable\_web\_page\_preview, protect\_content, disable\_notification, message\_thread\_id, entities, business\_connection\_id)**

<details>

<summary><strong>tg_send_message_1</strong></summary>

المعلمات:

**! token** — رمز روبوت Telegram الذي تم الحصول عليه من BotFather

**! platform\_id** — معرّف عميل Telegram الذي يجب إرسال الرسالة إليه [**\***](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/api.md)

**! text** - نص الرسالة

**client\_message\_id** - معرّف الرسالة المقتبسة

**reply\_markup** — إعدادات الأزرار [**\*\***](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/api.md)

**parse\_mode** — وضع تنسيق النص للغامق أو المائل في وصف الرسالة [**\*\*\***](/doc/ar/chatbot/builder/telegram_messages.md)**.** القيم الممكنة: html، markdown، markdownV2

**disable\_web\_page\_preview -** ما إذا كان سيتم عرض معاينة للرابط؛ اضبطه على 1 للتعطيل، وإلا 0 أو اتركه فارغًا ("")

**protect\_content** — علامة لحماية المحتوى من النسخ؛ للتفعيل، مرّر أي قيمة غير 0 أو False أو علامتي اقتباس فارغتين ('')

**disable\_notification** —  علامة للإرسال مع إشعار صوتي (الافتراضي 0)؛ 1 - إرسال بصمت، 0 - إرسال مع إشعار

**message\_thread\_id** — معرّف الخيط (متاح في المجموعات الفائقة التي تحتوي على وظيفة المنتدى) **entities** — يتيح نسخ النص المنسق مع جميع أنماط التنسيق؛ حدّد نطاقات الأحرف لكل نمط تنسيق. يمكنك العثور على مثال في حقل tg\_request. يجب أن يحتوي المعامل على قاموس.

**business\_connection\_id -** القيمة المستخدمة عند ربط الروبوت (معرّف الأعمال، يظهر في القنوات)؛ يجب تمريرها إذا تم توفير رمز الروبوت ويجب إرسال الرسالة عبر حساب المستخدم المرتبط بالروبوت

مثال على تمرير المعامل:

`entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]`&#x20;

في المثال، يظهر القاموس فقط، بينما يتم تعريف نص الرسالة نفسه في متغير منفصل.

</details>

2. الأساليب

\- [tg\_send\_chat\_action](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-raboty-v-chatakh-i-kanalakh-telegram#tg_send_chat_action)

\- [tg\_send\_message](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-dlya-otpravki-i-redaktirovaniya-soobshenii)

\- [tg\_send\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_quiz\_poll](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram#kak-sozdat-zakryt-opros-v-chate-kanale-telegram)

\- [tg\_send\_video\_note](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_sticker](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii)

\- [tg\_send\_contact](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-kontakt-tg_send_contact)

\- [tg\_send\_venue](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-geotochku-tg_send_venue)

\- [tg\_send\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii?q=#primer-koda-dlya-kopirovaniya-6)

\- [tg\_send\_animation](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_voice](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-animaciyu-tg_send_animation)

\- [tg\_send\_media\_group](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_photo](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_video](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_document](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_some\_audio](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

\- [tg\_send\_dice ](https://docs.salebot.pro/messendzhery-i-chaty/kak-sozdat-bota-v-telegram/api-telegram-funkcii-dlya-ispolzovaniya-vsekh-vozmozhnostei-telegram/funkcii-otpravki-vlozhenii-v-soobshenii#otpravit-media-gruppu-tg_send_media_group)

تعمل تلقائيًا مع العملاء الذين كتبوا إلى حساب Telegram Business بالطريقة نفسها كما في الروبوتات.

{% hint style="info" %}
لمزيد من المعلومات حول هذه الأساليب، راجع المقال [Telegram API](/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/api.md)"
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/chatbot/ttbyqat-almraslh/tylyjram/business.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.