MyOwnConference
خدمة عبر الإنترنت تتيح لك استضافة ندوات وندوات عبر الإنترنت ومؤتمرات فيديو تفاعلية
كيفية إعداد الاتصال
أولًا، تحتاج إلى الحصول على مفتاح API، يمكنك العثور عليه في الملف الشخصي قسم حسابك الشخصي على MyOwnConference
بعد نسخ المفتاح، افتح الإعدادات -> ثوابت المشروع على Salebot والصقه في المتغير myownconference_api_key:
تُرجِع كل دالة قاموسًا يحتوي على المعامل status؛ ويمكن أن تكون قيمته 0 و1.
إذا كانت status=1 فهذا يعني أن الطلب في MyOwnConference تم بنجاح وأن المعامل النتيجة سيحتوي على نتيجة الطلب، مثل:
{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}
أو تم تنفيذ الطلب بنجاح، لكن لم يتم العثور على شيء:
{'status': '1', 'result': []}
إذا كانت status=0 فهناك مشكلة وسيتم حفظ الوصف في error، مثل:
{"status":"0","error":"Webinar with alias "wenk-gjkc-teqp-nteh" not active"} {'status': '0', 'error': 'Missing required variables - email'}
كيفية البحث عن الندوات عبر الإنترنت
الدالة myownconference_find_webinars(date, status) تُستخدم للبحث عن الندوات عبر الإنترنت، حيث
date - التاريخ بصيغة dd.mm.yyyy - لاختيار الندوات لتاريخ محدد status - القيمة 1 - الندوات النشطة أو المستقبلية، 0 - المنتهية
myownconference_find_webinars() - تُرجع مصفوفة بجميع الندوات التي تم العثور عليها
تُرجع الدالة قاموسًا من هذا النوع:
إذا نجحت (مثال):
{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}
إذا لم تنجح (مثال):
{"status":"0","error":"Format not supported or date is not valid. Params must be yyyy-mm-dd"}
كيفية التحقق مما إذا كان المستخدم موجودًا في ندوة عبر الإنترنت نشطة
الدالة myownconference_is_online_user(webinar_id, email)، حيث:
webinar_id - معرّف الندوة، أو بعبارة أخرى، قيمة "alias" من الطلب عند البحث عن الندوة البريد الإلكتروني - عنوان بريد المستخدم الإلكتروني، وإذا لم تتم مشاركته، فسيُستخدم البريد الإلكتروني من المتغير email إن وُجد
النتيجة إذا نجحت الدالة:
{"status":"1","result":true} - المستخدم موجود في هذه اللحظة في الندوة {"status":"1","result":false} - المستخدم غير موجود
النتيجة إذا حدث خطأ في الطلب:
{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}
كيفية الحصول على بيانات سجل المستخدم
الدالة myownconference_history_user(webinar_id, email)، حيث
webinar_id - معرّف الندوة، أو بعبارة أخرى، قيمة "alias" من الطلب عند البحث عن الندوة البريد الإلكتروني - عنوان بريد المستخدم الإلكتروني، وإذا لم تتم مشاركته، فسيُستخدم البريد الإلكتروني من المتغير email إن وُجد
النتيجة إذا نجح:
في المعامل result ستكون هناك مصفوفة تحتوي على بيانات المستخدم
{'status': '1', 'result': ['John Smith', '[email protected]', 'ua', '12:02:45', '12:12:15', 'G', '28%']} {"status":"1","result":false} - لم يتم العثور على المستخدم
في حال الفشل:
{'status': '0', 'error': 'Missing required variables - email'} - لم تتم مشاركة البريد الإلكتروني ولم يتم العثور عليه في المتغير email
مثال على الطلب والحصول على اسم المستخدم:
كيفية التحقق مما إذا كان المستخدم موجودًا في قائمة جميع المشاركين
الدالة myownconference_is_our_user(email)، حيث:
البريد الإلكتروني - عنوان بريد المستخدم الإلكتروني، وإذا لم تتم مشاركته، فسيُستخدم البريد الإلكتروني من المتغير email إن وُجد
النتيجة إذا نجح:
{"status":"1","result":true} - المستخدم موجود في قاعدة بياناتك {"status":"1","result":false} - لا يوجد مستخدم بهذا الاسم في قاعدة بياناتك
إذا لم ينجح:
{'status': '0', 'error': 'Missing required variables - email'} - لم تتم مشاركة البريد الإلكتروني ولم يتم العثور عليه في المتغير email
كيفية إنشاء مشارك
تضيف هذه الدالة مشاركًا في ندوة عبر الإنترنت إلى قائمة جميع المستخدمين. بعد الإنشاء الناجح يمكن تسجيل هذا المستخدم في ندوة عبر الإنترنت (المزيد حول ذلك أدناه)
الدالة myownconference_add_user(email)، حيث:
البريد الإلكتروني - عنوان بريد المستخدم الإلكتروني، وإذا لم تتم مشاركته، فسيُستخدم البريد الإلكتروني من المتغير email إن وُجد
النتيجة إذا نجح:
{"status":"1","result":true} - تمت إضافة المستخدم إلى قائمة جميع المشاركين لديك
إذا لم ينجح:
{'status': '0', 'error': 'Missing required variables - email'} - لم تتم مشاركة البريد الإلكتروني ولم يتم العثور عليه في المتغير email.
كيفية تسجيل مشارك في ندوة عبر الإنترنت
من الضروري أن تطلب من العميل بريده الإلكتروني حتى تتم عملية التسجيل. أما كل شيء آخر فهو اختياري.
الدالة myownconference_add_user_to_webinar(webinar_id, email)، حيث
webinar_id - معرّف الندوة، أو بعبارة أخرى، قيمة "alias" من الطلب عند البحث عن الندوة البريد الإلكتروني - عنوان بريد المستخدم الإلكتروني، وإذا لم تتم مشاركته، فسيُستخدم البريد الإلكتروني من المتغير email إن وُجد
النتيجة إذا نجح:
{"status":"1","result":true} - تم تسجيل المستخدم في الندوة عبر الإنترنت
إذا لم ينجح:
{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}
Last updated