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":"Вебинар с псевдонимом "wenk-gjkc-teqp-nteh" не активен"} {'status': '0', 'error': 'Отсутствуют обязательные переменные - 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":"Формат не поддерживается или дата недействительна. Параметры должны быть yyyy-mm-dd"}

Как проверить, присутствует ли пользователь на активном вебинаре

Функция myownconference_is_online_user(webinar_id, email)где:

webinar_id - id вебинара, или, другими словами, значение «alias» из запроса при поиске вебинара email - email-адрес пользователя; если он не передаётся, тогда используется email из переменной email, если она есть

Результат, если функция выполнилась успешно:

{"status":"1","result":true} - пользователь сейчас присутствует на вебинаре {"status":"1","result":false} - пользователя нет

Результат, если в запросе произошла ошибка:

{"status":"0","error":"Вебинар с псевдонимом "serg-dhpq-mznf-fwcb" не активен"}

Как получить данные истории пользователя

Функция myownconference_history_user(webinar_id, email), где

webinar_id - id вебинара, или, другими словами, значение «alias» из запроса при поиске вебинара email - 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': 'Отсутствуют обязательные переменные - email'} - email не был передан и не был найден в переменной email

Пример запроса и получения имени пользователя:

Пример запроса для получения данных истории пользователя

Пример результата запроса

Как проверить, есть ли пользователь в списке всех участников

Функция myownconference_is_our_user(email)где:

email - email-адрес пользователя; если он не передаётся, тогда используется email из переменной email, если она есть

Результат при успешном выполнении:

{"status":"1","result":true} - пользователь есть в вашей базе данных {"status":"1","result":false} - такого пользователя в вашей базе данных нет

Если неуспешно:

{'status': '0', 'error': 'Отсутствуют обязательные переменные - email'} - email не был передан и не был найден в переменной email

Как создать участника

Эта функция добавляет участника вебинара в список всех пользователей. После успешного создания этого пользователя можно зарегистрировать на вебинар (об этом ниже)

Функция myownconference_add_user(email)где:

email - email-адрес пользователя; если он не передаётся, тогда используется email из переменной email, если она есть

Результат при успешном выполнении:

{"status":"1","result":true} - пользователь был добавлен в ваш список всех участников

Если неуспешно:

{'status': '0', 'error': 'Отсутствуют обязательные переменные - email'} - email не был передан и не был найден в переменной email.

Как зарегистрировать участника на вебинар

Необходимо обязательно запросить у клиента его email, чтобы регистрация состоялась. Всё остальное необязательно.

Функция myownconference_add_user_to_webinar(webinar_id, email), где

webinar_id - id вебинара, или, другими словами, значение «alias» из запроса при поиске вебинара email - email-адрес пользователя; если он не передаётся, тогда используется email из переменной email, если она есть

Результат при успешном выполнении:

{"status":"1","result":true} - пользователь был зарегистрирован на вебинар

Если неуспешно:

{"status":"0","error":"Вебинар с псевдонимом "serg-dhpq-mznf-fwcb" не активен"}