Вы можете разместить виджет с ботом на странице вашего сайта. Это позволит увеличить продажи, осуществлять информирование, а также своевременно оказывать помощь и техническую поддержку вашим клиентам.

Чтобы разместить виджет с ботом на странице вашего сайта, необходимо выполнить следующие действия:

1) Создать чат. Подробнее о том, как это сделать, написано в следующем разделе Создание новых чатов).

2) В личном кабинете администратора перейти в раздел Чаты - Настройки и нажать кнопку Код фрейма напротив имени созданного чата.

3) В открывшемся окне скопировать указанный ниже блок кода вручную или с помощью кнопки .

4) Разместить скопированный блок кода в коде страницы вашего сайта. Если вы хотите разместить виджет на нескольких страницах сайта, данную процедуру необходимо выполнить для каждой такой страницы. 

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

После добавления виджета вы можете задать дополнительные настройки, которые можно использовать в диалогах. Данные настройки задаются при помощи объектов 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

• name - имя диалога, которое отображается в кабинете оператора.
• clientExternalId - идентификатор клиента, по которому будут группироваться чат-сессии в кабинете оператора.
• clientMetadata - содержит свойства, которые задаются пользователем.  Эти свойства передаются в сценарий в виде переменных. Вы можете задавать любые свойства. Например:
  • clientEmail - адрес электронной почты клиента;
  • clientPhone - контактный номер телефона клиента.

Объект appearance

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