2.3.4.3. Подключение web-чата
Подключение web-чата к линии 1С-Коннект для общения с посетителями сайта
Подключение/отключение web-чата, управление подключенным чатом осуществляется с помощью специальной линии 1С-Коннект: Управление каналами. Необходимо найти и подключить данную линию в приложении 1С-Коннект.
Выберите в цифровом меню “web-чат” - “Подключить web-чат”.
Выберите линию, к которой необходимо подключить web-чат:
Подключение возможно к линиям вашей компании с типом доступности “Для клиентов и специалистов”.
Предлагаемые линий можно листать с помощью стрелочек.
После выбора линии поддержки введите домен web-чата. Затем для подтверждения владения доменом разместите полученный meta-тег в раздел <head> вашего сайта.
Если meta-тег не добавлен, в чате появится ошибка «Не найден meta-тег» - потребуется повторно ввести домен и разместить полученный тег у себя на сайте.
Для завершения подключения - перейдите по ссылке и авторизуйтесь, используя учетную запись (логин и пароль) API.
После успешной авторизации вам будет предоставлен <script> для вставки в раздел <body> вашего сайта. Информация о подключении и настройке web-чата на сайте представлена ниже.
Если все действия выполнены правильно, на сайте появится виджет для приема обращений от посетителей сайта в 1С-Коннект.
Подключение и настройка web-чата на сайте
Полученный от специальной линии 1С-Коннект: Управление каналами meta-тег необходимо вставить в <head> часть сайта:
<meta name="connect-widget-challenge" content="ИНДИВИДУАЛЬНЫЙ_КОД">Полученный от линии скрипт необходимо вставить в <body> часть сайта:
<script type="module" src="https://chat-api.1c-connect.com/widget/ИНДИВИДУАЛЬНЫЙ_КОД"></script>Если вы хотите персонализировать web-чат, то под обязательный скрипт в <body> можно разместить дополнительный скрипт с необязательными параметрами, которые вы можете менять:
<script> window.connect_widget_config = { buttonType: 'fill', primaryColor: '#AC2226', secondaryColor: '#FFFFFF', chatName: 'Онлайн-помощник', position: 'bottom-right', offsetX: 24, offsetY: 24, } </script>
Параметр | Доступные значения | Описание |
|---|---|---|
buttonType |
| Тип заливки виджета
|
primaryColor |
| Цвет фона шапки чата и виджета |
secondaryColor |
| Цвет текста шапки чата, иконки шапки чата и виджета |
chatName |
| Имя чата, отображающееся в шапке |
position |
| Позиция виджета:
|
offsetX |
| Отступ виджета от левого\правого угла |
offsetY |
| Отступ виджета верхнего\нижнего угла |
Пример правильной установки meta-тега и скрипта:
<!DOCTYPE html>
<head>
...
<meta name="connect-widget-challenge" content="ИНДИВИДУАЛЬНЫЙ_КОД">
...
</head>
<body>
...
...
<!-- Обязательно -->
<script type="module" src="https://chat-api.1c-connect.com/widget/ИНДИВИДУАЛЬНЫЙ_КОД"></script>
<!-- Если необходимо -->
<script> window.connect_widget_config = { buttonType: 'fill', primaryColor: '#AC2226', secondaryColor: '#FFFFFF', chatName: 'Онлайн-помощник', position: 'bottom-right', offsetX: 24, offsetY: 24, } </script>
</body>
</html>
Web-чат на сайте
Посетитель сайта нажимает кнопку web-чат, виджет открывается.
У посетителя запрашиваются имя (обязательно) и контактный телефон (необязательно), далее открывается чат: поле ввода сообщений/файлов и история переписки.
Если посетитель отправляет в чат сообщений или файлы - обращение автоматически направляется по линии 1С-Коннект: обрабатывается по правилам линии (с использованием всех настроек линии).
Отключение web-чата от линии 1С-Коннект
По линии поддержки “1С-Коннект: Управление каналами” в цифровом меню выберите “Web-чат”.
Выберите “Отключить web-чат”.
Выберите линию, от которой необходимо отключить web-чат. После выбора линии поддержки потребуется авторизация с использованием учетной записи API. Необходимо перейти по предоставленной ссылке и ввести учетные данные (логин и пароль).
После авторизации в учётной записи вам придёт сообщение об отключении web-чата от линии.
Виджет останется на сайте в неактивном состоянии. Для того что бы полностью убрать виджет, потребуется удалить добавленный ранее <script> из исходного кода страницы.
Просмотр списка линий, подключенных к web-чату, и мониторинг их состояния
В диалоге по линии 1С-Коннект: Управление каналами выберите “Web-чат”.
Выберите “Показать линии с web-чатом”.
В чате будет выведен список линий, подключенных к web-чату, содержащий в себе название линии, название web-чата, название клиента и состояние подключения.
Рекомендации
Для работы с посетителями сайта, рекомендуем использовать отдельную линию в 1С-Коннект (отдельную для каждого сайта/web-чата) и отдельную учетную запись API. Это позволит удобнее управлять данным каналом и исключит возможные ошибки.
При подключении к линии web-чата в сервисе создаётся отдельная техническая компания-клиент с названием “Web: <адрес вашего сайта>”. В рамках этой компании регистрируются аккаунты пользователей web-чата. Просмотр списка пользователей этой компании доступен в кабинете администратора.
По каждому пользователю из web-чата в 1С-Коннект:
Передаются: имя пользователя, сообщения, номер телефона (если был заполнен пользователем), файлы, картинки, информация о прочтении сообщений.
Не передаются: статус (онлайн/офлайн), аватар, рассылки, голосовые сообщения и звонки между сервисами.
Ограничения
Компания может подключить до 5 web-чатов к своим линиям.
К одной линии можно подключить один web-чат. К одному web-чату можно подключить одну линию 1С-Коннект.
При переподключении домена к другой линии сообщения будут поступать в новую линию, но данные посетителя сайта не перенесутся — они создадутся заново.
Привязка домена к линии другой компании не рекомендуется из-за риска сбоев и потери сообщений.
Из web-чата в 1С-Коннект можно передавать файлы — до 100 МБ.
Из 1С-Коннект в web-чат можно передавать файлы размером, предусмотренным тарифом компании.
Сроки хранения файлов на стороне 1С-Коннект определяются тарифом компании.