Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

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

После добавления виджета вы можете задать дополнительные Виджет имеет настройки, которые можно использовать в диалогах. Данные настройки задаются при помощи объектов sessionDefaultsи appearance. Чтобы применить дополнительные настройки, необходимо добавить объекты sessionDefaults и appearance в раздел инициализации виджета.

...

appearance

...

Image Removed

Объект sessionDefaults  передает в сценарий виджета системные и пользовательские переменные с определенными значениями (например, ФИО клиента, день недели, контактный номер телефона, идентификатор клиента во внешней системе). Данные переменные можно использовать в диалогах с клиентами. Данные переменные используются в диалогах виджета.

Объект appearance позволяет задать язык, на котором будут отображаться названия кнопок виджета, включить режим отображения кнопок с пиктограммами мессенджеров и социальных сетей, а также отобразить пользователю запрос с просьбой оценить диалог.

и analytics. Ниже приводится фрагмент кода инициализации виджета с этими объектами sessionDefaults и appearance.

Блок кода
languagejs
linenumberstrue
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 (пользовательская переменная)– часовой пояс.

Объект appearance позволяет задать язык, на котором будут отображаться названия кнопок виджета, включить режим отображения кнопок с пиктограммами мессенджеров и социальных сетей, а также отобразить пользователю запрос с просьбой оценить диалог.

  • lang - задает язык виджета (подробнее об изменении языка виджета см. Изменение языка виджета);
  • start  - задает режим отображения кнопок подключенных мессенджеров и социальных сетей. Для опции mode укажите значение messengerButtons, если при старте страницы необходимо отображать список Чтобы при загрузке страницы рядом с кнопкой виджета отображались кнопки с пиктограммами всех подключенных в личном кабинете мессенджеров мессенджера и социальных сетей, то для опции mode нужно указать значение messengerButtons;
  • rating - позволяет изменить задает текст запроса у пользователя промежуточной оценки диалога. В значении midterm укажите введите текст, который должен отображаться в виджете диалогах виджета при запросе у пользователя промежуточной оценки диалога;
  • analytics - содержит свойства, которые позволяют подключить яндекс метрику для оценки частоты использования чата:
    • yandexMetrika - идентификатор яндекс метрики.
Подсказка

Для запроса у пользователя промежуточной оценки диалога  у пользователя в свойствах чата должен быть установлен параметр "Через сколько секунд запросить отзыв о диалоге" (подробнее см. в этом разделе).

* Данная опция будет доступна реализована в ближайшее время

Чтобы использовать указанные выше настройки виджета, необходимо добавить объекты sessionDefaults,appearance и analytics в раздел инициализации виджета.

Подсказка

Ниже указано место размещения фрагмента кода с объектами sessionDefaults,appearance и analyticsв разделе инициализации виджета:

Image Added