# إلغاء الاشتراك من الروبوت

## كيفية إيقاف استلام الرسائل بالكامل

على سبيل المثال، في واتساب لا يوجد خيار لحظر الرسائل، لذلك لمنع المستخدم من الضغط على زر «SPAM»، تحتاج إلى إيقاف إرسال الرسائل بناءً على طلبه.\
\
سيظهر إشعار بإلغاء الاشتراك في الدردشة مع العميل، وفي تبويب «حول العميل» ستكون هناك علامة تشير إلى أن العميل قد ألغى الاشتراك في رسائل البوت (ألغى الاشتراك): رسالة مع أيقونة على شكل علامة ×.

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

إذا كانت لدى العميل علامة تفيد بأنه ألغى الاشتراك، فلن يتم تسليم الرسائل إلى المستخدم.

<figure><img src="/files/302e368e5d5fe79f024418b07bcc5550b87b82bc" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
تنبيه!\
لا ترسل جميع تطبيقات المراسلة إشعارات عندما يلغي العميل الاشتراك في الرسائل.&#x20;
{% endhint %}

### كيفية إلغاء الاشتراك يدويًا

في البوت، يمكنك إعداد خيار يتيح للعميل إلغاء الاشتراك في الرسائل.\
لنأخذ واتساب كمثال.

أنشئ كتلة بشرط يعتمد على منطق القمع لديك. الـ **بدء** تملك الكتلة أعلى أولوية تنفيذ.

<figure><img src="/files/a95e2bc6d96b3698220ae1321522fc9dc1cb548d" alt=""><figcaption></figcaption></figure>

في **المشغّل** الحقل، اكتب جميع الكلمات المحتملة التي قد يكتبها المستخدمون لإلغاء الاشتراك من رسائل البوت، مفصولة بفواصل منقوطة. في هذه الكتلة، سنسأل العميل أيضًا مرة أخرى إن كان يريد حقًا إلغاء الاشتراك وننشئ زرين: «نعم» و«لا.

عند الدخول إلى كتلة البدء، سيحتاج العميل إلى النقر على أحد الأزرار، وستُحدَّد أسماء الأزرار في مشغّل السهم:

<figure><img src="/files/a20b0b3f0e3a4b6ff4085336ae4bba93a9f77969" alt=""><figcaption></figcaption></figure>

في الكتلة التالية، حيث يتبع السهم المشغّل «نعم، ألغِ اشتراكي»، أدخل الرسالة التي تؤكد أن العميل قد ألغى الاشتراك بنجاح:

<figure><img src="/files/290e19ed536d9ee48553b64adeb1fee0d42f8a89" alt=""><figcaption></figcaption></figure>

بعد ذلك، من الكتلة التي تحتوي على رسالة تأكيد إلغاء الاشتراك بنجاح، أنشئ كتلة أسفلها ستحتوي على وظيفة إلغاء الاشتراك:

`unsubscribe()`

{% hint style="danger" %}
انتبه!&#x20;

داخل الكتلة، تتم معالجة الإجراءات في الحاسبة أولًا، وبعد ذلك فقط يتم إرسال نص الرسالة.\
إذا أدرجت نص إلغاء الاشتراك ووظيفة إلغاء الاشتراك في الكتلة نفسها، فإن العميل سي **عدم** يتلقى الرسالة من تلك الكتلة—ولن يتم تسليمها إلى المستخدم بعد الآن.
{% endhint %}

<figure><img src="/files/e9a3e596a13ebd7039f5ea1fb1b7585c5cf3bdd3" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**انتباه!**&#x20;

سيعود العميل إلى الاشتراك في الرسائل إذا أرسل أي رسالة إلى البوت؛ وحتى ذلك الحين، لن تُرسل إليه أي رسائل..
{% endhint %}

## كيفية إلغاء الاشتراك الجزئي من المراسلات

للإلغاء الجزئي للاشتراك، تحتاج إلى تعيين متغيرات والتحقق من قيمها قبل إرسال الرسائل.

{% hint style="info" %}
عيّن المتغيرات في الكتلة باستخدام حقل الحاسبة.\
يمكنك أيضًا إنشاء متغير عميل يدويًا في تبويب «حول العميل» أثناء الدردشة، والذي يمكن استخدامه لاحقًا لاستبعاده من المراسلات.
{% endhint %}

على سبيل المثال، إذا كان لدى المستخدم المتغير `send_in_the_morning`  مضبوطًا على `no`*,* يمكنك استبعاد المستخدمين في إعدادات فلتر المراسلة بناءً على قيمة هذا المتغير:

<figure><img src="/files/b839809b583e158e05380ff391535867c85c5f30" alt=""><figcaption><p>إعداد فلتر عند إنشاء مراسلة لاستبعاد المستخدمين بناءً على قيمة متغير</p></figcaption></figure>

أيضًا، في الكتلة أو السهم المؤدي إلى كتلة المراسلة، يمكنك تحديد في حقل المتغير للمقارنة  `send_in_the_morning == "no"` *,* حتى يتلقى هذا الشخص الرسالة في المساء. يمكن دمج الشروط بطرق مختلفة.

مثال على استخدام حقل «*المتغير للمقارنة*» عند جدولة الرسائل:

<figure><img src="/files/859a38c0da8ec36b340e569e77c09eaebf0fe1a5" alt=""><figcaption></figcaption></figure>

يمكننا أن نرى أن لدى العميل المتغير `send_in_the_morning` مضبوطًا على "`no"`، وتمت جدولة رسالة له في الساعة 8:00 مساءً.

<figure><img src="/files/b83190ee8115ca8ba38acf1f4ed3f1018cb3603c" alt=""><figcaption></figcaption></figure>

## كيفية إعداد رد فعل على إلغاء الاشتراك

غالبًا ما يكون من الضروري تنفيذ إجراءات معينة في البوت بعد أن يلغي العميل الاشتراك. على سبيل المثال، إرسال معلومات إلى التحليلات، الإضافة أو الإزالة من القوائم، تطبيق الوسوم أو إزالتها، إجراء طلب إلى الخادم، وغير ذلك.\
\
ولأجل هذه الأغراض، يمكنك إعداد كتلة شرطية تتفاعل مع إشعار إلغاء اشتراك العميل. يظهر هذا الاستدعاء (الإشعار) في دردشة العميل بعد أن يلغي العميل الاشتراك في الرسائل في أحد برامج المراسلة (على سبيل المثال، «إيقاف وحظر البوت» في تيليغرام).)

<figure><img src="/files/39c1886415984b7142b7562f04fcf15854c511c7" alt="" width="375"><figcaption><p>استدعاء إلغاء اشتراك العميل</p></figcaption></figure>

في الكتلة، أدخل الاستدعاء `client_unsubscribed` في حقل «الشرط» واضبط نوع المطابقة - إلى مطابقة تامة.

<figure><img src="/files/f961aa833f4887b356bcad6c71b9d7810937866d" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
سيتم تنفيذ الإجراءات والطلبات المُعدّة في الكتلة، لكن الرسالة لن تُرسل إلى العميل، لأنه قد ألغى الاشتراك بالفعل.
{% endhint %}

{% hint style="success" %}
يعمل هذا الاستدعاء في فايبر وتيليغرام.
{% 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/alrsael-altjaryh/ilghaa-alashtrak-mn-alrwbwt.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.