Виджет веб-чата
Канал Web Chat добавляет окно чата на ваш сайт. Посетители нажимают кнопку чата в углу страницы и пишут вам. Их переписка попадает во входящие MonoChat, как и сообщения люб ого другого канала, где на них отвечают ваша команда, ваши сценарии и ваши AI-агенты.
Подключение канала
- Откройте Настройки › Чат › Каналы и нажмите Подключить.
- Выберите Web Chat.
- Заполните настройки ниже и сохраните. Каждое поле объясняет, для чего оно нужно, а в правой части формы показан предпросмотр окна, который меняется по мере правки. Предпросмотр можно переключать между закрытой кнопкой чата, открытым окном и примером переписки.
- Скопируйте фрагмент кода, который показывает канал, и добавьте его на свой сайт (см. Установка фрагмента кода).
Можно подключить несколько каналов Web Chat, например по одному на каждый сайт.
Настройки
| Настройка | Что делает |
|---|---|
| Название канала | Назв ание канала в MonoChat. Окно показывает его как заголовок, когда поле Заголовок виджета пустое. |
| Заголовок виджета | Заголовок окна чата. |
| Подзаголовок | Строка под заголовком, например о том, как быстро вы обычно отвечаете. Очистите поле, чтобы скрыть строку. |
| Логотип | Изображение рядом с заголовком: файл PNG, JPEG, GIF, SVG или WebP. |
| Цвет | Цвет кнопки чата, шапки окна и сообщений посетителя. Текст на нём становится чёрным или белым, чтобы оставаться читаемым. |
| Расположение | Правый нижний или левый нижний угол страницы. |
| Вложения | Позволяет посетителям отправлять изображения, видео, аудио и документы размером до 10 МБ. |
| Кнопка эмодзи | Показывает рядом с полем сообщения кнопку с популярными эмодзи. Включена по умолчанию. |
| Скрыть кнопку чата | Скрывает кнопку чата; окно открывается вашей собственной кнопкой через JavaScript API. |
| Вид на мобильных | Как окно открывается на телефонах: На весь экран или Компактно — панелью на нижние три четверти страницы. |
| Разрешённые домены | Сайты, на которых может появляться окно: точный хост (www.example.com) или все поддомены (*.example.com), с необязательным портом (localhost:3000). Если оставить поле пустым, окно может показывать любой сайт. |
Языки
Кнопки и подписи окна следуют языку браузера посетителя и отображаются на английском, если в MonoChat нет этого языка.
Поля Заголовок виджета, Подзаголовок, Вступление к форме и Текст согласия имеют версию для каждого языка вашего рабочего пространства; языки задаются в Настройки › CRM › Языки (см. Настройки языков). Нажмите на поле, чтобы написать каждую версию. Окно показывает версию на языке браузера посетителя, а если для этого языка её нет — версию на вашем языке по умолчанию.
Чтобы показывать окно на одном языке независимо от браузера, вызовите MonoChat('setLocale', 'tr-TR') через JavaScript API.
Форма перед чатом
Когда форма выключена, посетители сразу начинают писать. Чтобы попросить адрес электронной почты или номер телефона, используйте сценарий (см. Сценарии и виджет).
Когда форма включена, окно перед первым сообщением запрашивает:
| Поле | Варианты |
|---|---|
| Имя | Выключено, необязательно или обязательно |
| Выключено, необязательно или обязательно | |
| Телефон | Выключено, необязательно или обязательно |
Также можно задать текст над полями и добавить флажок согласия со своим текстом и ссылкой на вашу политику конфиденциальности. Если флажок включён, посетитель должен отметить его, чтобы начать чат. Имя, адрес электронной почты и номер телефона сохраняются в профиле клиента.
Установка фрагмента кода
Канал показывает фрагмент кода, в котором адрес виджета и ключ канала уже заполнены, сразу после подключения и под предпросмотром при редактировании канала. Вставьте его перед закрывающим тегом </body> на каждой странице, где должен быть чат:
<script>
window.MonoChat = window.MonoChat || function () { (MonoChat.q = MonoChat.q || []).push(arguments) }
</script>
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>"></script>
Окно загружается после вашей страницы, поэтому не заме дляет её.
Если на вашем сайте ещё есть фрагмент кода старого канала WebChat, удалите его и вставьте на его место фрагмент кода нового канала Web Chat.
Режим на всю страницу
Чтобы отдать чату отдельную страницу, например страницу поддержки, добавьте &mode=fullpage во второй тег фрагмента кода:
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>&mode=fullpage"></script>
Тогда окно занимает всю страницу и остаётся открытым, без шапки окна и кнопки чата, а close и toggle ничего не делают. Оно загружается вместе со страницей, а не после неё, и настройка Вид на мобильных не действует.
Google Tag Manager
- В своём контейнере добавьте тег Custom HTML и вставьте в него фрагмент кода без изменений.
- Выбер ите триггер All Pages или триггер, который срабатывает только на страницах, где должен быть чат.
- Нажмите Submit, затем Publish.
Если собственные скрипты вашей страницы вызывают MonoChat, они могут выполниться раньше тега. Оставьте на странице и первый <script> фрагмента кода, чтобы их вызовы дожидались окна.
Конструкторы сайтов и интернет-магазины
Если вы не можете редактировать код сайта, вставьте фрагмент кода без изменений в поле, которое ваша платформа предлагает для кода на всех страницах, в конце страницы или в подвале:
| Платформа | Куда вставить фрагмент кода |
|---|---|
| WordPress | Установите плагин WPCode и вставьте фрагмент кода в его поле Footer. На WordPress.com возможность добавить код зависит от вашего тарифа. |
| Shopify | Online Store › Edit code: откройте theme.liquid и вставьте фрагмент кода прямо перед </body>. |
| Wix | Settings › Custom Code › Add Custom Code: выберите все страницы и Body – end. Сайт должен быть опубликован и иметь подключённый домен. |
| Squarespace | Поле Footer в Code Injection, на тарифах Core, Plus и Advanced. |
| Webflow | Site settings › Custom code › Footer code, затем опубликуйте сайт. |
| ikas | Sales Channel › Extensions › Scripts › Add Script: вставьте фрагмент кода как содержимое скрипта, сохраните и убедитесь, что скрипт включён. |
JavaScript API
Фрагмент кода определяет на странице функцию MonoChat. Вызывайте её из своих скриптов, ссылок и кнопок, чтобы управлять окном. Вызовы, сделанные до загрузки окна, ждут, пока оно будет готово, поэтому их можно делать сразу после фрагмента кода.
Команды
| Вызов | Что делает |
|---|---|
MonoChat('open') | Открывает окно. |
MonoChat('close') | Закрывает окно. |
MonoChat('toggle') | Открывает окно, если оно закрыто, и закрывает, если открыто. |
MonoChat('hideLauncher') | Скрывает кнопку чата. Окно по-прежнему открывается с помощью open и toggle. |
MonoChat('showLauncher') | Снова показывает кнопку чата. |
MonoChat('setUser', { name, email, phone }) | Передаёт то, что вы уже знаете о посетителе. См. Авторизованные посетители. |
MonoChat('setLocale', 'tr-TR') | Показывает окно на этом языке независимо от языка браузера. См. Языки. |
MonoChat('on', event, callback) | Вызывает callback каждый раз, когда происходит event. См. События. |
События
| Событие | Когда | callback получает |
|---|---|---|
ready | Окно загрузилось. | Ничего |
open | Окно открывается кнопкой чата или вызовом. | Ничего |
close | Окно закрывается. | Ничего |
unread | Меняется число непрочитанных ответов: ответ приходит, пока окно закрыто, или посетитель открывает окно. | Число непрочитанных ответов |
Регистрируйте свои обработчики сразу после фрагмента кода, чтобы не пропустить ready.
Авторизованные посетители
Если посетитель вошёл в аккаунт на вашем сайте, передайте его данные с помощью setUser. Все поля необязательны, а окно читает только name, email и phone.
- Ими заполняется форма перед чатом. Она пропускается, если в ней есть всё, что она запрашивает, кроме случая, когда включён флажок согласия: его посетители всегда отмечают сами.
- Они сохраняются в профиле клиента в MonoChat, чтобы ваша команда видела, кто пишет.
- Если адрес электронной почты или номер телефона недействителен, не сохраняется ни одно из этих значений.
Примеры
Открыть окно своей кнопкой и скрыть кнопку чата:
<button onclick="MonoChat('open')">Напишите нам</button>
<script>
MonoChat('hideLauncher')
</script>
Передать авторизованного пользователя и показать окно на языке страницы:
<script>
MonoChat('setUser', { name: 'Jane Doe', email: 'jane@example.com', phone: '+1 555 010 0000' })
MonoChat('setLocale', document.documentElement.lang)
</script>
Показать число непрочитанных ответов на своей кнопке:
<button onclick="MonoChat('open')">Поддержка <span id="chat-unread"></span></button>
<script>
MonoChat('hideLauncher')
MonoChat('on', 'unread', function (count) {
document.getElementById('chat-unread').textContent = count || ''
})
</script>
Отправить событие в систему аналитики, когда посетитель открывает окно:
<script>
MonoChat('on', 'open', function () {
gtag('event', 'chat_opened')
})
</script>
Переписка
Каждый посетитель — клиент в MonoChat, а его переписка хранится в его браузере: посетитель, вернувшийся в том же браузере, видит последние 200 сообщений в течение 90 дней после последнего сообщения. Другой браузер или другое устройство начинает новую переписку. Ответы вашей команды и индикатор набора текста появляются в окне сразу.
Кнопка эмодзи рядом с полем сообщения предлагает популярные эмодзи. Посетители также могут ввести любой эмодзи с клавиатуры.
Сообщения посетителя отмечаются галочками, как в WhatsApp: одна серая галочка — сообщение отправлено, две серые — оно дошло до MonoChat, две синие — кто-то из вашей команды открыл переписку. В MonoChat ваши ответы отмечаются как доставленные, когда их получает окно посетителя, и как прочитанные, когда посетитель открывает окно.
Когда окно закрыто, новый ответ показывает число непрочитанных сообщений на кнопке чата и воспроизводит короткий звук. Браузеры воспроизводят звук только после того, как посетитель где-нибудь на странице нажал или что-то ввёл.
Типы сообщений
Окно показывает сообщения так же, как экран чата MonoChat: имя агента над его ответами, строку с датой там, где начинается новый день, и время внутри каждого пузыря, а на сообщениях посетителя — галочки.
Помимо текста, эмодзи и файлов, ваши ответы могут использовать типы ниже. Отправляйте их из узла сценария Отправить сообщени е, коротких сообщений, приложений и функций (см. Типы сообщений).
| Тип | Как окно его показывает |
|---|---|
| Изображение, видео, аудио, стикер | Внутри пузыря. |
| Документ | Карточка с типом и именем файла, по нажатию на которую файл скачивается. |
| Быстрые ответы | Кнопки под последним сообщением. Нажатие отправляет название кнопки как ответ посетителя. |
| Кнопка | Сообщение с необязательным заголовком (текст, изображение, видео или документ), подвалом и кнопками, которые отправляют ответ, открывают веб-адрес или звонят на номер телефона. |
| CTA URL | Сообщение с одной кнопкой, которая открывает веб-адрес. |
| Список | Строки внутри пузыря, сгруппированные по разделам. Нажатие на строку отправляет её как ответ посетителя. |
| Карусель | Карточки, которые посетитель прокручивает в сторону, каждая с изображением или видео, заголовком, подзаголовком и кнопками. |
| Местоположение | Метка с названием и адресом места, которая открывает это место в Google Maps. |
| Запрос геолокации | Кнопка Отправить местоположение. Браузер запрашивает у посетителя разрешение, после чего его местоположение приходит в MonoChat как сообщение с местоположением. |
| Контакты | Имя и компания каждого контакта со ссылками, по которым можно позвонить на его номера телефонов и написать на его адреса эл. почты. |
Быстрые ответы, кнопки ответа, строки списка и запрос геолокации работают только в последнем сообщении, чтобы посетители не могли ответить на старый вопрос.
Значки кнопок
Кнопки, которые открывают веб-адрес, могут показывать значок: выберите его в поле Значок сообщения CTA URL или кнопки Веб-URL. Это поле появляется, только когда вы собираете сообщение для Web Chat: другие каналы значки не показывают. Доступные значки: Ссылка, Сайт, WhatsApp, Instagram, Messenger, Facebook, Telegram, TikTok, Телефон, Эл. почта и Местоположение; кнопка без значка показывает значок ссылки.
Сценарии и виджет
Приветственные сообщения, рабочие часы, ответы в нерабочее время, запрос адреса электронной почты или номера телефона и проактивные сообщения настраиваются сценариями, а не настройками канала.
Событие Получено действие клиента запускает сценарий из окна:
- Чат-виджет открыт впервые: посетитель открывает окно, и у него нет открытой переписки. MonoChat начинает переписку или снова открывает его закрытую переписку, чтобы сценарий мог написать посетителю раньше, чем он сам. Повторное открытие окна, пока переписка открыта, не вызывает это действие снова.
- Чат-виджет открыт: посетитель открывает окно, каждый раз, включая первый. Посетитель без открытой переписки получает её, как описано выше.
- Чат-виджет закрыт: посетитель закрывает окно во время открытой переписки.
Если включена форма перед чатом, окно считается открытым после того, как посетитель её заполнит.
Просмотр страницы с виджетом не вызывает ни одно из этих действий. Посетитель, который ещё не писал, становится клиентом в MonoChat, только если какой-либо сценарий ожидает это действие.
В режиме на всю страницу окно открывается вместе со страницей, поэтому загрузка страницы считается открытием окна. Каждый канал учитывает не более 60 открытий окна в минуту; сверх этого сценарии не запускаются.
Чтобы поприветствовать посетителей, запустите сценарий с событием Получено действие клиента, для которого выбрано Чат-виджет открыт впервые, и добавьте узел Отправить сообщение с вашим приветственным сообщением. Соберите его в конструкторе сообщений, с кнопками ответа, списком или ссылками со значками.
Powered by MonoChat
В окне есть небольшая строка Powered by с логотипом MonoChat. Это не настройка канала: её можно скрыть только для всей установки MonoChat.