Widget

В Платформа реализована возможность подключить Бота в кастомизированный виджет и вывести его на свой сайт. Виджет создается аналогично другим Канал Проекта.

Подключение

Конфигурация канала агента в Платформе

  1. Кликните по кнопке настроек Агента.

  2. Нажмите кнопку Add channel.

  3. Откроется панель выбора Конечный канал.

  4. Выберите Widget.

  5. Откроется панель создания Канал Проекта.

  6. На вкладке Settings:

    1. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.

    2. По необходимости задайте список доменов, на которых может работать виджет, в поле Domain.

      1. Можно указать как сам домен, так и паттерн в формате *.domain.com. В таком случае виджет будет работать на всех сабдоменах domain.com.

    4. Сниппет в поле Snippet понадобится вам для установки виджета на сайт. Скопировать его можно нажатием кнопки COPY WIDGET CODE.

  8. Перейдите на вкладку Design:

    1. Укажите имя для Бота в поле Bot name.

    2. Укажите заголовок для виджета в поле Widget title.

    3. Укажите цвет виджета в поле Widget color. Цвет можно указывать следующими способами:

      1. HEX-код цвета в формате #ADFF2F;

      2. название цвета на английском.

    5. По необходимости загрузите изображение для виджета (логотип компании) в поле Company logo. Если изображение не будет загружено, то в виджете будет добавлено изображение по умолчанию.

    6. По необходимости укажите плейсхолдер-подсказку в поле Placeholder in the expanded widget. Если вы не укажете подсказку, в поле ввода автоматически будет подставлен текст “Type a message”.

    7. По необходимости добавьте приветственное сообщение от Бота. Для этого переключите тумблер Send welcome message on widget expanded и укажите сообщение в поле Bot's welcome message.

  10. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.

  11. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.

    1. Канал Проекта будет сохранен и активирован, если Агент обучен.

    2. В противном случае Канал Проекта будет сохранен, но не активирован.

  13. Для отмены создания Канал Проекта нажмите кнопку CANCEL.

Установка виджета на сайт

  1. Для установки виджета на ваш сайт скопируйте сниппет и вставьте его в <body> в код.

  2. Активируйте Канал Проекта, если он еще не активирован.

  3. После этого виджет появится на сайте.

Редактирование и удаление Канала Агента

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.

  1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.

  2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.

  3. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.

  4. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.

  5. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.

    1. Изменения будут применены и Канал Проекта будет активирован, если Агент обучен.

    2. В противном случае изменения будут применены, но Канал Проекта не будет активирован.

  7. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.

  8. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.

Общение

Сервисные сообщения из виджета

На данный момент не поддерживается передача Сервисные сообщения канала из виджета.

Переменная
Конечный канал
Переменная в запросе из канала
Примечания

channel_visitor_id

Widget

Генерируется системой в виде строки, значение channel_visitor_id и channel_chat_id равно

channel_visitor_firstname

Widget

нет

channel_visitor_lastname

Widget

нет

channel_visitor_phone

Widget

нет

channel_visitor_email

Widget

нет

channel_visitor_account

Widget

нет

channel_visitor_auth

Widget

нет

channel_visitor_source

Widget

URL страницы, на которой работает виджет

Функционал общения
Конечный канал
Доступность в канале
Примечания

channel_chat_id

Widget

Да

Генерируется системой в виде строки, значение channel_visitor_id и channel_chat_id равны

Сообщения дойдут до собеседника, если агент напишет первый в существующем чате

Widget

Да

Кнопки

Widget

Да

Перевод на оператора

Widget

Нет

Передача файлов в виде файлов от Агента (Attachment)

Widget

Нет

Передача файлов в виде ссылок от Агента (Attachment)

Widget

Да

Получение файла от Собеседника в сценарий

Widget

Нет

Получение геолокации от собеседника в сценарии

Widget

Нет

Доставка сообщений более 1000 символов от Агента до Собеседника

Widget

Да

Использование маркдауна

Widget

Нет

Рассылки с помощью Notification

Widget

Нет

Получить ссылку на источник лида

Widget

Да

В переменную channel_visitor_source записана ссылка на страницу, где размещен виджет

PreviousУниверсальный коннектор Chat APINextПоддержка разметки Markdown в Конечных каналах Агента

Last updated