Гайды
March 3, 2023

Мини документация по шаблону вебинара livedigital в Salebot

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

Логотип livedigital

Одно из его преимуществ:

Вы можете получить информацию о пользователе, был ли он на вебе, еще до его окончания!


Оглавление


1. Настройка шаблона вебинара livedigital в Salebot

1.1) Подготовка

1. Если не зарегистрированы, зарегистрируйтесь в сервисе Salebot.

2. После входа нажмите "Создать проект"

3. Введите название проекта

4. Введите промокод plavko_promo и получите 7 дней бесплатного доступа вместо 3х!

Нажмите "Проверить промокод", чтобы убедиться, что вы ввели все правильно.
Должно появиться всплывающее уведомление "Промокод действующий"

5. Нажмите "Готово"

6. В открывшемся окне посмотрите влево и перейдите в "Резервная копия"


7. Пролистните в самый низ, до "Восстановление из файла"

8. Скачайте файл с гугл-диска по ссылке -> ПЕРЕЙТИ

9. Загрузите сохраненный файл sample_livedigital через перетаскивание или выбор файла в область, которая указана серым цветом и нажмите "Восстановить"

10. У вас обновится страница, после чего вам необходимо перейти по кнопке в левом меню, сверху "Конструктор воронок"

11. На этом этапе, если у вас все прошло хорошо - вы должны увидеть следующие блоки, как на скриншоте ниже:


1.2) Подключение livedigital.

1. Зарегистрируйтесь в сервисе livedigital -> ССЫЛКА

2. Создайте Space, если у вас его еще нет

3. Воспользуйтесь комнатой по умолчанию или создайте новую через наведение на кнопку "Создать виртуальную комнату" и нажмите на "Новый вебинар"

4. В появившемся окне введите название комнаты и выберите то, что вам необходимо запрашивать у пользователя

5. Вверху нажмите "Интеграция". Если у вас такой кнопки нет, вам необходимо приобрести платный тариф.

6. В открывшемся окне, найдите "Персональные токены" и нажмите кнопку "Создать"

ВАЖНО:

Сохраните сразу куда-нибудь этот токен, так как вы не сможете больше его посмотреть и вам придется создавать его заново.
Например, сразу вставить в следующем пункте

7. Нажмите на самый верхний блок, который еще является темно-серым и на котором написано "!Запустить первым!".

7.1. Пролистните справа открывшееся меню до "Калькулятор" (он тоже листается колесом мыши) и найдите 6ю строку с livedigital_access_token. Вставьте в двойные кавычки, вместо короткого набора символов, ваш большой набор

8. Не забудьте нажать "Сохранить" внизу меню блока

9. Чтобы получить необходимые данные дальше, откройте обратно Виртуальные комнаты и нажмите на кнопку "Войти в комнату" для нужного вебинара

10. Скопируйте после .../room/ в ссылке, набор символов, например как на скриншоте ниже

10.1. Вставьте их в двойные кавычки в livedigital_alias вместо символов

11. Не забудьте нажать "Сохранить" внизу меню блока

12. Нажмите на кнопку слева снизу (под картой) "Протестировать бота бесплатно"

13. Отправьте текст: update/add settings

Если все хорошо, то вам придет space_id и room_id с подобными параметрами. Их вставлять никуда не нужно, они автоматически встроятся в систему.

Обязательно протестируйте бота, прежде чем запускать вебинар.

Возможная проблема:
1. не формируется пригласительная ссылка



2. Получение индивидуальной ссылки для каждого пользователя

Индивидуальная ссылка формируется в блоке "Выдача индивидуальной ссылки".

Если у вас есть проблема с тем, что не формируется индивидуальная ссылка -> КЛИК

В параметры, которые вы можете без проблем поменять, входят:

  1. username - Имя пользователя, которое будет указываться, когда он будет заходить на вебинар. Использую full_name, чтобы было понятно, как зовут пользователя, но вы можете и использовать любое другое пользовательское поле.
  2. externalUserId - значение, с помощью которого я определяю пользователя на вебинаре. Задается текстом. В данном случае использую client_id.
    Важно: если вы измените это поле, вам необходимо будет поменять параметр в блоке "Получение данных о пользователе". См. фото Выгрузка аналитики
  3. ttl - Время жизни ссылки. Задается числом в секундах. У меня в шаблоне стоит 2 часа.

3. Выгрузка аналитики по каждому пользователю

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

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

Из того, что вам надо знать - информация о пользователе сохраняется в поле клиента livedigital_user_call_data в виде массива словарей

Также я использую этот параметр для проверки наличия пользователя в стрелке через регулярное выражение.


4. Описание полей пользователя, которые находятся в получаемых данных из аналитики

Просто текст для тестового оповещения и показа всех данных

Довольно много информации о пользователе.
Некоторые интересные моменты:

1. Можно смотреть через что заходил пользователь,
2. Какие ставил реакции,
3. Включал ли камеру/микрофон,
4. Сколько было активно окно открыто,
5. Дата и время подключения и отключения,
6. Получить статистику по чату и количество сообщений, которые он написал

Подробное описание полей:

  1. clientUniqueId - Уникальный id пользователя
  2. userName - Имя пользователя
  3. participantId - Внутренний временный ID клиента
  4. externalUserId - id, по которому можно делать поиск в аналитике
  5. email - Почта пользователя
  6. phone - Телефон пользователя
  7. deviceType - Устройство, с которого зашел пользователь
  8. deviceModel - Модель устройства
  9. platform - Операционная система
  10. platformVersion - Версия операционной системы
  11. browser - Браузер, с которого зашел пользователь
  12. browserVersion - Версия браузера
  13. referer - Ссылка на сайт с которого перешел пользователь
  14. totalOnlineDuration - Суммарное время онлайн на вебе (в секундах)
  15. totalOnlineDurationWithActiveTab - Суммарное время онлайн с активным окном (открыто было явно)
  16. totalActiveMicrophoneDuration - Время, сколько был с включенным микрофоном (для конференций только)
  17. totalActiveCameraDuration - Время, сколько был с включенной камерой (для конференций только)
  18. reactionsCount - Всего количество реакций которое отправил пользователь
  19. thumbUpCount - Количество нажатий на реакцию “палец вверх”
  20. thumbDownCount - Количество нажатий на реакцию “палец вниз”
  21. heartCount - Количество нажатий на реакцию “сердечко”
  22. fireCount - Количество нажатий на реакцию “огонек”
  23. connectionDate - дата и время, когда зашел в комнату
  24. lastOnlineDate - дата и время, когда вышел из комнаты
  25. chatMessages - массив сообщений пользователя в чате
  26. chatMessagesCount - количество сообщений пользователя

5. Подключить файл для формирования пригласительной ссылки

1. Перейти по ссылке и скачать файл -> СКАЧАТЬ

2. Загрузить файл в серый блок "НЕ УДАЛЯТЬ" и нажать "Сохранить"

3. Нажать внизу "Протестировать бота бесплатно"

4. В открывшемся окне ввести get_python_post_link и нажать ентер.

5. Скопировать новую ссылку (выделена синим) в блок "Выдача инвайт ссылки"

Текст, который приходит от тестового бота

6. Вставляем вместо другой ссылки новую

Старая ссылка
Новая ссылка

Не забываем нажать СОХРАНИТЬ!



Для продвинутых

Ссылка на сваггер по работе с API -> ССЫЛКА



Будут вопросы - пишите мне -> Михаил Плавко