العمل مع الروابط

الروابط مع إشعار النقر

proxy() | proxy_date() | proxy_timeout()

الأسطورة:

! - المعلمات المطلوبة

proxy(lnk, one-shot) - ينشئ رابطًا مع إشعار النقر. تأخذ الدالة المعلمات التالية:\ ! link - الرابط
one-shot - مؤشر على أن الرابط للاستخدام لمرة واحدة. ببساطة مرر القيمة 1.

proxy_date(lnk, date, time) - ينشئ رابطًا مع إشعار النقر ووقت انتهاء محدد. تأخذ الدالة المعلمات التالية:\ ! link - الرابط\ ! date - تاريخ انتهاء الرابط \ ! time - وقت انتهاء الرابط
one-shot - مؤشر على أن الرابط للاستخدام لمرة واحدة. ببساطة مرر 1.

proxy_timeout(lnk, minutes, one-shot) - ينشئ رابطًا مع إشعار النقر ومؤقت وصول محدد. تأخذ الدالة المعلمات التالية:\ ! link - الرابط\ ! minutes - عدد الدقائق التي يظل فيها الرابط نشطًا.
one-shot - مؤشر على أن الرابط للاستخدام لمرة واحدة. ببساطة مرر 1.

دعنا نستعرض مثالًا بسيطًا:

لقد أنشأنا رابطين وكيلين وأدرجناهما في الأزرار ونص الرسالة. نظرًا لأننا نختبر في Telegram، فهذه فرصة جيدة لتذكر كيفية تنسيق الروابط بشكل صحيح باستخدام Markdown. للتعامل مع الأحرف الخاصة، استخدمنا الدالة tg_escape().

هكذا يراها العميل، على سبيل المثال، في Telegram:

عندما ينقر العميل على الرابط، نتلقى رد اتصال:

دعنا نضبط ردًا على هذا الحدث:

الآن، دعنا نختبر وظائف إزالة الرابط:

وبالتالي، إذا حاول العميل استخدام الرابط لمرة واحدة بعد حذفه، فسيتلقى خطأ لأن الرابط لم يعد موجودًا.

دعنا نحذف الرابط المحدد بوقت:

بعد تنفيذ الدالة، لا تبقى أي روابط وكيلة في بطاقة العميل، وأي محاولة لاتباع الرابط تعيد نفس الخطأ.

مثال كود لحقل "الرسالة" (لا تنسَ تمكين Markdown إذا كنت تعمل مع Telegram):

*اختبار الروابط:*
[انقر](#{link3})

أو اختبر باستخدام تنسيق الإخراج التالي:

مثال كود في حقل "الحاسبة":

link1=proxy('https://mavibot.ai/', 1) 
link2=short_date('https://mavibot.ai/#tariff', '11.06.2025', '2pm') 
link3=tg_escape(link2)

عندما ينقر العميل على رابط وكيل، ستتلقى رد اتصال بالشكل link_was_pressed. يتيح لك ذلك تكوين رد فعل على النقر على الرابط.

للقيام بذلك، أدخل رد الاتصال المستلم في حقل "الشرط" واضبط نوع المطابقة على المطابقة التامة.

تقصير الرابط

short() | short_date() | short_timeout()

الأسطورة:

! - المعلمات المطلوبة

short(lnk, one-shot) - ينشئ رابطًا بدون إشعار النقر. تأخذ الدالة المعلمات التالية:\ ! link - الرابط
one-shot - مؤشر على أن الرابط للاستخدام لمرة واحدة. ببساطة مرر القيمة 1.

short_date(lnk, date, time) - ينشئ رابطًا بدون إشعار النقر ووقت انتهاء محدد. تأخذ الدالة المعلمات التالية:\ ! link - الرابط\ ! date - تاريخ انتهاء الرابط \ ! time - وقت انتهاء الرابط
one-shot - مؤشر على أن الرابط للاستخدام لمرة واحدة. ببساطة مرر 1.

short_timeout(lnk, minutes, one-shot) - ينشئ رابطًا بدون إشعار النقر ومؤقت وصول محدد. تأخذ الدالة المعلمات التالية:\ ! link - الرابط\ ! minutes - عدد الدقائق التي يظل فيها الرابط نشطًا.
one-shot - مؤشر على أن الرابط للاستخدام لمرة واحدة. ببساطة مرر 1.

إزالة الرابط

remove_links() | remove_one_time_links()| remove_timer_links()

الأسطورة:

! - المعلمات المطلوبة

remove_links() - إلغاء تنشيط جميع الروابط المختصرة المرسلة إلى العميل

remove_one_time_links() - إلغاء تنشيط جميع الروابط لمرة واحدة المرسلة إلى العميل

remove_timer_links() - إلغاء تنشيط جميع الروابط المحددة بوقت المرسلة إلى العميل

رابط اختبار بوت Telegram

quiz_link_timeout() | quiz_link_date() | quiz_link()

يرجى الملاحظة!

هناك حد 21 يومًا على صلاحية الرابط، لذا يجب تحديثه!

لتمكين عرض الاختبار في Telegram، يجب عليك:

1. نسخ معرف صفحة موقع ويب. للقيام بذلك، انتقل إلى قسم "مواقع الويب" واختر الموقع المطلوب:

في النص التالي، سنشير إلى mini_landing_page_id كاسم المتغير.

2. في حقل "الحاسبة"، استخدم إحدى الدوال التالية:

الأسطورة:

! - المعلمات المطلوبة

quiz_link_timeout(mini_landing_page_id, minutes) - ينشئ رابطًا مع حد زمني محدد بالدقائق

المعلمات:

! mini_landing_page_id - معرف صفحة موقع الويب
minutes - عمر الرابط بالدقائق (النوع: رقم)

quiz_link_date(mini_landing_page_id, date, time) - ينشئ رابطًا مع انتهاء صلاحية محدد بتاريخ ووقت معينين

المعلمات:

! mini_landing_page_id - معرف صفحة موقع الويب
date - تاريخ نشاط الرابط (التنسيق: dd.mm.yyyy)
time - وقت نشاط الرابط (التنسيق: hh:mm)

quiz_link(mini_landing_page_id) - ينشئ رابطًا بدون وقت انتهاء صلاحية

المعلمات:

! mini_landing_page_id - معرف صفحة موقع الويب

3. أنشئ زر تطبيق ويب Telegram وحدد اسم المتغير بين قوسين معقوفين مع علامة الهاش.

مهم!
تأكد من حفظ قيمة المتغير بشكل صحيح في الإعدادات المتقدمة.

إذا كنت تستخدم quiz_link_timeout لإعادة توجيه العميل إلى صفحة موقع ويب، يمكنك استخدام متغيرات العميل داخل عنوان الصفحة ووصفها. على سبيل المثال، إذا كان لدى العميل متغير name بقيمة "John"، وكان وصف الصفحة يتضمن "Hi #{name}, how are you?"، فسيكون الإخراج "Hi John, how are you?". ومع ذلك، إذا لم يكن لدى العميل هذا المتغير، فسيتم سحب القيمة من المتغيرات العامة للمشروع.

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