Salebot.pro
Search…
Бизон 365
Это единая платформа для вебинаров, онлайн-курсов, тестов, продаж и приёма платежей.
Интеграция с bizon365 позволяет:
    проверить, посетил ли клиент вебинар;
    записать клиента на вебинар через чат-бот.
    получать вебхук от сервиса при записи клиента на вебинар (при условии, что на странице записи на вебинар запрашивается номер телефона или регистрация произошла через чат-бот или для регистрации использовалась специально сформированная ссылка из чат-бота)

Настройки на стороне bizon365

Получение токена

Токен необходимо получить в интерфейсе системы bizon365, в разделе «Модераторы, сотрудники» у конкретного пользователя, у которого есть права на регистрацию пользователей и просмотр отчетов.
После получения токена, переходим в настройки проекта -> Переменные проекта и сохраняем его в переменную bizon365_token

Добавление адреса для вебхука

В настройках вашего проекта в Salebot необходимо сгенерировать и скопировать ключ доступа к АПИ (токен). Этот ключ используйте для формирования адреса для вебхуков:
https://chatter.salebot.pro/bizon_webhook/<Ваш ключ к АПИ>, где вместо <Ваш ключ к АПИ> вставляете полученный в настройках ключ.
Далее этот адрес необходимо использовать в настройках Страниц регистрации системы bizon365, в поле Пересылка данных (webhook). Смотрите скриншоты 10-11.
В поле Маркер из URL вводим salebot:

Рекомендуемый способ

Чтобы не нагружать пользователя лишними вводами обязательных данных (телефон, емейл), можно просто отправить пользователю ссылку на нужный вебинар с добавлением специального параметра, в котором передается идентификатор пользователя в salebot.
Для этого достаточно перейти в настройки нужной вебинарной комнаты, вкладка Доступ и в поле Свой URL-параметр написать salebot
Отключаем обязательный ввод емейл и телефона (если не нужен), сохраняем настройки и переходим к формированию ссылки.

Формирование ссылки на вход в вебинарную комнату

Для формирования ссылки для перехода в вебинарную комнату, копируем ссылку нужной комнаты из списка вебинарных комнат в bizon365.
И к ссылке нужно дописать следующее: ?salebot=#{client_id}
В salebot готовая ссылка для отправки клиенту должна получиться следующая: https://start.bizon365.ru/room/222222/kfg1h3jf4t?salebot=#{client_id}
При переходе по такой ссылке, пользователь попадет на вебинар.
И после окончания вебинара и получения по нему отчета, можно проверить посетил ли этот клиент данный вебинар используя функцию bizon365_is_visitor() (смотреть описание ниже).

Формирование ссылки на вход в вебинарную комнату с предзаполненными параметрами

Для перехода в вебинарную комнату ссылка с предзаполненными параметрами пользователя формируется из общей ссылки на вход следующим образом:
https://start.bizon365.ru/222222/kfg1h3jf4t?salebot=#{client_id}&phone=#{bizon_phone}&email=#{bizon_email}&username=#{name}
https://start.bizon365.ru/222222/kfg1h3jf4t?salebot=#{client_id}&email=#{bizon_email}&username=#{name}
Индивидуальные ссылки на вебинар такой функционал не поддерживают. Общая ссылка для входа указана в Бизоне в настройках комнаты на вкладке Общие. Где:
#{client_id} - переменная, в которой содержится идентификатор клиента в salebot;
#{bizon_phone} - переменная, в которой содержится номер клиента (у вас она может называться иначе);
#{bizon_email} - переменная, в которой содержится имейл клиента (у вас она может называться иначе);
#{name} - переменная, в которой содержится имя клиента (у вас она может называться иначе).
Обязательным параметром является salebot=#{client_id}, остальное по надобности.
При переходе по такой ссылке, пользователь попадет на вебинар.
И после окончания вебинара и получения по нему отчета, можно проверить посетил ли этот клиент данный вебинар используя функцию bizon365_is_visitor() (смотреть описание ниже).
Чтобы ссылка, отправляемая клиенту не была слишком громоздкой, ее можно укоротить. Например, поместить в качестве вложения с уведомлением о клике (в настройках блока) или воспользоваться функцией калькулятора proxy

