Эта инструкция показывает настройку отчётов после вебинара. Все варианты передачи данных в 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», скопируйте токен заново, без лишних пробелов.
Где взять токен: в личном кабинете TeleBoss откройте Настройки → Интеграции → API токен и скопируйте значение.
Шаг 2. Скопируйте адрес для отчётов
1 Откройте ссылки базы
В левом меню выберите Базы, найдите нужную базу и нажмите Ссылки.
2 Перейдите на вкладку «Отчёты с вебинара»
На странице «Ссылки для приёма данных» выберите вкладку Отчёты с вебинара.
3 Скопируйте адрес из блока «Для отчетов с TeleBoss»
Нажмите Копировать. Адрес выглядит так: https://vakas-tools.ru/base/teleboss_report/ваш-код/номер-базы/.
Шаг 3. Укажите адрес в TeleBoss
1 Откройте интеграции TeleBoss
В личном кабинете TeleBoss перейдите в раздел Интеграции.
2 Вставьте адрес в поле «WebHook URL»
Вставьте скопированную ссылку и сохраните настройки.
Вебхук действует на весь аккаунт TeleBoss. Отчёты по всем комнатам и группам будут приходить в ту базу, адрес которой вы указали. Если эфиры разных проектов нужно разводить по разным базам, используйте распределитель (раздел ниже).
Шаг 4. Проверьте, что отчёт пришёл
После завершения первого эфира откройте раздел Базы и в карточке нужной базы нажмите TeleBoss (строка «Последние отчёты»). Откроется список эфиров из вашего аккаунта TeleBoss за последние 60 дней: дата начала и название комнаты.
| Что показано напротив эфира | Что это значит |
|---|---|
| «есть в базе» и «Данные пришли в …» | Уведомление от TeleBoss получено, эфир поставлен на загрузку. Указано время, когда пришёл вебхук. |
| «загрузка данных» | Зрители ещё загружаются. Обычно это занимает несколько минут. |
| «Перезагрузить» | Загрузка завершена. Ссылка заново забирает отчёт из TeleBoss, если зрителей оказалось меньше, чем ожидалось. |
| «нет в базе» и кнопка «Добавить» | Уведомление по этому эфиру не приходило, например вебхук настроили позже. Нажмите Добавить, чтобы загрузить отчёт вручную. |
Через кнопку «Добавить» можно забрать отчёты по эфирам, которые прошли до настройки вебхука: в списке есть все эфиры за последние 60 дней.
Видео-инструкция
Инструкция на Rutube
Какие данные приходят по каждому зрителю
| Данные | Описание |
|---|---|
| Имя | Имя, под которым зритель вошёл в комнату |
| 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 вместо адреса базы.
Условия проверяются по порядку сверху вниз, отчёт уходит в базу первого подошедшего условия. Если ни одно условие не подошло, отчёт попадёт в базу, указанную в самом распределителе.