...
После сохранения изменений в правом нижнем углу вашей страницы будет отображаться кнопка виджета.
После добавления виджета вы можете задать дополнительные Виджет имеет настройки, которые можно использовать в диалогах. Данные настройки задаются при помощи объектов sessionDefaultsи appearance. Чтобы применить дополнительные настройки, необходимо добавить объекты sessionDefaults и appearance в раздел инициализации виджета.
...
appearance
...
Объект sessionDefaults передает в сценарий виджета системные и пользовательские переменные с определенными значениями (например, ФИО клиента, день недели, контактный номер телефона, идентификатор клиента во внешней системе). Данные переменные можно использовать в диалогах с клиентами. Данные переменные используются в диалогах виджета.
Объект appearance позволяет задать язык, на котором будут отображаться названия кнопок виджета, включить режим отображения кнопок с пиктограммами мессенджеров и социальных сетей, а также отобразить пользователю запрос с просьбой оценить диалог.
и analytics. Ниже приводится фрагмент кода инициализации виджета с этими объектами sessionDefaults и appearance.
Блок кода | ||||
---|---|---|---|---|
| ||||
TwinChat.init('#twin-chat-container', { chatId: '35a40e2c-4955-4ae3-a8e0-559fd4381244', sessionDefaults: { meta: { status: 'new', }, name: 'ChatДиалог withс clientклиентом', clientExternalId: 'externalKey', clientMetadata: { result1age: 1, result2: "Hello World!",31, result3topic: "Открытие falseмагазина", result4city: 'Hello my dear!Москва'}, clientEmail: 'client@twin24client@mail.airu', clientPhone: '123456789079111234567', clientName: 'SantaИван ClausПетров', clientNicknameorderNumber: 'Bad Boy1234567', 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
...
передает в сценарий виджета системные и пользовательские переменные (например, ФИО клиента, день недели, контактный номер телефона, идентификатор клиента во внешней системе). Данные переменные можно использовать в диалогах виджета.
В указанном выше фрагменте кода инициализации виджета используются следующие переменные:
- name (системная переменная) –name - имя диалога, которое отображается в кабинете оператора.
- clientExternalId - (системная переменная) – идентификатор клиента, по которому будут группироваться чат-сессии в кабинете оператора.
- clientMetadata- –содержит свойствасписок переменных, которые задаются пользователем. Эти свойства Значения этих переменных передаются в сценарий в виде переменных. Вы можете задавать любые свойствапеременные. Например:
- age (пользовательская переменная)– возраст клиента;
- topic (пользовательская переменная)– тема диалога;
- city (пользовательская переменная)– город проживания клиента;
- clientEmail (пользовательская переменная)– clientEmail - адрес электронной почты клиента;
- clientPhone - (пользовательская переменная)– контактный номер телефона клиента;
- clientName (пользовательская переменная)– имя клиента;
- orderNumber (пользовательская переменная)– номер заказа;
- clientDeviceId (пользовательская переменная)– идентификатор устройства клиента;
- clientTimezone (пользовательская переменная)– часовой пояс.
- age (пользовательская переменная)– возраст клиента;
Объект appearance позволяет задать язык, на котором будут отображаться названия кнопок виджета, включить режим отображения кнопок с пиктограммами мессенджеров и социальных сетей, а также отобразить пользователю запрос с просьбой оценить диалог.
- lang - задает язык виджета (подробнее об изменении языка виджета см. Изменение языка виджета);
- start - задает режим отображения кнопок подключенных мессенджеров и социальных сетей. Для опции mode укажите значение messengerButtons, если при старте страницы необходимо отображать список Чтобы при загрузке страницы рядом с кнопкой виджета отображались кнопки с пиктограммами всех подключенных в личном кабинете мессенджеров мессенджера и социальных сетей, то для опции mode нужно указать значение messengerButtons;
- rating - позволяет изменить задает текст запроса у пользователя промежуточной оценки диалога. В значении midterm укажите введите текст, который должен отображаться в виджете диалогах виджета при запросе у пользователя промежуточной оценки диалога;
- analytics - содержит свойства, которые позволяют подключить яндекс метрику для оценки частоты использования чата:
- yandexMetrika - идентификатор яндекс метрики.
Подсказка |
---|
Для запроса у пользователя промежуточной оценки диалога у пользователя в свойствах чата должен быть установлен параметр "Через сколько секунд запросить отзыв о диалоге" (подробнее см. в этом разделе). * Данная опция будет доступна реализована в ближайшее время |
Чтобы использовать указанные выше настройки виджета, необходимо добавить объекты sessionDefaults,appearance и analytics в раздел инициализации виджета.
Подсказка |
---|
Ниже указано место размещения фрагмента кода с объектами sessionDefaults,appearance и analyticsв разделе инициализации виджета: |