# العمل في تطبيقات المراسلة

## التحقق من اشتراك إنستغرام

check\_insta\_subscription()

<details>

<summary>الوصف</summary>

<mark style="background-color:blue;">**للتحقق من الاشتراك في حساب إنستغرام**</mark>

**check\_insta\_subscription()**

المعلمات: لا شيء

تُرجع الدالة قيمة منطقية **True** إذا كان المستخدم مشتركًا في الحساب، **خطأ** وإلا.

</details>

<details>

<summary>أمثلة</summary>

<figure><img src="/files/e9ff99aa834f14c7d257eed4997212f218f5da69" alt="" width="375"><figcaption></figcaption></figure>

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

`r=check_insta_subscription()`

</details>

## العمل مع واتساب&#x20;

check\_whatsapp() | get\_whatsapp\_bot\_id\_by\_phone()

<details>

<summary>الوصف</summary>

{% hint style="warning" %}
تعمل هذه الدوال إذا كان روبوت واتساب متصلًا بمشروع.
{% endhint %}

<mark style="background-color:blue;">**للتحقق مما إذا كان رقم الهاتف لديه واتساب**</mark>

**check\_whatsapp(phone\_number)**\
طريقة للتحقق مما إذا كان واتساب متصلًا برقم الهاتف المحدد

المعلمات:\
**phone\_number** - رقم الهاتف بصيغة 79999999999 أو 89999999999

تُرجع الدالة قيمة منطقية **True** إذا كان الرقم مسجلاً في واتساب، **خطأ** إذا لم يكن كذلك.

<mark style="background-color:blue;">**للحصول على bot\_id الخاص بواتساب عبر رقم الهاتف**</mark>

**get\_whatsapp\_bot\_id\_by\_phone(bot\_phone)**\
دالة للعثور على bot\_id الخاص بواتساب عبر رقم الهاتف

</details>

<details>

<summary>أمثلة</summary>

دعونا نتحقق مما إذا كان واتساب متصلًا برقم هاتف:

<figure><img src="/files/015f49f8f533cd7c903d57a80a2c18ce9759cc2c" alt="" width="375"><figcaption><p>مثال على استخدام الدالة check_whatsapp()</p></figcaption></figure>

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

```
rs=check_whatsapp(79999999999)
```

</details>

## إزالة الرسالة الأخيرة

last\_message\_id() | remove\_last\_message()

<details>

<summary>الوصف</summary>

**last\_message\_id()**- للحصول على رقم آخر رسالة للروبوت

{% hint style="info" %}
إذا تم إرسال صورة ونص معًا، فإن أرقام الرسائل تُفصل بشرطة سفلية (\_)
{% endhint %}

{% hint style="warning" %}
للحصول بشكل صحيح على رقم آخر رسالة للروبوت، يجب حفظ الرسالة في سجل محادثة العميل.

هذا يعني أنه في كتلة القمع، يجب تفعيل حفظ سجل الرسائل إذا تم الإرسال عبر القمع، أو عند إرسال رسالة جماعية، يجب تشغيل خيار "حفظ الرسالة في سجل المحادثة".
{% endhint %}

**remove\_last\_message()** – لحذف آخر رسالة للروبوت

{% hint style="danger" %}
يعمل فقط في تيليغرام وفيسبوك.
{% endhint %}

إذا كان **"حفظ في سجل المحادثة"** إذا كان مفتاح التبديل مفعّلًا، فيمكنك في تيليغرام وFB حذف آخر رسالة عبر إرسال جماعي من كتلة. استخدم ببساطة الدالة **remove\_last\_message()** في الحاسبة. تقوم هذه الدالة بحذف آخر رسالة أرسلها الروبوت، ولكن فقط إذا كانت تلك الرسالة محفوظة في سجل المحادثة.

</details>

<details>

<summary>مثال</summary>

مثال:

1. أنشئ كتلة إرسال جماعي:

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

{% hint style="success" %}
قم بتخصيص إعدادات الإرسال كما تريد، ثم انتقل إلى **"الإرسال"** .
{% endhint %}

&#x20;2\. فعّل خانة الاختيار **"حفظ الإرسال في سجل محادثة العميل"** في **"الإرسال"** علامة التبويب:

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

الآن، يمكنك إرسال الرسالة الجماعية.

إذا كنت تريد حذف آخر رسالة (على سبيل المثال، رسالة تحتوي على خطأ)، فيمكنك فعل ذلك في كتلة واحدة باستخدام الدالة **remove\_last\_message()**.

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

بعد ذلك، أرسل الرسالة الجماعية باستخدام الدالة لحذف آخر رسالة.

{% hint style="warning" %}
مهم! لا يمكن حذف آخر رسالة بعد مرور بعض الوقت!
{% endhint %}

مثال على الحصول على معرّف الرسالة الأخيرة.

<figure><img src="/files/c3f7b87e35517f46a94e05b844f07cebe46909ac" alt="" width="375"><figcaption></figcaption></figure>

</details>

<details>

<summary>مثال على الكود للنسخ</summary>

```
soob = last_message_id()
status = remove_last_message()
```

</details>

## إيقاف تشغيل الروبوت مؤقتًا

\| pause\_bot(minutes)

<details>

<summary>الوصف</summary>

pause\_bot(minutes) - يوقف عمل الروبوت لمدة الدقائق المحددة.

minutes - معلمة مطلوبة تمثل عدد الدقائق. يمكن تمريرها كعدد صحيح أو عدد عشري.

تعمل الدالة مثل النقر على زر **"إيقاف مؤقت"** في محادثة العميل، لكنها تتيح لك تحديد مدة إيقاف الروبوت. وتُرجع **True** عند التنفيذ الناجح.

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

</details>

## حذف الرسائل المجدولة

\| delete\_pended\_messages\_from\_list(message\_id\_list, with\_not\_delete)

<details>

<summary>الوصف</summary>

delete\_pended\_messages\_from\_list(message\_id\_list, with\_not\_delete)

تساعد الدالة على حذف رسائل محددة من الرسائل المجدولة.

<mark style="color:red;">!</mark> message\_id\_list - معلمة مطلوبة؛ قائمة بالكتل التي يجب حذف رسائلها من الرسائل المجدولة.

with\_not\_delete - معلمة اختيارية؛ تحذف الرسائل الموسومة بـ **"لا تحذف."** يمكن تمرير أي قيمة إلى هذه المعلمة.

قيمة الإرجاع **"wrong message\_id\_list"** تظهر إذا لم يتم توفير message\_id\_list أو إذا لم تكن مصفوفة.

كيفية تمرير المعلمات:

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

من أين تحصل على المعلمة المطلوبة:

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

</details>

## التحقق من حالة المشغّل

\| check\_operator\_status(email, with\_pause)

<details>

<summary>الوصف</summary>

check\_operator\_status(email, with\_pause) - يتحقق مما إذا كان المشغّل في المناوبة. يُرجع **True** إذا كان المشغّل في المناوبة، و **خطأ** وإلا.

<mark style="color:red;">**!**</mark> email - معلمة مطلوبة؛ بريد إلكتروني للموظف

with\_pause - معلمة اختيارية بقيم 1 أو 0. إذا كانت مضبوطة على 1، تُرجع الدالة نتيجة إيجابية عندما تكون حالة المشغّل إما **"في المناوبة"** أو **"في استراحة."** إذا كانت مضبوطة على 0، فإنها تُرجع نتيجة إيجابية فقط عندما تكون حالة المشغّل **"في المناوبة."**
&#x20;القيمة الافتراضية: 1.

</details>


---

# 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/functions/alaalh-alhasbh/messengers.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.