Бизон365

Интеграция с сервисом для проведения вебинаров

Подключение к сервису

Для того, чтобы подключить интеграцию с Бизон365, перейдите в раздел Интеграции - Добавить интеграцию - в списке выберите Bizon365.

Появится окно добавления интеграции:

Здесь нам нужно указать название. Любое удобное вам.

А также API-токен.

Где взять API-токен?

Перейдите в ваш аккаунт Бизон365, перейдите в раздел Вебинары, откройте пункт Модераторы, сотрудники.

Добавьте сотрудника или выберите уже существующего. Затем нажмите на кнопку "Изменить данные и настроить доступ".

В открывшемся окне проверьте, чтобы тип учетной записи был Администратор. Нажмите "генерировать" API-токен. Затем скопируйте его из появившегося поля.

Не забудьте сохранить изменения в этом окне, иначе токен не сохранится и нужно будет проделывать операцию заново.

Затем переходим в BotHunter и вставляем в поле API-токен сохраненный ключ:

Как создавать правильную ссылку на вебинар?

Первый шаг: нужно зайти в в комнату, на которую будем создавать ссылку, затем пункт Доступ - в поле свой URL-параметр вставьте значение thm

Не забудьте сохранить все настройки.

Далее, перейдите в комнату и скопируйте адрес комнаты из адресной строки. У вас будет подобная ссылка:

https://start.bizon365.ru/room/123456/myroom

Нужно в конец ссылки добавить: ?thm={user_id}

Получаем ссылку такого вида:

https://start.bizon365.ru/room/123456/myroom?thm={user_id}

Эту ссылку можно отправлять вашим контактам через рассылки или боты. Таким образом вы сделаете ссылку, по которой мы дальше сможем отследить информацию по тому, заходил ли конкретный человек на вебинар. И другие возможные действия.

Возможности интеграции

Доступны следующие возможности:

  • Получить полный отчет — получает полный отчет по выбранному вебинару

  • Получить полный список зрителей — получает информацию по зрителям выбранного вебинара

  • Получить сообщения зрителя с вебинара — на выбранном вебинаре находит нужного человека и получает все его сообщения.

  • Проверить присутствие на вебинаре — находит нужного человека на выбранном вебинаре

  • Найти ключевое слово в сообщении у зрителя — на выбранном вебинаре находит нужного человека, получает его сообщения и находит там нужное нам ключевое слово

  • Найти всех, кто написал ключевое слово — на выбранном вебинаре находит всех, кто написал нужное нам ключевое слово

Поля в действии интеграции

В чем искать

В каком вебинаре искать нужного зрителя

  • Недавний вебинар — искать по самым свежим вебинарам.

  • Вебинар по дате — можно указать определенную дату, в которую проходил вебинар, для которого нужно получать информацию.

Какую информацию получить

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

  • Всю основную — получить данные (указаны в скобках)

  • Получить свой URL параметр — получает значение из url параметра для каждого зрителя. Удобно для того, чтобы получить vk_uid всех зрителей (если вы делали передачу vk_uid по инструкции)

Номер вебинара

Доступно при выборе метода «Поиск по недавнему вебинару».

  • 1 с конца (самый недавний) — получаем отчет по самому «свежему» вебинару из полученного списка

  • 2 с конца — получаем отчет по второму с конца вебинару из полученного списка

  • 3 с конца — получаем отчет по третьему с конца вебинару из полученного списка

Как искать

По каким типам вебинаров произвести поиск

  • Все вебинары — ищем и по живым, и по автовебинарам

  • Только живые — ищем только по списку живых вебинаров

  • Только автовебинары — ищем только по списку автовебинаров

Дата вебинара и время вебинара

Поля, которые доступны при выборе метода «Поиск вебинара по дате».

  • Дата вебинара — указывайте дату в формате 2020.02.03 (обязательно через точку). Расшифровка — 2020 год, февраль, 3 число.

  • Время начала вебинара — время начала по Бизону. Формат 20:01:00. Расшифровка — 20 часов 1 минута 0 секунд

ID комнаты

Указывайте ID комнаты из Бизон365, по которой будем искать нужные вебинары. Если поле пустое — ищем по всем комнатам.

ID комнаты можно найти тут:

Сюда можно вписать id человека, которого будем искать (например, через переменную {user_id}. Сработает, при условии, что человек зашел по ссылке, подобной той, которая создана по этой инструкции. Поиск идет именно по полю «Свой url-параметр».

Тип поиска и Ключевое слово

Работают аналогично одноименным блокам условий.

Подробная информация:

Дополнительные поля поиска

  • Показать ещё поля для поиска — покажет поля «Телефон», «Email», «Имя» для более детального поиска по разным критерям

  • Не показывать — скрывает дополнительные поля поиска, если они не нужны в работе

Важно понимать: дополнительные поля лучше всего заполнять полностью (поле «Имя» только в крайнем случае) — поиск идет до первого совпадения с любым из полей

Данные в источнике

Можно указать любые данные, которые нужно будет искать в ссылке-источнике перехода зрителя. Например, если вы хотите найти того, кто пришел с telegram — укажите там telegram.

Телефон

Можно указать телефон клиента для поиска. Поиск начинается с 9. То есть телефоны, начинающиеся с +7, 8, 7, 9 — идентичны и найдутся успешно, если остальные символы совпадают.

Email

Можно указать email клиента для поиска. Поиск идет до точного соответствия символ в символ

Имя зрителя

Самый ненадежный тип поиска, потому что люди могут указать что угодно при входе в вебинарную комнату. Регистронезависимый поиск. До полного совпадения.

Важно: если указано имя «Любовь», то имя «Любовь Иванова» будет считаться успешным поиском. Даже если далее по списку есть «Любовь Васильева».

Вывести отчет в текст

При выбранном варианте «Да» — переводит максимально возможную информацию в текстовый вид в виде сообщения. Получить информацию по нему можно через переменную {%i.text%}

Внимание: в ВК ограничение на количество символов в сообщении. Не более 4000 символов. Если в {%i.text%} получилось больше — оно не отправится.

Возвращаемые значения

{%i.result%} - результат выполнения действия

{%i.text%} - результат выполнения действия в текстовом виде (если запрошено)

{%i.textlen%} - длина (количество символов) результата в текстовом виде (если запрошено). Можно использовать для проверки влезет ли отчет в сообщение, или нет.

Важная информация

Будьте внимательны, в сервисе Бизон365 отчеты о вебинарах могут создаваться не сразу же после окончания.

Last updated