Размещение виджета бота на странице сайта

Содержание:

• Как разместить стандартный виджет на странице сайта
• Как использовать переменные для передачи имени, номера мобильного телефона и адреса электронной почты клиента в диалоге

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

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

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

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

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

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

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

Виджет имеет настройки, которые задаются при помощи объектов sessionDefaults, appearance и analytics. Ниже приводится фрагмент кода с этими объектами.

TwinChat.init('#twin-chat-container', {
            chatId: '35a40e2c-4955-4ae3-a8e0-559fd4381244',
            sessionDefaults: {
                name: 'Диалог с клиентом',
                clientExternalId: 'externalKey',
                clientMetadata: {
                    age: 31,
                    topic: "Открытие магазина",
                    city: 'Москва'
                },
                clientEmail: 'client@mail.ru',
                clientPhone: '79111234567',
                clientName: 'Иван',
                orderNumber: '1234567',
                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',
                    },
                    {
                        googleAnalytics: {
                            counter: '88777666',
                            // method: 'gtag',
                            // prefix: 'ChatWidget',
                        },
                    },
                }

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

В указанном выше фрагменте кода инициализации виджета используются следующие переменные:

• name (системная переменная) – имя диалога, которое отображается в кабинете оператора;
• clientExternalId (системная переменная) – идентификатор клиента, по которому будут группироваться чат-сессии в кабинете оператора;
• clientMetadata – содержит список переменных, которые задаются пользователем. Значения этих переменных передаются в сценарий. Вы можете задавать любые переменные. Например:
  • age (пользовательская переменная) – возраст клиента;
    
  • topic (пользовательская переменная) – тема диалога;
    
  • city (пользовательская переменная) – город проживания клиента;
    
  • clientEmail (пользовательская переменная) – адрес электронной почты клиента;
  • clientPhone (пользовательская переменная) – контактный номер телефона клиента;
  • clientName (пользовательская переменная) – имя клиента;
  • orderNumber (пользовательская переменная) – номер заказа;
  • clientDeviceId (пользовательская переменная) – идентификатор устройства клиента;
  • clientTimezone (пользовательская переменная) – часовой пояс.

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

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

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

Включение отображения кнопок подключенных мессенджеров и социальных сетей

Кнопки с пиктограммами мессенджеров и социальных сетей позволяют вашему клиенту на любом этапе диалога продолжить общение в чате мессенджера или социальной сети. Чтобы включить отображение данных кнопок для виджета, необходимо в личном кабинете администратора перейти в раздел Настройки, нажать кнопку Редактировать рядом с названием вашего чата и в открывшемся окне в разделе Ссылки на менеджеры указать ссылки на чаты, созданные в менеджерах и социальных сетях.

Запрос промежуточной оценки диалога

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

• В поле Через сколько секунд запросить отзыв о диалоге указать период времени, по завершению которого необходимо запрашивать у клиента отзыв;
• В поле Тип отзыва выбрать тип отзыва;
• В поле Текст оценки диалога вести текст сообщения, которое будет отображаться при запросе отзыва.

• analytics – содержит свойства, которые позволяют подключить яндекс метрику для оценки частоты использования чата:
  • yandexMetrika – имя используемой метрики;
    • counter – идентификатор яндекс метрики;
    • method – метод, который нужно вызывать при инициализации виджета. Можно использовать любой метод. По умолчанию применяется метод 'ym';
    • prefix – пространство имен для идентификации событий виджета в отчетах Яндекс.Метрики. По умолчанию используется значение 'chat-widget'.

• • googleAnalytics – имя используемой метрики;
    • counter – идентификатор метрики Google Analytics;
    • method – метод, который нужно вызывать при инициализации виджета. Можно использовать любой метод. По умолчанию применяется метод 'gtag';
    • prefix – пространство имен для идентификации событий виджета в отчетах Google Analytics. По умолчанию используется значение 'chatWidget'.

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