Формирование ссылки для регистрации на вебинар используя страницу регистрации

При регистрации по такой ссылке, клиенту придет колбек уведомление (описание ниже), при условии, что была произведена настройка вебхука, на которое можно поставить реакцию, например отправить информационное сообщение.
Переходим в личный кабинет в бизон -> Страницы регистрации -> Настроить:
И копируем одну из ссылок Адрес страницы:
И к ссылке нужно дописать следующее: ?salebot=#{client_id}
В salebot готовая ссылка для отправки клиенту должна получиться следующая: https://start.bizon365.ru/page/222222/yourpage?salebot=#{client_id}
или
http://yourpage.222222.bizonpages.ru?salebot=#{client_id}
На скриншоте вы видите пример того, как будут выглядеть ссылки:
После успешной регистрации, клиента можно найти в бизоне на странице подписчиков.

Регистрация на вебинар из чат-бота

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

Вариант 1 - задать нужные переменные

До вызова функции у клиента должны быть переменные, данные из которых, функция подтянет автоматически.
Обязательные переменные:
    1.
    email - электронная почта подписчика
    2.
    b365_page_id - Идентификатор страницы регистрации в Бизоне. (пример 222222:page1)
    3.
    b365_date - дата вебинара в формате ДД.ММ.ГГГГ (пример 16.09.2021)
    4.
    b365_time - время вебинара в формате: ЧЧ:ММ (пример 12:00)
    5.
    phone - 79111111111
    6.
    utm_ - UTM метки можете заполнить вашими метками
Дополнительные, необязательные переменные:
    1.
    phone - 79111111111
    2.
    utm_ - UTM метки можете заполнить вашими метками
Пример переменных:
    phone = 79111111111
    b365_page_id = 222222:page1
    b365_date = 16.09.2021
    b365_time = 12:00
    utm_ = {"utm_source": "12345", "utm_medium": "", "utm_campaign": "333", "utm_term": "", "utm_content": "", "utm_keyword": "", "utm_banner": "6666", "utm_phrase": "", "utm_group": ""}
    Если нужно добавить подписчика в режиме "с подтверждением e-mail" (так, как если бы он сам заполнил форму регистрации). Ему на почту придет письмо со ссылкой на подтверждение регистрации, то нужно при вызове функции передать 1 - bizon365_add_subscriber(1)

Вариант 2 - передать параметры

Второй вариант записи на вебинар предусматривает передачу данных сразу в параметрах функции.
bizon365_add_subscriber(подтверждение емейл, идентификатор страницы, дата вебинара, время вебинара, емейл, телефон, utm метки)
Важен порядок передаваемых данных!
Обязательные параметры:
    подтверждение емейл - 1 нужно подтверждение, 0 - не нужно
    идентификатор страницы
    дата в формате ДД.ММ.ГГГГ (пример 16.09.2021)
    время вебинара в формате: ЧЧ:ММ (пример 12:00)
    емейл
Телефон и utm метки передавать по необходимости (если телефон не передается, а utm-метки передаются, тогда телефон необходимо передать).
Пример вызова функции:
result = bizon365_add_subscriber(1, '222222:page1', '16.09.2021', '12:00', '[email protected]', '79111111111', '{"utm_source": "12345", "utm_medium": "", "utm_campaign": "333", "utm_term": "", "utm_content": "", "utm_keyword": "", "utm_banner": "6666", "utm_phrase": "", "utm_group": ""}')
Функция возвращает True при успешном добавлении или сообщение с пояснением, что пошло не так (например при отсутствии обязательных переменных: Missing required variables).

