WebinarGeek
Це платформа для проведення різних типів вебінарів.
Як налаштувати WebinarGeek
Щоб отримати токен, перейдіть до налаштувань облікового запису на WebinarGeek. Ви можете знайти це у верхньому правому куті екрана, і після натискання на слово Account відкривається випадаюче меню, де потрібно вибрати перший пункт:
Потім виберіть API в меню зліва
Після цього відкриється сторінка з API
Якщо ви не отримали ключ, тоді вам потрібно звернутися до служби підтримки клієнтів і попросити його.
Після того як ви отримаєте токен, відкрийте Налаштування -> Константи проєкту і вставте його у змінну webinargeek_token:
Як отримати список вебінарів через чат-бота
Щоб отримати список, достатньо викликати функцію webinargeek_get_webinar_list():
У результаті буде список вебінарів у такому форматі:
['{"id":1455034,"date":"11-05-2022 18:00","name":"Second webinar"}', '{"id":1455046,"date":"11-05-2022 18:00","name":"My Webinar"}', '{"id":1453081,"date":"04-05-2022 18:00","name":"My first webinar"}']
де
id - це id трансляції (broadcast_id), значення є обов’язковим для всіх інших дій із цим датою вебінару - дата й час цієї трансляції name - назва вебінару
Якщо ви передасте у функцію будь-який символ (краще вставити '1'), тоді функція покаже лише ті вебінари, які ще не завершені, а якщо ви нічого не вставите, то вона також покаже й завершені.
Як зареєструватися на вебінар через чат-бота
Для реєстрації вам потрібна функція webinargeek_get_webinar_list(broadcast_id, name, email), де
broadcast_id - id трансляції, на яку потрібно зареєструвати клієнта name - ім’я клієнта, яке буде показано в чаті email - адреса електронної пошти, на яку прийде запрошення на вебінар із посиланням
Без цих параметрів ви не зможете зареєструвати клієнта через бот.
Приклад: url = webinargeek_add_subscriber(1455046, 'John Smith', '[email protected]’)
У результаті в цій змінній буде посилання на вебінар, через яке користувачу не потрібно буде реєструватися. Усі дані користувача задаються в цій змінній.
Також після виконання функції до картки клієнта буде додано дві змінні:
webinargeek_broadcast_id - id трансляції, на яку був зареєстрований користувач webinargeek_email - електронна пошта, вказана під час реєстрації
Ці змінні будуть корисні для перевірки відвідуваності вебінару користувачем.
Як перевірити відвідуваність вебінару через чат-бота
Щоб перевірити відвідуваність, вам знадобиться ця функція webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email), де
webinargeek_broadcast_id - id трансляції, на яку був зареєстрований користувач webinargeek_email - електронна пошта, вказана під час реєстрації watch_minimum - (необов’язковий параметр) мінімальна кількість хвилин, за якою функція визначає, чи зараховується відвідування як таке, або ні
watch = webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)
Відповідь буде записана у змінну:
Якщо вебінар ще не завершився, тоді у відповідь приходить цей текст: “Webinar not ended yet”;
Якщо клієнт не дивився вебінар, тоді у відповідь приходить: “False”;
Якщо клієнт дивився вебінар і параметр watch_minimum не використовувався, тоді у відповідь приходить: “True”; Якщо параметр watch_minimum використовувався, тоді функція перевірить, скільки часу клієнт його переглядав, і:
Якщо клієнт дивився його менше часу, ніж було вказано як мінімум, у відповідь приходить: “False”;
Якщо час, протягом якого клієнт дивився вебінар, дорівнює або перевищує вказаний час, тоді у відповідь приходить: “True”.
Як отримати broadcast_id за назвою вебінару, починаючи з вказаної дати й часу
Щоб отримати broadcast_id вказаного вебінару, вам потрібна функція webinargeek_search_broadcast_id() з такими параметрами:
webinar_list - тут потрібно передати змінну, яка містить результат функції webinargeek_get_webinar_list() результат webinar_name - назва вебінару, broadcast_id якого потрібно знайти webinar_date - дата трансляції у форматі dd.mm.yyyy. Також можна використовувати curret_date webinar_time - час трансляції у форматі hh:mm, де hh = години, а mm = хвилини
Приклад: webinar_list = webinargeek_get_webinar_list() broadcast_id = webinargeek_search_broadcast_id(webinar_list, 'Second webinar', current_date-4, '18:00'
Тут ми намагаємося знайти id трансляції, яка відбувалася 4 дні до поточної дати о 6-й вечора і мала назву “Second webinar”.
Якщо вебінар, що відповідає параметрам, був у списку, тоді функція повертає id знайденого вебінару у змінну broadcast_id.
Якщо такий вебінар не був знайдений, тоді замість цього вставляється такий текст: "No webinar with these parameters".
Last updated