Документация / Отчеты с вебинара / Как настроить выгрузку отчётов TeleBoss в Vakas-tools

Как настроить выгрузку отчётов TeleBoss в Vakas-tools

telebossотчеты
Также в разделах: Teleboss

Эта инструкция показывает настройку отчётов после вебинара. Все варианты передачи данных в CRM, LMS, таблицы и рассылки собраны на странице интеграций TeleBoss.

Как это работает

TeleBoss сам сообщает Vakas-tools о каждом завершённом эфире, а Vakas-tools забирает по API список зрителей и записывает их в базу как отчёт с вебинара. Дальше с этими зрителями работают правила вкладки «Отчёты»: отправка в CRM, GetCourse, рассылки, SMS и другие подключённые сервисы.

1 Проводится эфир в TeleBoss

2 Эфир завершается

TeleBoss отправляет уведомление на адрес приёма отчётов Vakas-tools.

3 Vakas-tools забирает список зрителей

По персональному токену запрашивает у TeleBoss отчёт по этому эфиру: кто подключался, сколько был, что писал в чат.

4 Зрители попадают в базу

Контакт находится по email или создаётся заново. К нему добавляется отчёт с вебинара.

5 Срабатывают правила

Для каждого зрителя выполняются действия правил вкладки «Отчёты».

Отчёт строится только после завершения эфира. Пока трансляция идёт, данные не приходят. Уведомления TeleBoss о других событиях (начало эфира, вход участника) Vakas-tools принимает, но не обрабатывает.

Что понадобится

  • Действующий тариф Vakas-tools. Если тариф не оплачен, TeleBoss получит ответ «Не активен тариф» и отчёт не загрузится.
  • База, в которую будут приходить зрители. Если базы ещё нет, создайте её по инструкции.
  • Персональный токен TeleBoss (API-токен из личного кабинета TeleBoss).
  • Доступ к разделу «Интеграции» в TeleBoss, чтобы указать адрес вебхука.

Шаг 1. Подключите TeleBoss к Vakas-tools

1 Откройте страницу подключения

В левом меню выберите Сервисы и доступы. На странице «Добавить новый сервис» в разделе Вебинарные площадки нажмите карточку TeleBoss.

2 Вставьте персональный токен

В поле Персональный токен вставьте API-токен из личного кабинета TeleBoss и нажмите Сохранить.

3 Проверьте подключение

После сохранения на странице должна появиться надпись «TeleBoss подключен верно». Если видите «Не удается авторизоваться в TeleBoss», скопируйте токен заново, без лишних пробелов.

Пункт «Сервисы и доступы» в левом меню Vakas-tools
Левое меню: «Сервисы и доступы»
Страница «Добавить новый сервис», раздел «Вебинарные площадки», карточка TeleBoss
Раздел «Вебинарные площадки»: карточка TeleBoss
Страница «Доступ к TeleBoss»: поле «Персональный токен» и надпись «TeleBoss подключен верно»
После сохранения токена: «TeleBoss подключен верно»

Где взять токен: в личном кабинете TeleBoss откройте Настройки → Интеграции → API токен и скопируйте значение.

Шаг 2. Скопируйте адрес для отчётов

1 Откройте ссылки базы

В левом меню выберите Базы, найдите нужную базу и нажмите Ссылки.

2 Перейдите на вкладку «Отчёты с вебинара»

На странице «Ссылки для приёма данных» выберите вкладку Отчёты с вебинара.

3 Скопируйте адрес из блока «Для отчетов с TeleBoss»

Нажмите Копировать. Адрес выглядит так: https://vakas-tools.ru/base/teleboss_report/ваш-код/номер-базы/.

Раздел «Базы» и страница «Ссылки для приёма данных»
Базы → Ссылки: страница «Ссылки для приёма данных»
Вкладка «Отчёты с вебинара» на странице ссылок базы
Вкладка «Отчёты с вебинара»
Блок «Для отчетов с TeleBoss» с кнопкой «Копировать»
Блок «Для отчетов с TeleBoss»: скопируйте адрес

Шаг 3. Укажите адрес в TeleBoss

1 Откройте интеграции TeleBoss

