Webinargeek

Это платформа для проведения различных видов вебинаров.

Как получить токен Как получить список вебинаров из чат-бота ​ ​Как регистрировать на вебинар из чат-бота ​ ​Как проверить посещение вебинара ​из чат-бота Как получить id трансляции по названию вебинара, начиная с определенной даты и времени

Как настроить Webinargeek

Как получить токен

Токен необходимо получить в интерфейсе системы Webinargeek. Для этого перейдите в раздел настройки аккаунта. Найти его можете в верхнем правом углу и после нажатия на слово Account откроется список, в котором нужно выбрать первый пункт.:

Далее в выпавшем справа списке найдите пункт API и выберите его

После этого загрузится страница, содержащая API-ключ:

Если ключа нет, то необходимо обратиться в техподдержку и попросить дать возможность получить API-ключ.

После получения токена переходим в Salebot Настройки проекта -> Переменные проекта и сохраняем его в переменную 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), значение необходимо для всех прочих действий с этим вебинаром. "date" - дата и время проведения этой трансляции. "name" - название вебинара. Если передать в функцию любой символ (лучше всего поставить там 1), то функция покажет только те вебинары, которые еще не закончились, а если ничего не поставить, то вернет в том числе и завершенные.

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

Для регистрации на вебинар нужно вызвать функцию: webinargeek_get_webinar_list() с нужными параметрами. Всего необходимы 3 переменных: broadcast_id - id трансляции, на которую нужно записать клиента, name - имя клиента, которое будет отображаться в чате, email - адрес электронной почты на который придет приглашение на вебинар вместе со ссылкой.

webinargeek_get_webinar_list(broadcast_id, name, email)

Без этих трех параметров нельзя записать клиента через чат-бот: url = webinargeek_add_subscriber(1455046, 'Василий Петров', '[email protected]')

В результате в этой переменной будет ссылка на трансляцию, перейдя по которой пользователю не придется регистрироваться. Все данные пользователя задаются в этой переменной. Также после исполнения функции в карточке клиента в информации о сделке добавится 2 переменные: webinargeek_broadcast_id - id трансляции, на которую записан пользователь,

webinargeek_email - email, указанный при записи пользователя. Эти переменные пригодятся для проверки посещения клиентом вебинара.

Как проверить посещение вебинара через чат-бот

Для проверки посещения вебинара нужно вызвать функцию: webinargeek_is_visitor() с нужными параметрами. В данной функции три переменные: broadcast_id - id трансляции, на которую был записан клиент, email - адрес электронной почты, указанный для клиента, watch_minimum - (необязательный параметр) минимальное количество минут, по которому функция определяет будет ли засчитано посещение или нет.

watch = webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)

В переменную будет помещен ответ: - Если вебинар еще не закончился, то в ответ придет текст 'Webinar not ended yet'. - Если клиент не смотрел вебинар, то в ответ всегда придет False. - Если клиент смотрел вебинар и параметр watch_minimum не использовался, то в ответ придет True. - Если параметр watch_minimum использовался, то функция проверит сколько времени пользователь смотрел вебинар - и если смотрел меньшее кол-во минут, чем задано, то в ответ придет False - а если равное, либо большее, то придет и если смотрел меньшее количество минут, чем задано, то в ответ придет True.

Как получить id трансляции по названию вебинара, начиная с определенной даты и времени

Для получения id конкретной трансляции нужно вызвать функцию: webinargeek_search_broadcast_id() со следующими параметрами: webinar_list - здесь необходимо передать переменную, содержащую результат выполнения функции webinargeek_get_webinar_list() webinar_name - имя Вебинара, id трансляции которого нужно найти webinar_date - дата проведения трансляции вида D.M.Y, где D - число, M - месяц, Y - год. Также можно использовать current_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 дня до текущей даты в 18:00 и вебинар назывался Second webinar. В случае если вебинар, соответствующий параметрам, был в списке, то функция вернет в переменную broadcast_id id найденного вебинара, а если такого вебинара не найдено, то в переменную будет помещен текст: No webinar with these parameters.