# MyOwnConference

* [كيفية إعداد الاتصال](#how-to-set-up-the-connection) 
* [كيفية البحث عن الندوات عبر الإنترنت](#how-to-search-webinars) 
* [كيفية التحقق مما إذا كان المستخدم موجودًا في ندوة عبر الإنترنت نشطة](#how-to-check-if-a-user-is-present-in-an-active-webinar) 
* [كيفية الحصول على بيانات سجل المستخدم](#how-to-get-user-history-data) 
* [كيفية التحقق مما إذا كان المستخدم موجودًا في قائمة جميع المشاركين](#how-to-check-if-a-user-is-in-the-list-of-all-participants) 
* [كيفية إنشاء مشارك](#how-to-create-a-participant) 
* [كيفية تسجيل مشارك في ندوة عبر الإنترنت](#how-to-register-a-participant-to-a-webinar)

## كيفية إعداد الاتصال

أولًا، تحتاج إلى الحصول على **مفتاح API**، يمكنك العثور عليه في **الملف الشخصي** قسم **حسابك الشخصي** على [MyOwnConference ](https://myownconference.com)

![](https://lh4.googleusercontent.com/qewIXxHvrxD2EAzu6Z5ehv4mFsludab5f3HoaPqXZcJdSJsrGux40sRFhPoileMKMK0SbSkBm2NZYHPdVmmOnUCm4OyVb4X82iVhdoxis22p_RfmV4CgTg1V9WcxsTRcit2NzS8WeN2sDn2kaA)

بعد نسخ المفتاح، افتح **الإعدادات -> ثوابت المشروع** على Salebot والصقه في المتغير **myownconference\_api\_key**:

![](https://lh3.googleusercontent.com/VrwGM1wYrbl0E-5sLigjuV8gDIOiF9GY9KoZEkAN3KL-QMdzGlZP9_39wXnO2aWGMfZvRIGAFQrePwl9xJrbIgPcAmhmOYTUsHxj5idKCHz3NdAUk1RQAj6MKgjLDOYN6C4ah13atFWQ8W8dcw)

{% hint style="warning" %}
تُرجِع كل دالة قاموسًا يحتوي على المعامل **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'}
{% endhint %}

## كيفية البحث عن الندوات عبر الإنترنت

الدالة **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', '<exam@gmail.com>', 'ua', '12:02:45', '12:12:15', 'G', '28%']} {"status":"1","result":false} - لم يتم العثور على المستخدم

**في حال الفشل:**

{'status': '0', 'error': 'Missing required variables - email'} - لم تتم مشاركة البريد الإلكتروني ولم يتم العثور عليه في المتغير email

**مثال على الطلب والحصول على اسم المستخدم:**

![مثال على طلب الحصول على بيانات سجل المستخدم](https://lh5.googleusercontent.com/LWvIPgOAPRyggrudssJD_1ZJL3h8hJc5b4fIav5aWF4pz-xDsOjd_5DFHyjDMdghvewx3yL3aafk5JmQUOXFWoC8FHXngtVjiWvTyzuMLClENzB6DSq6NU_7EYnG9WiPDzgDX89rUVGUESdDmw)

![مثال على نتيجة الطلب](https://lh5.googleusercontent.com/eFiI-RaFUIobEYPLEM7bPhvRw9mVWDlQY8aUIBHeXdALhduhhLAtZZlKODW3X-MJQSJYHI2KQk41sYzi1X824pliAy2bgrCnHgWcBMDVV50RLGIvE1a3u2L34DmKl6qsIa2nYXv-zd17Ua2_aA)

## كيفية التحقق مما إذا كان المستخدم موجودًا في قائمة جميع المشاركين

الدالة **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"}


---

# 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/integrations/other/infobusiness/myown.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.