Идентификатор страницы

После успешной регистрации, клиента можно найти в бизоне на странице подписчиков.

Колбек при успешной регистрации

После получение колбека о регистрации, если клиент зарегистрирован не через бота, поиск нужного клиента в сейлбот происходит следующим образом.
Если в колбеке от бизон365 получен и номер телефона и емейл:
Сначала по всем переменным клиента ищется номер телефона, если клиент не найден, то ищется по всем переменным email. Если и после этого клиент не найден, а номер телефона есть, то добавляется вотсап клиент (если к проекту подключен Вотсап).
Если клиент найден, то ему автоматически добавятся следующие переменные:
    bizon_sublist_id — идентификатор страницы регистрации
    bizon_room — идентификатор комнаты, которая подключена к странице регистрации
    bizon_email: "[email protected]",
    phone — телефон пользователя
    bizon_webinar_datetime: "2021-09-16T09:00:00.000Z", — дата вебинара, на который зарегистрирован зритель
    bizon_webinar_time
    bizon_webinar_date
    bizon_secret, — персональный ключ подписчика, для формирования индивидуальных ссылок на вебинар
    bizon_url_marker — значение маркера
    bizon_url_marker_name — название маркера
    bizon_utm_source
    bizon_utm_medium
    bizon_utm_campaign
    bizon_utm_term
    bizon_utm_content
    bizon_utm_keyword
    bizon_utm_banner
    bizon_utm_phrase
    bizon_utm_group
Если клиент найден в сейлбот, то в чат с ним придет сообщение (уведомление) bizon client_registered, которое видит только оператор в сейлбот.
По этому уведомлению можно отправить сообщение клиенту или отправить его по воронке в нужное место.
Чтобы отправить клиенту благодарственное сообщение при регистрации на вебинар, надо ввести в поле Условие блока с Первостепенной проверкой условия следующий текст:
bizon client_registered
Пример показан на скриншоте ниже.

Проверка посещения вебинара

Работает только на тарифе "Премиум"
Если вы планируете проверять посещение вебинара и по номеру телефона, надо в настройках комнаты вебинара в разделе "Доступ" включить обязательный запрос номера телефона:
Чтобы проверить, посетил ли клиент вебинар, нужно вызвать функцию bizon365_is_visitor(), доступно 2 варианта использования функции.

Вариант 1 - задать нужные переменные

