Чатвиджет как входящий канал
Для использования чатвиджета как входящего канала:
Создание канала
Нажмите на панели управления Каналы > Входящие > Создать канал. В разделе Другие выберите канал для подключения Чатвиджет.
Заполните поля:
- Название — укажите название канала.
- Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию
master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита. - Оператор — выберите операторский канал или оставьте пустым.
- Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).
Публикацию или деплой сценария нужно выполнять перед запуском чат-бота. На этом этапе происходит сборка чат-бота, проверка синтаксиса сценариев и скриптов, а также проверка прохождения тестов.
Нажмите Создать. Дождитесь всплывающего окна с результатом деплоя.
На этом этапе вы создали виджет с конфигурацией по умолчанию. В JAICP есть удобный графический конструктор, в котором вы можете настроить внешний вид виджета. Внесенные изменения будут сразу же к нему применены. Когда вы будете довольны результатом, вы сможете сохранить конфигурацию и добавить чатвиджет на ваш сайт.
Для настройки внешнего вида чатвиджета перейдите к разделу Редактирование чатвиджета.
Редактирование чатвиджета
Нажмите на иконку в строке с ботом > выберите Редактировать.
В появившемся окне вы можете настроить графический интерфейс чатвиджета. Здесь вы можете изменить следующие элементы внешнего вида и поведения:
- Общие настройки
- Оформление
- Заголовок чата
- Окно чата
- Отправка сообщений
- Расположение
- Вовлечение в диалог
- Звуковые уведомления
- Установка
Общие настройки
- Название — название канала, отображается в списке каналов.
- Токен — уникальный идентификатор бота. Используется в ссылке скрипта для встраивания чатвиджета на сайт.
- Ветка — ветка проекта, которая будет развернута в канал.
- Оператор — операторский канал, в который при необходимости будут направляться запросы клиентов.
- Публикация — способ публикации канала: автоматически после сохранения изменений в проекте или вручную.
- Показывать % пользователей — процент пользователей, которые увидят виджет на сайте.
- Копировать настройки проекта — вы можете применить настройки из уже созданного канала к текущему.
Если у вас был ранее опубликованный чатвиджет с темой По умолчанию, то его настройки не будут доступны для копирования. Для применения настроек замените тему на По умолчанию (beta).
Оформление
В этом разделе вы можете настроить:
- Тип шрифта
- Размер шрифта
- Размер аватаров бота и пользователя
- Цветовую тему
На выбор представлены несколько цветовых тем.
Вы также можете создать собственную цветовую тему. Для этого внесите изменения в любую готовую цветовую тему. Новая тема сохранится под иконкой кастомизированной темы, и вы сможете вернуться к ней в любой момент.
Все внесённые изменения сразу применяются к чатвиджету, который расположен в правом углу экрана. Нажмите на него и оцените внешний вид чатвиджета.
Заголовок чата
- Название — название чатвиджета, которое будет отображаться в заголовке.
- Аватар — загрузка пользовательского аватара для чатвиджета вместо изображения по умолчанию. Аватар бота — изображение, которое отображается, когда виджет свернут.
Окно чата
- Имена — выбор имени участников чата: пользователя, бота и оператора. Сообщения, отправленные оператором, подписываются именем оператора из операторского канала. Если из операторского канала имя не удалось получить, то используется имя, указанное в конфигурации чатвиджета.
- Аватарки — загрузка аватара для участников чата.
Отправка сообщений
- Пользователи отправляют сообщения — выбор способа отправки сообщений: по нажатию Enter и по нажатию на кнопку в окне чата или только по нажатию Enter.
- Блокировать ввод текста при использовании кнопок — выберите Да, если хотите заблокировать клиенту возможность ввода текстовых сообщений, когда используете кнопки в сценарии.
- Разрешить пользователям отправлять файлы — в чате появится кнопка , с помощью которой можно будет отправлять файлы боту.
- Подсказка в поле ввода — фраза, которая будет отображаться в поле ввода до момента, когда пользователь начинает вводить текст сообщения.
Расположение
- На десктопе — положение виджета на экране десктопа: отступ от правого края экрана или отступ от нижнего края экрана в пикселях. Вы можете увидеть изменения сразу же на экране и отрегулировать наиболее подходящее для вас расположение виджета.
- На мобильном — положение виджета на экране мобильного устройства: слева или справа.
Вовлечение в диалог
- Всплывающее сообщение — сообщение бота, которое будет всплывать в диалоге при наступлении настроенных событий.
- Открыть окно чата по наступлению условия — выбор условия открытия чата: время, проведенное пользователем на сайте или на странице.
- Приветствие в окне чата — выбор сообщения бота, которое появится в чате после открытия окна. Сессия начнется после первого сообщения пользователя.
- Показать кнопки меню — при включенном параметре вы сможете добавить в чатвиджет до 8 кнопок, чтобы помочь клиенту выбрать тему разговора до начала диалога. При выключенном параметре кнопки не будут отображаться в чате, но настройки не пропадут.
Вы также можете сделать inline-кнопку и передать в нее ссылку на любой источник. Для этого нажмите на выбранной кнопке.
- Показывать кнопки только над формой ввода — при включенном параметре inline-кнопки будут отображаться рядом с обычными кнопками над формой ввода, а не в поле чата. Параметр выключен по умолчанию.
- Показывать новое сообщение миганием вкладки — оповещение о новом сообщении от бота или оператора. Отображается на вкладке с чатвиджетом, когда вкладка не активна. Параметр включен по умолчанию.
Сценарий вовлечения
- Виджет закрыт > наступает установленное событие > всплывает сообщение рядом с закрытым виджетом.
- Виджет открылся и клиент закрывает его > наступает следующее событие > виджет открывается.
- Виджет открылся и клиент не закрывает его > наступает следующее событие > виджет закрывается и открывается повторно.
- Клиент самостоятельно открыл виджет > наступает событие > виджет остается открытым.
Подробнее о настройке начала сессии в чатвиджете
Звуковые уведомления
- Звуковой эффект — включение уведомлений при отправке и/или получении сообщений.
- Звук — выбор рингтона для уведомлений.
Установка
В разделе Установка вы можете скопировать код чатвиджета, чтобы вставить его на ваш сайт. Разместите код скрипта между тегами <head></head> на всех страницах сайта, где будет находиться виджет.
Также скрипт доступен по нажатию на Получить скрипт под названием созданного канала. Код для вставки виджета будет скопирован в буфер обмена.
Настройка Встраивание виджета в контейнер на странице позволяет задать идентификатор контейнера, в который будет встроен чатвиджет на странице.
Тестирование работы чатвиджета
Для активации виджета на сайте достаточно его опубликовать.
Нажмите на иконку в строке с ботом > нажмите на иконку чата в правом нижнем углу.
Внизу экрана появится окно чата, в котором можно начать общение, и протестировать сценарий.
Отправьте боту активационную/приветственную фразу, предусмотренную вашим сценарием. После этого должен начаться диалог с ботом.