Вы можете разместить виджет с ботом на странице вашего сайта. Это позволит увеличить продажи, осуществлять информирование, а также своевременно оказывать помощь и техническую поддержку вашим клиентам.
Чтобы разместить виджет с ботом на странице вашего сайта, необходимо выполнить следующие действия:
1) Создать чат. Подробнее о том, как это сделать, написано в следующем разделе Создание новых чатов).
2) В личном кабинете администратора перейти в раздел Чаты - Настройки и нажать кнопку Код фрейма напротив имени созданного чата.
3) В открывшемся окне скопировать указанный ниже блок кода вручную или с помощью кнопки .
4) Разместить скопированный блок кода в коде страницы вашего сайта. Если вы хотите разместить виджет на нескольких страницах сайта, данную процедуру необходимо выполнить для каждой такой страницы.
Скопированный блок кода рекомендуется размещать перед закрывающим тегом </body>.
Ниже приводится пример кода страницы с указанием места расположения блока кода виджета:
После сохранения изменений в правом нижнем углу вашей страницы будет отображаться кнопка виджета.
После добавления виджета вы можете задать дополнительные настройки, которые можно использовать в диалогах. Данные настройки задаются при помощи объектов sessionDefaults и appearance. Чтобы применить дополнительные настройки, необходимо добавить объекты sessionDefaults и appearance в раздел инициализации виджета.
Ниже указано место размещения фрагмента кода с объектами sessionDefaults и appearance в разделе инициализации виджета:
Объект sessionDefaults передает в сценарий виджета системные и пользовательские переменные с определенными значениями (например, ФИО клиента, день недели, контактный номер телефона, идентификатор клиента во внешней системе). Данные переменные можно использовать в диалогах с клиентами. Данные переменные используются в диалогах виджета.
Объект appearance позволяет задать язык, на котором будут отображаться названия кнопок виджета, включить режим отображения кнопок с пиктограммами мессенджеров и социальных сетей, а также отобразить пользователю запрос с просьбой оценить диалог.
Ниже приводится фрагмент кода инициализации виджета с объектами sessionDefaults и appearance.
TwinChat.init('#twin-chat-container', { chatId: '35a40e2c-4955-4ae3-a8e0-559fd4381244', sessionDefaults: { meta: { status: 'new', }, name: 'Chat with client', clientExternalId: 'externalKey', clientMetadata: { result1: 1, result2: "Hello World!", result3: false, result4: 'Hello my dear!'}, clientEmail: 'client@twin24.ai', clientPhone: '1234567890', clientName: 'Santa Claus', clientNickname: 'Bad Boy', clientDeviceId:'0000-1111-2222-3333-44444444', clientTimezone:'-300' }, appearance:{ lang: 'en', start: { mode: 'messengerButtons', }, rating: { midterm: 'Оцените, как проходит диалог', } analytics: { yandexMetrika: { counter: '86962928', // method: 'ym', // prefix: '/chat-widget', }, }, } }).then(client => window.TwinClient = client);
Объект sessionDefaults
- meta - объект содержит системные свойства, которые передаются в сценарий в виде переменных:
- status - .
- name - имя диалога, которое отображается в кабинете оператора.
- clientExternalId - идентификатор клиента, по которому будут группироваться чат-сессии в кабинете оператора.
- clientMetadata - содержит свойства, которые задаются пользователем. Эти свойства передаются в сценарий в виде переменных. Вы можете задавать любые свойства. Например:
- clientEmail - адрес электронной почты клиента;
- clientPhone - контактный номер телефона клиента.
Объект appearance
- lang - задает язык виджета (подробнее об изменении языка виджета см. Изменение языка виджета);
- start - задает режим отображения кнопок подключенных мессенджеров и социальных сетей. Для опции mode укажите значение messengerButtons, если при старте страницы необходимо отображать список всех подключенных в личном кабинете мессенджеров и социальных сетей;
- rating - позволяет изменить текст запроса у пользователя промежуточной оценки диалога. В значении midterm укажите текст, который должен отображаться в виджете при запросе промежуточной оценки;
- analytics - содержит свойства, которые позволяют подключить яндекс метрику для оценки частоты использования чата:
- yandexMetrika - идентификатор яндекс метрики.
Для запроса промежуточной оценки диалога у пользователя в свойствах чата должен быть установлен параметр "Через сколько секунд запросить отзыв о диалоге" (подробнее см. в этом разделе).
* Данная опция будет доступна в ближайшее время