# محتوى متاح مؤقتًا

{% hint style="warning" %}
**مهم التذكّر:**

* يتم إنشاء الروابط في الحاسبة؛
* كل رابط فريد لحوار محدد ولا يمكن إعادة توجيهه؛
* تعمل المتغيرات داخل الروابط.
  {% endhint %}

لتقييد الوصول إلى روابطك بناءً على الوقت، يمكنك استخدام روابط الوكيل بإضافتها إلى الأزرار في الكتل.

**الخطوة 1.** للقيام بذلك، أضف متغيرًا في الحاسبة — على سبيل المثال، `الرابط`— حيث ستخزن رابط الوكيل (انظر المثال في الشكل 2).

**الخطوة 2.** أضف زرًا في الكتلة، وفي إعدادات الزر، أدخل المتغير في حقل URL:

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

## روابط قصيرة مع إشعار بالنقرة

**روابط لمرة واحدة**\
إذا مرّرت وسيطًا إضافيًا (غير الصفر) إلى الدالة "proxy" أو "proxy\_date" أو "proxy\_timeout"، فسيصبح الرابط للاستخدام لمرة واحدة.

<figure><img src="/files/1d56fa01501f04c19ee7838ecc7477952a43fd2c" alt="" width="392"><figcaption><p>الشكل 2</p></figcaption></figure>

في المحاولة الثانية لفتح الرابط، سيرى المستخدم الرسالة التالية:

![الشكل 3](/files/67aad1742ebc63c683df0bf7ad3da6d76bb96e66)

### روابط مع مؤقت

**proxy\_date()** — تأخذ هذه الدالة رابطًا كمعاملها الأول وتُرجع رابطًا مع إشعار بالنقرة.\
يحدد المعاملان الثاني والثالث التاريخ والوقت اللذين سينتهي عندهما الرابط.<br>

إذا مرّرت وسيطًا إضافيًا بعد الدقائق (غير صفر)، فسيصبح الرابط للاستخدام لمرة واحدة.&#x20;

<figure><img src="/files/7e31bfbb2fc1e90881f7279e1a1ca2f1cdd8d3e4" alt="" width="563"><figcaption><p>الشكل 4</p></figcaption></figure>

بعد انتهاء صلاحية الرابط، سيرى الشخص هذه الرسالة عند محاولة فتحه.

![الشكل 5](/files/3e5b9e5360601328b0ba3b89491d6c2204843928)

### **روابط محددة بالوقت**<br>

`proxy_timeout()` — تأخذ هذه الدالة رابطًا كمعامل لها وتُرجع رابطًا مع إشعار بالنقرة.\
يحدد وسيط إضافي عدد الدقائق التي يكون فيها الرابط صالحًا.\
إذا مرّرت وسيطًا آخر بعد الدقائق غير صفر، فسيصبح الرابط للاستخدام لمرة واحدة.

<figure><img src="/files/73e3cdabd62ab638f4973f5dabfd7b70b511b0d3" alt="" width="563"><figcaption><p>الشكل 6</p></figcaption></figure>

![الشكل 7](/files/1571886bbf5aff5c37359db4e1bdeff5e07ea5a1)

### روابط قصيرة بدون إشعارات بالنقرة

يمكن إنشاء جميع الروابط القصيرة بدون استدعاء callback — أي كرابط قصير كلاسيكي.\
ولذلك توجد دوال لها نفس المعاملات ولكنها لا تُفعّل callback.

<table><thead><tr><th width="358">مع callback</th><th>بدون callback</th></tr></thead><tbody><tr><td><strong>proxy</strong> </td><td><strong>short</strong> </td></tr><tr><td><strong>proxy_timeout</strong></td><td><strong>short_timeout</strong> </td></tr><tr><td><strong>proxy_date</strong></td><td><strong>short_date</strong> </td></tr></tbody></table>

وبالتالي، إذا كنت بحاجة إلى استخدام روابط قصيرة بدون callback، فاستخدم متغيرًا لتخزين الرابط، تمامًا كما هو الحال مع دوال رابط الوكيل:

<figure><img src="/files/720317957b6f15ee906c87ba6e709fd5e8122b9b" alt="" width="496"><figcaption><p>الشكل 8</p></figcaption></figure>

### روابط وكيل ذكية

هذه روابط وكيل عادية، لكنها تُسمّى "ذكية" لأنها تسمح بتمرير المعلمات باستخدام `#{}`. عندما ينقر شخص ما على مثل هذا الرابط، يتم استبدال العناصر النائبة بقيم المتغيرات المقابلة لدى العميل. بهذه الطريقة، يمكنك توجيه المستخدم إلى القسم الصحيح من الموقع دون تغيير الرابط نفسه:

<figure><img src="/files/4a4cfc505879f574b7a88dd76b2059584c43698d" alt=""><figcaption><p>شكل 9</p></figcaption></figure>

`url = proxy('https://yandex.ru/search/?clid=9582&text=salebot&lr=53&p=#{page}')`&#x20;

`page = 0`&#x20;

في هذا المثال (الشكل 8)، ننشئ رابطًا بمعامل واحد، ولكن يمكن أن يكون هناك أي عدد من المعاملات.&#x20;

{% hint style="warning" %}
يرجى الانتباه!

من المهم التخطيط لقيم المعاملات في مسار التحويل مسبقًا حتى يعمل رابط الوكيل "الذكي" بسلاسة. يجب تعيين قيمة لكل معامل قبل تقديم الرابط إلى العميل.
{% endhint %}

مع مسار تحويل مُصمَّم جيدًا، ستحتاج فقط إلى تحديث متغيرات العميل اللازمة، وعندما ينقر العميل على الرابط نفسه، فسيتم توجيهه تمامًا إلى المكان المطلوب.

## حذف الرابط

`remove_links()` — يعطّل جميع الروابط القصيرة المرسلة إلى العميل\
`remove_one_time_links()` — يعطّل جميع الروابط لمرة واحدة المرسلة إلى العميل\
`remove_timer_links()` — يعطّل جميع الروابط المحددة بالوقت المرسلة إلى العميل

## مثال على الاستخدام

<figure><img src="/files/d74964775a83b77d5056cbf4e6292912a468c694" alt="" width="494"><figcaption><p>الشكل 10 أضف متغير الرابط الناتج إلى الزر.</p></figcaption></figure>

<figure><img src="/files/89f72624e9863c59958b92824e9cf059afd138ea" alt="" width="537"><figcaption><p>الشكل 11 إعدادات الزر</p></figcaption></figure>

البث المباشر حول هذه الوظيفة:

{% embed url="<https://youtu.be/3sZudxCYuZQ>" %}


---

# 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/kyfyh-.../mhtwa-mtah-muqtana.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.