Дополнительный контент в виджете чата
Если вы установили виджет чата на страницу с UTM-метками, счетчиком Roistat, Google Analytics и другими инструментами веб-аналитики, то вы можете передавать эти данные в TextBack при обращении пользователя через виджет и использовать их в дальнейшей работе.
1
Включите сбор параметров в "Настройках показа" виджета чат
2
Готово - теперь параметры будут собираться.
Больше ничего в настройках виджета делать не требуется.
Работа с данными
Данные, которые собираются через виджет чата, пока не отображаются в интерфейсе личного кабинета TextBack - мы планируем добавить эту информацию в раздел "Аналитика" в будущих обновлениях платформы.
Сейчас вы можете обрабатывать дополнительный контент через наше API:
Сейчас вы можете обрабатывать дополнительный контент через наше API:
- С помощью GET-запросa на получение данных;
- С помощью вебхука.
GET-запрос
Выполните GET-запрос на адрес https://api.textback.io/api/endUserNotifications/subscriptions/endUserConversationStart
Запрос должен содержать API Token, подробнее - "Авторизация" и "Подготовка инструмента".
Метод вернет информацию по всем диалогам, где были обращения через виджет чата.
Запрос должен содержать API Token, подробнее - "Авторизация" и "Подготовка инструмента".
Метод вернет информацию по всем диалогам, где были обращения через виджет чата.
{
"$items": [
{
"id": "636AF933-DB86-94D0-CEDF-01725788D7BD",
"account_id": "BBCFD083-F5B1-4B06-A9EE-DEF3B6960F50",
"viewerId": "38710797-0DB3-4634-9901-5279E10F8037",
"widgetId": "3FBACE0C-4D05-4FC1-80D0-32E67C05AE6F",
"pageUrl": "https://alex-forumur.github.io/",
"pageTitle": "",
"referer": "",
"userAgentString": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36",
"urlParameters": "{}",
"cookies": "{\"tb_notif_widget_widgetUserId\":\"cd374417-de8a-4581-a92d-383f1967f076\",\"tb_notif_widget_300fb798-6586-3689-5217-0171f3049957_total_close_counter\":\"6\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_days_show_counter\":\"11\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_days_close_counter\":\"2\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_total_close_counter\":\"2\",\"roistat_first_visit\":\"100004\",\"roistat_visit\":\"100004\",\"roistat_visit_cookie_expire\":\"1209600\",\"roistat_is_need_listen_requests\":\"0\",\"___dc\":\"5fe211d4-8906-42e7-903e-e5588c448414\",\"roistat_marker_old\":\"null\"}",
"secureContext": "null",
"insecureContext": "{\"pageTitle\":\"\",\"pageUrl\":\"https://alex-forumur.github.io/\",\"params\":{},\"timezoneOffset\":-180,\"cookies\":{\"tb_notif_widget_widgetUserId\":\"cd374417-de8a-4581-a92d-383f1967f076\",\"tb_notif_widget_300fb798-6586-3689-5217-0171f3049957_total_close_counter\":\"6\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_days_show_counter\":\"11\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_days_close_counter\":\"2\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_total_close_counter\":\"2\",\"roistat_first_visit\":\"100004\",\"roistat_visit\":\"100004\",\"roistat_visit_cookie_expire\":\"1209600\",\"roistat_is_need_listen_requests\":\"0\",\"___dc\":\"5fe211d4-8906-42e7-903e-e5588c448414\",\"roistat_marker_old\":\"null\"},\"utmParams\":{},\"referer\":\"\",\"visitDate\":\"2020-05-27T19:03:40.702Z\",\"visitsCount\":43,\"sessionsCount\":{\"value\":1,\"timestamp\":1589889115436},\"currentEntrancePoint\":\"https://alex-forumur.github.io/\",\"userAgent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36\"}",
"visitsCount": 43,
"timezoneOffset": -180,
"visitDate": "2020-05-27T19:03:40.843Z",
"createdTs": "2020-05-27T19:08:05.438Z",
"channel": "vk",
"remoteAddress": "7414968",
"channelId": 12590,
"chatId": "7414968"
},
{
"id": "4863B29A-3046-4412-3A5F-017257B3C71F",
"account_id": "BBCFD083-F5B1-4B06-A9EE-DEF3B6960F50",
"viewerId": "38710797-0DB3-4634-9901-5279E10F8037",
"widgetId": "3FBACE0C-4D05-4FC1-80D0-32E67C05AE6F",
"pageUrl": "https://alex-forumur.github.io/",
"pageTitle": "",
"referer": "",
"userAgentString": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36",
"urlParameters": "{}",
"cookies": "{\"tb_notif_widget_widgetUserId\":\"cd374417-de8a-4581-a92d-383f1967f076\",\"tb_notif_widget_300fb798-6586-3689-5217-0171f3049957_total_close_counter\":\"6\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_days_show_counter\":\"11\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_days_close_counter\":\"2\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_total_close_counter\":\"2\",\"roistat_first_visit\":\"100004\",\"roistat_visit\":\"100004\",\"roistat_visit_cookie_expire\":\"1209600\",\"roistat_is_need_listen_requests\":\"0\",\"___dc\":\"5fe211d4-8906-42e7-903e-e5588c448414\",\"roistat_marker_old\":\"null\"}",
"secureContext": "null",
"insecureContext": "{\"pageTitle\":\"\",\"pageUrl\":\"https://alex-forumur.github.io/\",\"params\":{},\"timezoneOffset\":-180,\"cookies\":{\"tb_notif_widget_widgetUserId\":\"cd374417-de8a-4581-a92d-383f1967f076\",\"tb_notif_widget_300fb798-6586-3689-5217-0171f3049957_total_close_counter\":\"6\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_days_show_counter\":\"11\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_days_close_counter\":\"2\",\"tb_notif_widget_34998431-8099-3e65-3647-0172338f652e_total_close_counter\":\"2\",\"roistat_first_visit\":\"100004\",\"roistat_visit\":\"100004\",\"roistat_visit_cookie_expire\":\"1209600\",\"roistat_is_need_listen_requests\":\"0\",\"___dc\":\"5fe211d4-8906-42e7-903e-e5588c448414\",\"roistat_marker_old\":\"null\"},\"utmParams\":{},\"referer\":\"\",\"visitDate\":\"2020-05-27T19:03:40.702Z\",\"visitsCount\":43,\"sessionsCount\":{\"value\":1,\"timestamp\":1589889115436},\"currentEntrancePoint\":\"https://alex-forumur.github.io/\",\"userAgent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36\"}",
"visitsCount": 43,
"timezoneOffset": -180,
"visitDate": "2020-05-27T19:03:40.843Z",
"createdTs": "2020-05-27T19:54:59.465Z",
"channel": "facebook",
"remoteAddress": "2647285395346693",
"channelId": 7612,
"chatId": "2647285395346693"
},
{
"id": "D1289FCB-6A03-9C9C-676B-01725832E3B8",
"account_id": "BBCFD083-F5B1-4B06-A9EE-DEF3B6960F50",
"viewerId": "38710797-0DB3-4634-9901-5279E10F8037",
"widgetId": "3FBACE0C-4D05-4FC1-80D0-32E67C05AE6F",
"pageUrl": "https://alex-forumur.github.io/",
"pageTitle": "",
"referer": "",
"userAgentString": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36",
"urlParameters": "{}",
"cookies": "{\"tb_notif_widget_widgetUserId\":\"b937598a-984f-41bc-80d5-3b55062f19e6\",\"roistat_first_visit\":\"100005\",\"roistat_visit\":\"100005\",\"roistat_visit_cookie_expire\":\"1209600\",\"roistat_is_need_listen_requests\":\"0\",\"___dc\":\"24d90b33-3d56-4ecc-8588-cdec88e6ff58\",\"roistat_marker_old\":\"null\"}",
"secureContext": "null",
"insecureContext": "{\"pageTitle\":\"\",\"pageUrl\":\"https://alex-forumur.github.io/\",\"params\":{},\"timezoneOffset\":-180,\"cookies\":{\"tb_notif_widget_widgetUserId\":\"b937598a-984f-41bc-80d5-3b55062f19e6\",\"roistat_first_visit\":\"100005\",\"roistat_visit\":\"100005\",\"roistat_visit_cookie_expire\":\"1209600\",\"roistat_is_need_listen_requests\":\"0\",\"___dc\":\"24d90b33-3d56-4ecc-8588-cdec88e6ff58\",\"roistat_marker_old\":\"null\"},\"utmParams\":{},\"referer\":\"\",\"visitDate\":\"2020-05-27T22:07:37.904Z\",\"visitsCount\":2,\"sessionsCount\":{\"value\":2,\"timestamp\":1590617257905},\"currentEntrancePoint\":\"https://alex-forumur.github.io/\",\"userAgent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/81.0.4044.138 Safari/537.36\"}",
"visitsCount": 2,
"timezoneOffset": -180,
"visitDate": "2020-05-27T22:07:38.542Z",
"createdTs": "2020-05-27T22:13:49.626Z",
"channel": "viber",
"remoteAddress": "YigA61npGwPeUKSR46aEFQ==",
"channelId": 3174,
"chatId": "YigA61npGwPeUKSR46aEFQ=="
}
],
"$count": 3
}Описание полей
- Id - идентификатор записи в нашей базе данных;
- account_id - идентификатор вашего аккаунта в нашей базе данных;
- viewerId - идентификатор пользователя, на аккаунте которого настроен виджет чата;
- widgetId - идентификатор виджета чата, через который начался диалог в TextBack;
- pageUrl - адрес страницы, с которой перешел пользователь;
- pageTitle - название страницы, с которой перешел пользователь;
- referer - URL источника запроса;
- userAgentString - User-Agent браузера;
- urlParameters - параметры в URL адресе, например, UTM-метки;
- cookies - cookies из HTTP запроса;
- secureContext - защищенный средствами JWT контекст, содержащий, например, номер заказа;
- insecureContext - передаваемый с клиента незащищенный контекст. Содержит, в том числе, данные, которые вынесены в отдельные поля;
- visitsCount - число посещений страницы с виджетом чата;
- timezoneOffset - смещение времени в нашей базе данных (UTC 0) относительно часового пояса пользователя (в минутах);
- visitDate - время последнего посещения;
- createdTs - дата создания записи;
- channel - тип канала, какой именно мессенджер (tg, vk, whatsappb и др.);
- remoteAddress - адрес другой стороны, специфичный для канала;
- channelId - идентификатор канала в TextBack;
- chatId - идентификатор сессии чата, в котором сообщение было отправлено.
Book design is the art of incorporating the content, style, format, design, and sequence of the various components of a book into a coherent whole. In the words of Jan Tschichold, "methods and rules upon which it is impossible to improve, have been developed over centuries. To produce perfect books, these rules have to be brought back to life and applied."
Front matter, or preliminaries, is the first section of a book, and is usually the smallest section in terms of the number of pages. Each page is counted, but no folio or page number is expressed, or printed, on either display pages or blank pages.
Front matter, or preliminaries, is the first section of a book, and is usually the smallest section in terms of the number of pages. Each page is counted, but no folio or page number is expressed, or printed, on either display pages or blank pages.