В личном кабинете TeleBoss перейдите в раздел Интеграции.

2 Вставьте адрес в поле «WebHook URL»

Вставьте скопированную ссылку и сохраните настройки.

Вебхук действует на весь аккаунт TeleBoss. Отчёты по всем комнатам и группам будут приходить в ту базу, адрес которой вы указали. Если эфиры разных проектов нужно разводить по разным базам, используйте распределитель (раздел ниже).

Шаг 4. Проверьте, что отчёт пришёл

После завершения первого эфира откройте раздел Базы и в карточке нужной базы нажмите TeleBoss (строка «Последние отчёты»). Откроется список эфиров из вашего аккаунта TeleBoss за последние 60 дней: дата начала и название комнаты.

Что показано напротив эфира Что это значит
«есть в базе» и «Данные пришли в …» Уведомление от TeleBoss получено, эфир поставлен на загрузку. Указано время, когда пришёл вебхук.
«загрузка данных» Зрители ещё загружаются. Обычно это занимает несколько минут.
«Перезагрузить» Загрузка завершена. Ссылка заново забирает отчёт из TeleBoss, если зрителей оказалось меньше, чем ожидалось.
«нет в базе» и кнопка «Добавить» Уведомление по этому эфиру не приходило, например вебхук настроили позже. Нажмите Добавить, чтобы загрузить отчёт вручную.

Через кнопку «Добавить» можно забрать отчёты по эфирам, которые прошли до настройки вебхука: в списке есть все эфиры за последние 60 дней.

Видео-инструкция

Инструкция на Rutube

Какие данные приходят по каждому зрителю

Данные Описание
Имя Имя, под которым зритель вошёл в комнату
Email Email зрителя, если он указал его при входе
Был на вебинаре Да. В отчёт попадают только те, кто подключался к эфиру
Сколько минут Время от подключения до последней активности в комнате
Смотрел с / до Время подключения и время последней активности
Комментарии Сообщения зрителя в чате эфира, каждое с временем отправки

Зритель попадает в базу только при наличии email. Если участник вошёл в комнату по ссылке и указал одно имя, Vakas-tools не сможет найти или создать контакт, и такой зритель в отчёт не попадёт. Контакт ищется по email в выбранной базе; если его нет, создаётся новый.

Чего в отчёте TeleBoss нет: телефона, кликов по кнопкам и баннерам, UTM-меток, города и признака «досмотрел до конца». Для зрителей TeleBoss эти поля остаются пустыми, поэтому условия вроде «Досмотрел до конца = 1» для них никогда не выполнятся. Отметка «зарегистрировался, но не пришёл» для эфиров TeleBoss тоже не ставится.

Передача зрителей в другие сервисы

После загрузки отчёта зрители обрабатываются правилами вкладки Отчёты в этой же базе. Для продолжения обучения используйте страницу TeleBoss + GetCourse: там показано, как создавать пользователей, распределять их по группам и сохранять активность. Для отдела продаж подходят связки TeleBoss + amoCRM и TeleBoss + Битрикс24. Затем создайте правило, при необходимости добавьте условие и выберите нужные действия. Подробности есть в общей инструкции по правилам.

Условия, которые работают для TeleBoss

Условие Кого отбирает
Был на вебинаре (1-Да,0-Нет) = 1 Все зрители эфира
Сколько был минут на вебинаре >= 30 Те, кто был в эфире не меньше получаса
Комментарии на вебинаре содержит «хочу» Те, кто написал в чат определённое слово

Шорткоды для действий

