วิธีตั้งค่าการเชื่อมต่อ

ก่อนอื่นคุณต้องได้รับ คีย์ API คุณสามารถหาได้ในส่วน โปรไฟล์ ใน บัญชีส่วนตัว ของคุณบน MyOwnConference

หลังจากคัดลอกคีย์แล้ว ให้เปิด การตั้งค่า -> ค่าคงที่ของโปรเจกต์ บน Mavibot และวางลงในตัวแปร myownconference_api_key:

แต่ละฟังก์ชันจะคืนค่าพจนานุกรมที่มีพารามิเตอร์ status ค่าของมันสามารถเป็น 0 และ 1

ถ้า status=1 แสดงว่าคำขอใน MyOwnConference ผ่านไปได้สำเร็จ และพารามิเตอร์ result จะเก็บผลลัพธ์ของคำขอ เช่น:

{'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 - ที่อยู่อีเมลของผู้ใช้ ถ้าไม่ได้ระบุ จะใช้อีเมลจากตัวแปร 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 - ที่อยู่อีเมลของผู้ใช้ ถ้าไม่ได้ระบุ จะใช้อีเมลจากตัวแปร 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 - ที่อยู่อีเมลของผู้ใช้ ถ้าไม่ได้ระบุ จะใช้อีเมลจากตัวแปร email ถ้ามี

ผลลัพธ์ถ้าสำเร็จ:

{"status":"1","result":true} - ผู้ใช้อยู่ในฐานข้อมูลของคุณ {"status":"1","result":false} - ไม่มีผู้ใช้ดังกล่าวในฐานข้อมูลของคุณ

ถ้าไม่สำเร็จ:

{'status': '0', 'error': 'Missing required variables - email'} - ไม่ได้ระบุอีเมลและไม่พบในตัวแปร email

วิธีสร้างผู้เข้าร่วม

ฟังก์ชันนี้จะเพิ่มผู้เข้าร่วมเว็บสัมมนาลงในรายชื่อผู้ใช้ทั้งหมด หลังจากสร้างสำเร็จ ผู้ใช้คนนี้สามารถลงทะเบียนเข้าร่วมเว็บสัมมนาได้ (รายละเอียดเพิ่มเติมด้านล่าง)

ฟังก์ชัน myownconference_add_user(email) โดยที่:

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 - ที่อยู่อีเมลของผู้ใช้ ถ้าไม่ได้ระบุ จะใช้อีเมลจากตัวแปร email ถ้ามี

ผลลัพธ์ถ้าสำเร็จ:

{"status":"1","result":true} - ผู้ใช้ถูกลงทะเบียนในเว็บสัมมนาแล้ว

ถ้าไม่สำเร็จ:

{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}