До вызова функции у клиента должны быть переменные, данные из которых, функция подтянет автоматически.
Если в вашем проекте все переходы и регистрации на вебинар происходят с использованием параметра salebot в ссылке (?salebot=#{client_id}), тогда телефон и email передавать не нужно. Дату и время лучше указать, так как это гарантирует точное нахождение нужного отчета.
Обязательные переменные:
    email - электронная почта подписчика
    phone - 79111111111
    b365_room_id - Идентификатор страницы регистрации в Бизоне. (пример 222222:page1)
Можно передать оба значения емейл и телефон или одно значение (либо емейл, либо телефон). Если передаете одно значение, то второе нужно заменить на 1
Дополнительные (желательные) переменные:
b365_date - дата вебинара в формате ДД.ММ.ГГГГ (пример 16.09.2021) b365_time - время вебинара в формате: ЧЧ:ММ (пример 12:00)
Если не передать дату и время, то из указанной комнаты будет взят последний сформированный отчет вебинара!
Пример переменных: phone = 79111111111 email = [email protected] b365_room_id = 55555:SW90YzV0d b365_date = 13.09.2021 b365_time = 15:00
Далее можно вызвать функцию

Вариант 2 - передать параметры

Для записи на вебинар необходимо сразу в функцию передать нужные параметры.
bizon365_is_visitor(ID комнаты, емейл, телефон, дата вебинара, время вебинара)
Важен порядок передаваемых данных!
Обязательные параметры:
    ID комнаты
    емейл
    телефон
Дополнительные (желательные) параметры:
    дата вебинара в формате ДД.ММ.ГГГГ (пример 16.09.2021)
    время вебинара в формате: ЧЧ:ММ (пример 12:00)
Если не передать дату и время, то из указанной комнаты будет взят последний сформированный отчет вебинара!
Пример вызова функции
result = bizon365_is_visitor('55555:SW90YzV0i', '[email protected]', '79111111111', '12.09.2021', '19:00')
Можно передать оба значения емейл и телефон или одно значение (либо емейл, либо телефон). Если передаете одно значение, то второе нужно заменить на 1
Пример вызова функции, только с емейлом
result = bizon365_is_visitor('55555:SW90YzV0i', '[email protected]', '1', '12.09.2021', '19:00')
Пример вызова функции, только с телефоном
result = bizon365_is_visitor('55555:SW90YzV0i', '1', '79111111111', '12.09.2021', '19:00')
Функция возвращает:
    True - клиент был на вебинаре,
    False - клиент не был на вебинаре
    или сообщение с пояснением, что пошло не так (например отчет не найден: Report not found).
Если клиент найден, то в переменную b365_viewer запишется все информация по нему, которую возвращает bizon365. Пример:
{"playVideo":1,"email":"[email protected]","phone":"+7911111111","username":"Дарий","url":"https:\/\/start.bizon365.ru\/room\/222222\/SW45zV0d","ip":"111.111.111.6","mob":true,"useragent":"Android, Chrome 91.0.4472.111","referer":"","cv":null,"cu1":"","p1":"","p2":"","p3":"","roomid":"222222:SW45YzV0d","chatUserId":"SeURFjsft","city":"Краснодар","country":"RU","region":"Краснодарский край","tz":"","created":"2021-09-12T16:24:48.125Z","webinarId":"222222:SW45YzV0d*2021-09-12T19:00:00","view":1631463887082,"viewTill":1631464786805,"messages_num":0}
Эти данные можно сохранить, в поле “Назначение переменных”, используя функцию get, например:
    city = get(b365_viewer, 'city')
    email = get(b365_viewer, 'email')
Все возможные данные и их обозначения, которые могут быть в переменной b365_viewer, можно посмотреть перейдя по ссылке: https://blog.bizon365.ru/api/v1/webinars/reports/#getviewers . Они указаны после строки “Поле viewers — это массив, состоящий из объектов следующего формата:".

Регистрация на вебинар, используя страницу регистрации

Если клиент попал на страницу регистрации не по ссылке из чат-бота, а, например, из рекламы, тогда можно создать с ним диалог, используя его номер телефона и бота whatsapp.
После регистрации в salebot придет уведомление, и поиск клиента будет происходить за следующим сценарием:
    1.
    вначале по всем переменным клиента ищется номер телефона, если клиент не найден,
    2.
    то ищется по всем переменным email,
    3.
    если и после этого клиент не найден, а номер телефона есть, то добавляется вотсап клиент (если к проекту подключен Вотсап).

Добавление номера телефона в формы

В сервисе bizon365 есть две основные формы: форма записи на вебинар и форма входа на вебинар. Чтобы работала функция вебхука, в чат-бот необходимо получить номер телефона пользователя в форме регистрации на вебинар. А чтобы работала проверка посещения вебинара, необходимо получить номер телефона пользователя в форме входа на вебинар.
Запрос номера телефона в форме регистрации возможен, только если вы используете собственную страницу (свой сайт), на которую вставлен виджет с кодом из стандартной страницы регистрации. В коде необходимо исправить phone:0 на phone:1. Пример на скриншотах ниже.
Запрос номера телефона в форме входа на вебинар настраивается в настройках вебинара. Там нужно перейти в раздел Доступ и поставить птички в полях "Номер телефона" и "Обязательное поле", как показано на скриншотах.
Last modified 24d ago