Шорткод Что подставится
{#name#} Имя зрителя
{#email#} Email зрителя
{#bil_minut#} Сколько минут был в эфире
{#comments#} Сообщения зрителя в чате
{#view_date#} Когда подключился (дата и время текстом)
{#viewTill_date#} Когда вышел (дата и время текстом)

Примеры правил

  • Все зрители в amoCRM. Вкладка «Отчёты», условие «Был на вебинаре = 1», действие amoCRM: создать или обновить контакт, добавить тег «был на эфире».
  • Доступ тем, кто досидел. Условие «Сколько был минут на вебинаре >= 60», действие GetCourse: добавить пользователя в группу «Смотрели эфир».
  • Сигнал о горячем зрителе. Условие «Комментарии на вебинаре содержит «цена»», действие Telegram: «{#name#}, {#email#}, был {#bil_minut#} мин, спрашивал про цену».

Отчёты из разных комнат в разные базы

Если в одном аккаунте TeleBoss идут эфиры разных проектов, отчёты можно разводить по базам через Распределитель. В TeleBoss при этом указывается один адрес, а Vakas-tools сам решает, в какую базу отправить отчёт, по группе или комнате эфира.

1 Создайте распределитель

В левом меню откройте Распределитель и нажмите + Добавить. В форме укажите название, в поле Сервис, с которого распределять выберите Отчеты TeleBoss, в поле Направлять в базу по умолчанию выберите базу, куда пойдут отчёты, не подошедшие ни под одно условие. Нажмите Добавить.

2 Добавьте условия

В строке распределителя нажмите Условия распределения, затем + Добавить. Укажите порядок выполнения, в поле Направлять в базу выберите базу для этого условия, в поле выберите Группа [spaceId] или Комната [roomId], условие = и в значение вставьте идентификатор. Идентификаторы групп и комнат вашего аккаунта показаны внизу этой же страницы в блоке «ID групп и комнат». Повторите для каждой базы.

3 Укажите адрес распределителя в TeleBoss

В списке распределителей нажмите Ссылки, скопируйте адрес вида https://vakas-tools.ru/redirect/teleboss/ваш-код/номер/ и вставьте его в TeleBoss в поле WebHook URL вместо адреса базы.

Раздел «Распределитель»: список распределителей и кнопка «Добавить»
Раздел «Распределитель», кнопка «+ Добавить»
Форма «Добавить новый распределитель»: название, сервис, база по умолчанию
Форма нового распределителя: сервис и база по умолчанию
Форма «Добавить новое условие»: база, поле «Группа [spaceId]», условие и значение
Условие распределения: база, поле «Группа [spaceId]», значение

Условия проверяются по порядку сверху вниз, отчёт уходит в базу первого подошедшего условия. Если ни одно условие не подошло, отчёт попадёт в базу, указанную в самом распределителе.

Частые вопросы

Эфир завершился, но отчёт не появился
Проверьте по порядку. На странице Сервисы и доступы → TeleBoss должна быть надпись «TeleBoss подключен верно». В TeleBoss в разделе Интеграции в поле WebHook URL должен стоять адрес именно этой базы или адрес распределителя. Тариф Vakas-tools должен быть действующим: при неоплаченном тарифе TeleBoss получает ответ «Не активен тариф». Если всё верно, откройте в базе страницу TeleBoss и загрузите эфир вручную кнопкой «Добавить».
В отчёте меньше зрителей, чем было в эфире
В базу попадают только зрители, у которых есть email. Участники, вошедшие в комнату по ссылке без почты, в отчёт не попадают. Кроме того, TeleBoss может отдавать полный список с задержкой: нажмите «Перезагрузить» напротив эфира через 10-15 минут.
Как загрузить отчёт по эфиру, который прошёл до настройки вебхука
Откройте в базе страницу TeleBoss: там показаны все эфиры за последние 60 дней. Напротив нужного нажмите «Добавить».
Зрители загрузились, но правила не сработали
Правила для отчётов создаются на вкладке «Отчёты» базы, а не на «Регистрации» или «Оплаты». Проверьте условия: поля «Досмотрел до конца», «Кликал по кнопке», UTM-метки и город для TeleBoss не заполняются, условия по ним не выполнятся. Результат каждой отправки виден в журнале правил базы.
Можно ли подключить несколько аккаунтов TeleBoss
Для отчётов используется одно подключение TeleBoss на аккаунт Vakas-tools: один персональный токен. Эфиры разных проектов внутри этого аккаунта можно разводить по базам распределителем.
TeleBoss получает ответ «Не правильная ссылка»
Адрес вебхука не совпадает с базой и её владельцем: он скопирован из другого аккаунта Vakas-tools или база удалена. Скопируйте адрес заново со страницы «Ссылки» нужной базы.
×