التسجيل في الدورة
register_customer_on_course(tariff_id, email, email_notification, period, reregistration)
مثال: register_customer_on_course(123, email, 1, "", True)
لكي يتلقى العملاء رسائل البريد الإلكتروني، قم بتمرير 1 إلى المعلمة email_notification.
إذا لم ترسل 1، فلن يتم استلام رسائل البريد الإلكتروني للعميل!
كيف يمكنني منح الوصول إلى الدورة عبر تطبيق الويب في تيليجرام؟
للقيام بذلك، حدد الوظيفة في حاسبة الكتلة
access_course_from_webapp(text, button_label)
عند استخدام الوظيفة، يقوم الطالب بتسجيل الدخول إلى تيليجرام ويحصل على الوصول إلى الدورة. لمزيد من التدريب، لا يحتاج الطالب إلى إدخال اسم مستخدم وكلمة مرور، حيث تم إكمال التفويض بالفعل.
معلمات الوظيفة:
text - هو نص الرسالة التي سيتلقاها العميل. يمكن تحديد المعلمة في متغير عن طريق كتابتها في حقل الحاسبة قبل الوصول إلى الوظيفة، أو تحديدها في الوظيفة نفسها بين علامتي اقتباس.
button_label - هو النص الموجود على زر تطبيق الويب. يمكنك تحديد المعلمة إما في متغير أو في الوظيفة نفسها. في الحالة الثانية، تُكتب المعلمة بين علامتي اقتباس.
هذا مناسب فقط للعمل مع بوت تيليجرام.
لقطة الشاشة أدناه توضح مثالاً لاستخدام الوظيفة.
في الخطوة الأولى، نسجل العميل في الدورة، ثم نستخدم الوظيفة access_course_com_webapp لمنح الوصول إلى المنتج عبر الإنترنت.
نتيجة تنفيذ الوظيفة:
يفتح هذا الزر صفحة تحتوي على الدورات/الأسعار التي يمتلكها الطالب.
إذا لم يكن العميل مرتبطًا بحساب الطالب، ترجع الوظيفة 'client not attached to customer'.
لإنشاء هذا الاتصال، ما عليك سوى التسجيل في دورة عبر بوت.
كيفية منح الوصول إلى الدورة عبر بوت
register_customer_on_course()
للقيام بذلك، حدد الوظيفة في حاسبة الكتلة
register_customer_on_course(tariff_id, email, email_notification, period)
| المعلمات المطلوبة | المعلمات الاختيارية |
|---|---|
| ! tariff_id - معرف خطة التسعير. يمكنك نسخه من شريط المتصفح في إعدادات خطة التسعير. | email_notification - ترسل هذه المعلمة للطالب رسالة بريد إلكتروني حول تسجيله في الدورة، إذا كانت مفعلة. |
| ! email - عنوان البريد الإلكتروني للعميل. يمكنك تحديد قيمة محددة أو متغير يتم فيه تسجيل البريد الإلكتروني للعميل. | period - الحد الزمني لصلاحية خطة التسعير. تنسيقات التاريخ المدعومة هي: %d.%m.%Y %H:%M أو %d.%m.%Y مثال: period = '15.08.2023 11:00' |
لكي يتلقى العملاء رسائل البريد الإلكتروني، يجب عليك تمرير 1 في المعلمة email_notification.
إذا لم ترسل 1، فلن يتم استلام رسائل البريد الإلكتروني للعميل!
قم بتعيين الوظيفة إلى المتغير.
بعد التنفيذ، سيتم كتابة أحد الردود في المتغير:
customer is already on tariff - إذا كانت هناك خطة تسعير أو تم إغلاق الوصول يدويًا
wrong_tariff_id - تم تحديد معرف غير صالح
tariff_added - تمت إضافة خطة التسعير إلى الطالب
مثال:
كيفية التحقق من توفر الوصول إلى الدورة
has_customer_tariff(tariff_id)
للقيام بذلك، حدد الوظيفة في حاسبة الكتلة has_customer_tariff(tariff_id, email)
| المعلمات المطلوبة | المعلمات الاختيارية |
|---|---|
| ! tariff_id - معرف خطة التسعير. يمكنك نسخه من شريط المتصفح في إعدادات خطة التسعير أو في قسم خطط التسعير. | email - معلمة اختيارية. قم بتمرير هذه المعلمة للتحقق مما إذا كان العميل مسجلاً في الدورة باستخدام عنوان البريد الإلكتروني المحدد. |
بعد التنفيذ، ترجع الوظيفة True أو False.
الردود المحتملة للوظيفة في حالة الأخطاء:
wrong tariff_id - تم تمرير قيمة غير صالحة tariff_id
customer not found - المستخدم غير مسجل كطالب.
كيفية تسجيل عميل على المنصة دون منح الوصول إلى الدورة
register_customer(email)
للقيام بذلك، حدد الوظيفة في حاسبة الكتلة register_customer(email)
| معلمات الوظيفة | الوصف |
|---|---|
| عنوان البريد الإلكتروني للعميل. |
يمكنك تحديد متغير في الوظيفة أو قيم المعلمات. لتحديد متغير، اكتب اسمه، بدون علامات اقتباس وعلامات نحوية وشبكات وأقواس معقوفة. لتحديد قيمة محددة، حدد عنوان البريد الإلكتروني للعميل بين علامتي اقتباس.
يُوصى بتعيين متغير للوظيفة، حتى تتمكن من رؤية نتيجة الوظيفة والعمل بها. مثال في لقطة الشاشة أدناه: يتم تعيين اسم المتغير قبل علامة المساواة، متبوعًا بالوظيفة والمعلمة بين قوسين.
بعد التنفيذ الناجح للوظيفة، سيتم كتابة الرد في المتغير:
customer created
كيفية التحقق من الوصول إلى الدورة والحدود الزمنية؟
للقيام بذلك، حدد الوظيفة في حاسبة الكتلة has_customer_tariff_with_date(tariff_id, email)، للتحقق من توفر الوصول إلى الدورة عبر البريد الإلكتروني (ترجع ردًا مفصلاً حول توفر الوصول والقيود الزمنية).
معلمات الوظيفة:
| المعلمة المطلوبة | المعلمة الاختيارية |
|---|---|
| ! tariff_id - معرف خطة التسعير. يمكنك نسخه من شريط المتصفح في إعدادات خطة التسعير أو في قسم خطط التسعير. | email - معلمة اختيارية. |
سيكون الرد:
- الطالب مسجل وهناك حد زمني للوصول: لديه وصول حتى 2023-09-28 22:00:00
- الطالب مسجل، لا توجد قيود: لديه وصول بدون حد زمني
- الطالب غير مسجل: لا يوجد وصول إلى هذه التعرفة
الردود المحتملة للوظيفة في حالة الأخطاء:
wrong tariff_id - تم تمرير قيمة غير صالحة tariff_id
customer not found - المستخدم غير مسجل كطالب.
كيفية إزالة الوصول إلى دورة الطالب عبر بوت
del_customer_from_course(course_id, email)
للقيام بذلك، حدد الوظيفة في حاسبة الكتلة del_customer_from_course(course_id, email)
| المعلمات | الوصف |
|---|---|
| ! tariff_id | معرف خطة التسعير |
| عنوان البريد الإلكتروني للعميل |
كيفية التحقق مما إذا كان الطالب قد حضر ندوة عبر الإنترنت
customer_was_on_translation()
يجب منح الوصول إلى الدورة في البوت.
هناك وظيفة لهذا register_customer_on_course() و access_course_from_webapp()
للتحقق مما إذا كان الطالب قد حضر الندوة عبر الإنترنت أم لا، حدد الوظيفة في حاسبة الكتلة customer_was_on_translation(translation_guid, email, after_start_time)
| المعلمات المطلوبة | المعلمة الاختيارية |
|---|---|
| ! translation_guid - معرف البث. انسخ قيمة الحقل الاسم موجود في رابط إعدادات البث | after_start_time - وقت بدء البث بالتنسيق: '2023-04-18 13:30:00'. |
| ! email - عنوان البريد الإلكتروني للطالب |
انتبه! يمكن أن يكون اسم المتغير أي اسم مناسب ومفهوم لك. في حالة وجود خطأ في كتابة معلمات الوظيفة، سيتم كتابة رسالة في المتغير: wrong translation_guid
في هذه الحالة، نوصي بالتحقق من معلمات الوظيفة واختبارها مرة أخرى. للحصول على قيمة مدة البقاء في الندوة عبر الإنترنت من متغير في الحاسبة، يمكنك استخدام وظيفة العمل مع المصفوفات والقواميس. رابط المصفوفات و القواميس.
مثال على الإعدادات في حاسبة الكتلة:
time_spent1 = answer2[0]['time_spent']
كيفية العثور على اسم الطالب المرتبط ببوت؟
هناك حالات قد يكون فيها الطلاب مرتبطين بالدردشة عبر الإنترنت لحساب الطالب الشخصي، بالإضافة إلى أولئك المرتبطين بتطبيق مراسلة ويكتبون إلى مشرفيك عبر بوت. من أجل إصدار شهادات إتمام الدورة بشكل صحيح في البوت وعدم البحث عن اسم الطالب في القائمة، هناك وظيفة:
get_customer_name() - ترجع اسم الطالب المرتبط بالعميل.
وظيفة بدون معلمات.
ترجع اسم الطالب الذي أدخله الطالب أثناء التسجيل في الدورة، أو اسم الطالب من حسابه الشخصي.