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 - адреса електронної пошти користувача; якщо її не передано, тоді використовується 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 із змінної 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 не було передано і його не було знайдено у змінній email
Приклад запиту та отримання імені користувача:
Як перевірити, чи є користувач у списку всіх учасників
Функція myownconference_is_our_user(email)де:
email - адреса електронної пошти користувача; якщо її не передано, тоді використовується email із змінної email, якщо вона є
Результат у разі успіху:
{"status":"1","result":true} - користувач є у вашій базі даних {"status":"1","result":false} - такого користувача немає у вашій базі даних
Якщо невдало:
{'status': '0', 'error': 'Missing required variables - email'} - email не було передано і його не було знайдено у змінній email
Як створити учасника
Ця функція додає учасника вебінару до списку всіх користувачів. Після успішного створення цього користувача можна зареєструвати на вебінар (докладніше про це нижче)
Функція myownconference_add_user(email)де:
email - адреса електронної пошти користувача; якщо її не передано, тоді використовується email із змінної email, якщо вона є
Результат у разі успіху:
{"status":"1","result":true} - користувача було додано до вашого списку всіх учасників
Якщо невдало:
{'status': '0', 'error': 'Missing required variables - email'} - email не було передано і його не було знайдено у змінній email.
Як зареєструвати учасника на вебінар
Обов’язково попросіть клієнта вказати свою електронну пошту для реєстрації. Усе інше є необов’язковим.
Функція myownconference_add_user_to_webinar(webinar_id, email), де
webinar_id - ідентифікатор вебінару, або, іншими словами, значення “alias” із запиту під час пошуку вебінару email - адреса електронної пошти користувача; якщо її не передано, тоді використовується email із змінної email, якщо вона є
Результат у разі успіху:
{"status":"1","result":true} - користувача було зареєстровано на вебінар
Якщо невдало:
{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}
Last updated