Для того чтобы добавить канал в BPMSoft:
Рисунок 1 — Раздел «Настройка чатов BPMSoft OCC»
Рисунок 2 — Деталь «Каналы»
Если на одном веб-сайте используется несколько виджетов (на разные страницы), то названия этих страниц указываются до домена. Например, test.bpmsoftocc.com это страница bpmsoftocc/test.
Обратите внимание на то, что нельзя создать несколько каналов типа «WebSite» с одинаковым доменом. Если будет создан новый канал, использующий тот же домен, старый канал автоматически перестанет работать.
Кнопки «Получить скрипт» (Рисунок 4) и «Копировать» (Рисунок 5) используются для того, чтобы получить скрипт виджета, который необходимо вставить на сайт клиента:
Рисунок 4 — Страница «Добавление канала Сайт», кнопка «Получить скрипт»
Рисунок 5 — Страница «Добавление канала Сайт», кнопка «Копировать»
Примечание. Выбор версии возможен только в настройках на сайте.
Ниже представлен код, который был сгенерирован для виджета. Вам необходимо вставить данный код на страницу и заменить слово «Title» в настройках на сайте на название компании или любой другой заголовок, который будет отражаться в виджете.
<link rel="stylesheet" href="https://bpmsoft-oc-widget1.corporate-domain.ru/3.1/widget.css"> <div id="bpmsoftocc-chat"></div> <script> window.bpmsoftoccconfig = {}; window.bpmsoftoccconfig.channelId = '5f0b2f7b-8ca2-47fe-88eb-312bd3dc641a'; </script> <script src="https://bpmsoft-oc-widget1.corporate-domain.ru/3.1/widget.js" async></script> <script src="https://bpmsoft-oc-widget1.corporate-domain.ru/3.1/chunk-vendors.js" async></script>
Необходимо заменить window.bpmsoftoccconfig.title (название компании) и ID из сгенерированного в BPMSoft кода. С полным списком настроек для виджета вы можете ознакомиться в разделе Полный перечень настроек.
Рисунок 6 — Виджет
Для настройки виджета с возможностью выбора каналов добавьте в стандартный скрипт, представленный выше, дополнительные строки:
<script> window.bpmsoftoccconfig = {}; window.bpmsoftoccconfig.title = "Dev7"; window.bpmsoftoccconfig.channelId = 'ChannelId'; // генерируется при создании канала в CRM window.bpmsoftoccconfig.connectorUrl = 'https://connector.ai.bpmsoft.ru'; // адрес коннектора window.bpmsoftoccconfig.srcUrl = 'https://widget.ai.bpmsoft.ru/src'; // адрес виджета для IIS window.bpmsoftoccconfig.showChannelPanel = true; window.bpmsoftoccconfig.menuButtonIcon = 'https://widget.ai.bpmsoft.ru/src/More.png'; // Настройки надписей для виджета. Локализировать при необходимости window.bpmsoftoccconfig.chatMessagePlaceholder ="Enter message..."; window.bpmsoftoccconfig.closeChatCaption = "Close chat"; window.bpmsoftoccconfig.chatButtonsPlaceholder = 'Please select one of the following options'; window.bpmsoftoccconfig.initialMessageText = "A client opened the webchat"; window.bpmsoftoccconfig.channelPanelHeader = 'Choose a channel to continue your communication '; window.bpmsoftoccconfig.backToChannelChooseCaption = 'Back to the list of channels'; // Список каналов на выбор. В поле link введите URL для перенаправления, а также можете локализировать при необходимости: window.bpmsoftoccconfig.channelsInPanel = [ { type : "widget", name : "Continue on this website" }, { type : "telegram", name : "Telegram", link : "" }, { type : "whatsapp", name : "WhatsApp", link : "" }, ]; </script>
Параметр clientId используется для идентификации конкретного клиента, то есть пользователя, написавшего в чат.
По умолчанию идентификатор клиента формируется как строка, состоящая из букв латинского алфавита, цифр и символа нижнего подчеркивания (_). Примеры идентификаторов: CZj0vIXT2fmT_4kEyfDmUw, WFfu3kXZJHiPbyYVnNEOnA.
Учитывайте, что через 50 минут сессия клиента завершается, и идентификатор может измениться. За длительность хранения отвечает параметр window.bpmsoftoccconfig.cookieSessionTime, значение которого задается в миллисекундах.
В параметр clientId на стороне виджета можно задать значение с помощью настройки window.bpmsoftoccconfig.clientId. В качестве значения можно использовать любую строку. Логику заполнения clientId можно настроить в соответствии с вашими требованиями. Для канала «Виджет» необходимо сгенерировать код для вставки на страницу, затем при инициализации виджета заполнить его настройки и передать желаемое значение clientId в Cookie. Пример такой настройки виджета приведен ниже:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Виджет для демонстрации примера работы с clientId</title> </head> <body> <link rel="stylesheet" href="https://bpmsoft-oc-widget1.corporate-domain.ru/3.2/widget.css"> <div id="bpmsoftocc-chat"></div> <h1>Виджет для демонстрации примера работы с clientId</h1> <script> window.bpmsoftoccconfig = {}; window.bpmsoftoccconfig.clientId = 'clientId-example-123-4321_ABCDEF'; window.bpmsoftoccconfig.channelId = 'a831d584-d557-4448-8bc6-761c2785c53b'; /* Простой пример инициализации cookie. Ключом служит строка "bpmsoftocc:{идентификатор-канала}", а значением желаемый clientId */ document.cookie = `bpmsoftocc:${window.bpmsoftoccconfig.channelId.toUpperCase()}=${window.bpmsoftoccconfig.clientId}`; window.bpmsoftoccconfig.connectorUrl = 'https://connector.example.com'; window.bpmsoftoccconfig.fileServerUrl = 'https://fileservice.example.com'; </script> <script src="https://bpmsoft-oc-widget1.corporate-domain.ru/3.2/widget.js" async></script> <script src="https://bpmsoft-oc-widget1.corporate-domain.ru/3.2/chunk-vendors.js" async></script> </body> </html>
Все клиенты, с которыми происходит взаимодействие, сохраняются в объекте BPMSoftOCCClient. У этого объекта есть поле InternalId, куда для канала «Виджет» будет записан clientId. Используя clientId можно связать клиента, написавшего в чат, и контакт в BPMSoft.
Примечание. По умолчанию канал «Виджет» не связывает клиента, написавшего в чат, и контакт, как это возможно в других каналах.
Для изменения цвета шапки необходимо добавить в стили: #bpmsoftoccchat-container .bpmsoftoccchat-conversation-body-profile { background: #4d1965 !important; }
Укажите цвет обозначением шестнадцатеричной системы счисления.
Рисунок 7 — Шапка виджета
В конец <body> вставьте скрипт, заменив число 5000 на необходимое количество миллисекунд, после которых виджет будет открываться автоматически.
<script> setTimeout(()=>{ document.getElementById('bpmsoftoccchat-widget-startbutton').click(); }, 5000); </script>
Для изменения строки необходимо в скрипт добавить текст, например, «Оператор скоро ответит! Подождите, пожалуйста!»: window.bpmsoftoccconfig.welcomeMessage = { text: "Оператор скоро ответит! Подождите, пожалуйста!" };
Для изменения цвета фона необходимо добавить в стили: .bpmsoftoccchat-operatorinfo-message {background-color: #ff6161!important;}
Для изменения цвета текста необходимо добавить в стили: .bpmsoftoccchat-operatorinfo-message-phrase {color: #ffffff !important;}
Для изменения цвета области вокруг сообщений необходимо добавить в стили: .bpmsoftoccchat-comment{background: #999999 !important; }
Для замены цвета текста сообщений оператора необходимо добавить в стили: .bpmsoftoccchat-comment-container-admin p.bpmsoftoccchat- { color: #ffffff !important; }
Для замены цвета и прозрачности фона виджета необходимо добавить в стили: div#bpmsoftoccchat-main-feed { background-color: rgba(203,210,234,.86) !important;}
Вместо rgba(203,210,234,.86) укажите цвет и прозрачность.
Для изменения цвета и прозрачности фона виджета на определенном размере экрана (или при открытии виджета с мобильных устройств, открытии DevTools) необходимо добавить в стили: @media screen and (max-width: 980px) { div#bpmsoftoccchat-main-feed { background-color: rgba(203,210,234,.86) !important;}}
Примечание. Вы можете отдельно установить в браузере настройку по проверке орфографии.
Ниже предоставлен полный перечень кастомных настроек для виджета (window.bpmsoftoccconfig):
Таблица 1 — Перечень кастомных настроек
<script> window.bpmsoftoccconfig.connectorUrl = "https://bpmsoft-oc-connector1.corporate-domain.ru"; window.bpmsoftoccconfig.srcUrl = 'https://bpmsoft-oc-widget1.corporate-domain.ru/src'; window.bpmsoftoccconfig.fileServerUrl = "https://bpmsoft-oc-fileservice1.corporate-domain.ru"; window.bpmsoftoccconfig.channelId = ""; window.bpmsoftoccconfig.title = ""; window.bpmsoftoccconfig.subtitle = ""; window.bpmsoftoccconfig.footerTitle = ""; window.bpmsoftoccconfig.footerTitleName = ""; window.bpmsoftoccconfig.footerLink = ""; window.bpmsoftoccconfig.chatMessagePlaceholder = "Enter message..."; window.bpmsoftoccconfig.chatButtonsPlaceholder = "Please select one of the following options"; window.bpmsoftoccconfig.fileLoadingPlaceholder = "Loading file..."; window.bpmsoftoccconfig.closeChatCaption = 'Minimize'; window.bpmsoftoccconfig.saveFeedCaption = "Save messaging history"; window.bpmsoftoccconfig.pdhHeaderCaption = "Messaging with agent history"; window.bpmsoftoccconfig.pdfOperatorSignCaption = "Agent phrase"; window.bpmsoftoccconfig.pdfClientSignCaption = "My phrase"; window.bpmsoftoccconfig.localStorageLifeTime = 30; window.bpmsoftoccconfig.clientId = ""; window.bpmsoftoccconfig.disableInputOnButtonMessages = true; window.bpmsoftoccconfig.sendInitialMessageOnWidgetButtonClick = true; window.bpmsoftoccconfig.initialMessageText = 'A client opened the webchat'; window.bpmsoftoccconfig.welcomeMessage = null; window.bpmsoftoccconfig.timeFormatFuntion = function(timestamp) { var date = new Date(timestamp); return `${date.getHours()}:${(date.getMinutes() < 10) ? "0" + date.getMinutes() : date.getMinutes()}`; }; window.bpmsoftoccconfig.showChannelPanel = false; window.bpmsoftoccconfig.channelPanelHeader = 'Choose a channel to continue your communication '; window.bpmsoftoccconfig.enableFileUpload = true; window.bpmsoftoccconfig.backToChannelChooseCaption = "Back to the list of channels"; window.bpmsoftoccconfig.errorFileUploadString = "Error"; window.bpmsoftoccconfig.successFileUploadString = "Loaded"; window.bpmsoftoccconfig.widgetButtonColor = "#FFCB02"; window.bpmsoftoccconfig.widgetButtonColorLine = "#130658"; window.bpmsoftoccconfig.isClientTyping = false; window.bpmsoftoccconfig.startButtonSvg = null; window.bpmsoftoccconfig.isEmojiVisible = false; window.bpmsoftoccconfig.operatorInfoMessage = "Your agent is {0}"; window.bpmsoftoccconfig.visible = true; window.bpmsoftoccconfig.canOperatorInitializeChat = false; window.bpmsoftoccconfig.cookieSessionTime = 3000000; window.bpmsoftoccconfig.showOperatorNameUnderAvatar = false; window.bpmsoftoccconfig.connectWssWithoutClick = true; window.bpmsoftoccconfig.withoutStartButton = false; // Следующие конфиги содержат значение window.bpmsoftoccconfig.srcUrl; это означает что при изменении данной настройки, по умолчанию будут меняться и конфиги внизу // Вы также можете вручную установить нужные Вам значения. Пример: window.bpmsoftoccconfig.bpmsoftoccDownloadIcon = 'http:/bpmsoft-oc-widget1.corporate-domain.ru/src/n-download.svg' window.bpmsoftoccconfig.bpmsoftoccDownloadIcon = `${window.bpmsoftoccconfig.srcUrl}/n-download.svg`; window.bpmsoftoccconfig.bpmsoftoccDownloadClientIcon = `${window.bpmsoftoccconfig.srcUrl}/n-downloadClient.svg`; window.bpmsoftoccconfig.operatorAvatar = `${window.bpmsoftoccconfig.srcUrl}/OperatorAvatar.png`; window.bpmsoftoccconfig.footerImageLogo = `${window.bpmsoftoccconfig.srcUrl}/mini-logo-grey.png`; window.bpmsoftoccconfig.attachFileButton = `${window.bpmsoftoccconfig.srcUrl}/n-upload-button.svg`; window.bpmsoftoccconfig.emojiIcon = `${window.bpmsoftoccconfig.srcUrl}/n-smile.svg`; window.bpmsoftoccconfig.pulseImage = `${window.bpmsoftoccconfig.srcUrl}/n-pulseImage.svg`; window.bpmsoftoccconfig.widgetButtonSrc = `${window.bpmsoftoccconfig.srcUrl}/faq-icon.png`; window.bpmsoftoccconfig.headerImageSrc = `${window.bpmsoftoccconfig.srcUrl}/bpmsoft.svg`; window.bpmsoftoccconfig.sendButtonIcon = `${window.bpmsoftoccconfig.srcUrl}/n-send-button.svg`; window.bpmsoftoccconfig.menuButtonIcon = `${window.bpmsoftoccconfig.srcUrl}/more.png`; window.bpmsoftoccconfig.themeColor = "#F9763D"; /* Список каналов на выбор. В поле link введите URL для перенаправления, а также можете локализировать при необходимости: window.bpmsoftoccconfig.channelsInPanel = [ { type : "widget", name : "Continue on this website" }, { type : "telegram", name : "Telegram", link : "" }, { type : "whatsapp", name : "WhatsApp", link : "" }, ]; */ // Если вам не нужен список каналов на выбор, то по умолчанию стоит следующее значение window.bpmsoftoccconfig.channelsInPanel = null; </script>
Настройка каналов Создание операторов
Ссылка, по которой вы перешли, больше недействительна — её срок действия закончился. Ссылка активна в течение 24 часов.
Вы можете запросить новую ссылку.
До встречи в экосистеме BPMSoft.
Теперь вы зарегистрированы в экосистеме BPMSoft. Авторизуйтесь, чтобы получить доступ ко всем её возможностям.
Если у вас возникнут трудности с использованием сайта или сервисов, вы всегда можете обратиться к нам за помощью.
К сожалению, ссылка больше не активна — она действовала только 24 часа.
Здравствуйте.
Эта ссылка больше недействительна, так как вы запрашивали новую.
Перейдите по последней ссылке или запросите новую.
Ссылка, по которой вы перешли, недействительна.
Если вы хотите восстановить пароль, просто запросите новую ссылку.
Ваш пароль успешно обновлён — теперь вы можете пользоваться всеми возможностями экосистемы BPMSoft.
Ваш пароль успешно изменен, вы можете продолжить работу в экосистеме BPMSoft.
Учётная запись пока не активирована.
Мы отправили письмо для подтверждения на ваш Email — перейдите по ссылке в течение 24 часов с момента регистрации.
Если письмо не пришло, пожалуйста, напишите нам об этом.
До встречи в экосистемe BPMSoft.
Учетная запись заблокирована
Пожалуйста, свяжитесь с нами для уточнения данных.
Если пользователь с указанным Email зарегистрирован в системе BPMSoft, ему на почту отправлена ссылка для восстановления пароля.
Чтобы установить новый пароль, перейдите по ссылке из письма.
Ссылка активна в течение 24 часов.