كيفية إعداد WebinarGeek

للحصول على الرمز المميز (token)، انتقل إلى إعدادات الحساب على WebinarGeek. يمكنك العثور عليه في الزاوية اليمنى العليا من الشاشة، وبعد الضغط على كلمة "Account"، تفتح قائمة منسدلة، حيث تحتاج إلى اختيار الخيار الأول:

ثم اختر "API" من القائمة على اليسار

بعد ذلك، ستفتح صفحة API

إذا لم تحصل على المفتاح، فأنت بحاجة إلى الاتصال بدعم العملاء وطلب واحد.

بعد الحصول على الرمز المميز، افتح الإعدادات -> ثوابت المشروع والصقه في المتغير webinargeek_token:

كيفية الحصول على قائمة الندوات عبر الإنترنت من خلال chatbot

للحصول على القائمة، يكفي استدعاء الدالة webinargeek_get_webinar_list():

ونتيجة لذلك، ستكون هناك قائمة بالندوات عبر الإنترنت بهذا التنسيق:

['{"id":1455034,"date":"11-05-2022 18:00","name":"Second webinar"}',
'{"id":1455046,"date":"11-05-2022 18:00","name":"My Webinar"}',
'{"id":1453081,"date":"04-05-2022 18:00","name":"My first webinar"}']

حيث

id - هو معرف البث (broadcast_id)، القيمة ضرورية لجميع الإجراءات الأخرى مع هذه الندوة
تاريخ الندوة - تاريخ ووقت هذا البث
الاسم - اسم الندوة عبر الإنترنت

إذا شاركت مع الدالة أي رمز (من الأفضل لصق '1')، فستظهر الدالة فقط الندوات التي لم تنتهِ بعد، وإذا لم تلصق شيئًا، فستظهر أيضًا الندوات المنتهية.

كيفية التسجيل في ندوة عبر الإنترنت من خلال chatbot

للتسجيل، تحتاج إلى الدالة webinargeek_get_webinar_list(broadcast_id, name, email)، حيث

broadcast_id - معرف البث الذي تحتاج إلى تسجيل العميل له
name - اسم العميل الذي سيظهر في الدردشة
email - عنوان البريد الإلكتروني الذي سيتم إرسال الدعوة إلى الندوة مع الرابط إليه

بدون هذه المعلمات، لا يمكنك تسجيل عميل من خلال الروبوت.

مثال:
url = webinargeek_add_subscriber(1455046, 'John Smith', '[email protected]')

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

أيضًا، بعد تنفيذ الدالة، سيتم إضافة متغيرين إلى بطاقة العميل:

webinargeek_broadcast_id - معرف البث الذي تم تسجيل المستخدم له
webinargeek_email - البريد الإلكتروني الذي تم تحديده في التسجيل

ستكون هذه المتغيرات مفيدة للتحقق من حضور المستخدم للندوة.

كيفية التحقق من حضور الندوة عبر الإنترنت من خلال chatbot

للتحقق من الحضور، ستحتاج إلى هذه الدالة webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)، حيث

webinargeek_broadcast_id - معرف البث الذي تم تسجيل المستخدم له
webinargeek_email - البريد الإلكتروني الذي تم تحديده في التسجيل
watch_minimum - (معلمة اختيارية) الحد الأدنى من الدقائق التي تحدد بها الدالة ما إذا كان الحضور يُحتسب أم لا

watch = webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)

سيتم لصق رد في المتغير:

  • إذا لم تكن الندوة قد انتهت بعد، فسيأتي هذا النص كرد: "Webinar not ended yet";
  • إذا لم يشاهد العميل الندوة، فسيأتي هذا كرد: "False";
  • إذا شاهد العميل الندوة ولم يتم استخدام المعلمة watch_minimum، فسيأتي هذا كرد: "True";
    إذا تم استخدام المعلمة watch_minimum، فستتحقق الدالة من مقدار الوقت الذي شاهده العميل و:
    • إذا شاهده العميل لمدة أقل مما تم تعيينه كحد أدنى، فسيأتي هذا كرد: "False";
    • إذا كان مقدار الوقت الذي شاهد فيه العميل الندوة مساويًا أو أكبر من المقدار المحدد، فسيأتي هذا كرد: "True".

كيفية الحصول على broadcast_id بواسطة اسم الندوة بدءًا من تاريخ ووقت محددين

للحصول على broadcast_id لندوة محددة، تحتاج إلى الدالة webinargeek_search_broadcast_id() مع هذه المعلمات:

webinar_list - هنا تحتاج إلى نقل المتغير الذي يحمل نتيجة الدالة webinargeek_get_webinar_list()
webinar_name - اسم الندوة التي تحتاج إلى العثور على broadcast_id الخاص بها
webinar_date - تاريخ البث بتنسيق dd.mm.yyyy. يمكنك أيضًا استخدام current_date
webinar_time - وقت البث بتنسيق hh:mm، حيث hh = ساعات و mm = دقائق

مثال:
webinar_list = webinargeek_get_webinar_list()
broadcast_id = webinargeek_search_broadcast_id(webinar_list, 'Second webinar', current_date-4, '18:00'

هنا نحاول العثور على معرف البث الذي حدث قبل 4 أيام من التاريخ الحالي في الساعة 6 مساءً وكان يسمى "Second webinar".

إذا كانت الندوة التي تتوافق مع المعلمات موجودة في القائمة، فستعيد الدالة معرف الندوة التي تم العثور عليها إلى متغير broadcast_id.

إذا لم يتم العثور على مثل هذه الندوة، فسيتم لصق هذا النص بدلاً من ذلك: "No webinar with these parameters".