Подключение публичного аккаунта Viber к Sherlock Platform
4. Перейти в Sherlock Platform и добавить канал Viber:
5. В настройках подключения канала указать
a. Имя паблик аккаунта
b. Ключ доступа (Viber App Key)
6. Дополнительно в настройках канала в Sherlock Platform рекомендуем указать имя профиля.
Настройка виджета и чата на сайт
Настройка параметров чата на сайт и виджета
Настройка видимости и дизайна элементов виджета и чата осуществляется настройкой css файла чата. Актуальный css доступен по ссылке https://app-s3.sherlockcrm.ru/api/demo7-00007/Scripts/ChatPlatform/chatBot.css
Подключение чата
Для подключения чата необходимо:
1. В заголовок включить ссылку на стили чата
<link rel =" stylesheet " type =" text/css " href =" https://app-s3.sherlockcrm.ru/api/demo7-00007/Scripts/ChatPlatform/chatBot.css " />
2. Для корректной работы на мобильных устройствах в заголовок добавить строку:
<meta name="viewport" content="initial-scale=1.0">
3. Включить ссылку на библиотеку чата
<script src =" https://app-s3.sherlockcrm.ru/api/demo7-00007/Scripts/ChatPlatform/chatBot.js "></script>
4. Включить скрипт вызова чата
<script>
function callChat() {
var params = {
settings: {
channelsIds: ["id1","id2"]
}
};
if (window.SherlockChat !== undefined) {
// api, params, callback
let chat = new window.SherlockChat('https://app-s3.sherlockcrm.ru/api/demo7-00007/', params, null, null);
chat.InitWidget(); // для старта виджета
// chat.Init(); // для старта чата
} else {
setTimeout(() => {
callChat();
}, 100);
}
}
callChat();
</script>
|
|
5. В скрипте чата chatBot. js указать каналы
a. Взять идентификаторы каналов (в модуле Настройки => Каналы или из базы данных запросом SELECT ID FROM tbl_UserProfile)
b. Указать в Json с параметрами вызова каналы в формате channels:["id1","id2"]
Описание входных параметров
В функцию создания чата передаются 3 параметра:
1. API – URL API Sherlock Platform
2. Входные параметры в формате JSON
3. Адрес call-back функции для уведомлений о событиях чата
Формат JSON для входных параметров следующий:
{
externalId: null,
clientData: {
FullName:'',
Phone: '',
Email: ''
},
params: {},
settings: {
chatFormMode: 0,
channelsMode: 0,
editorMode: 0,
buttonCloseColor: null,
buttonSentColor: null,
container : null,
channelsIds: ["<Guid 1>", "<Guid 2>"],
blockClientTemplate : 'Ваш IP адрес <ip> заблокирован до <date> по причинам <reason>'
},
formFields: [
{ name: 'Full Name', code: 'FullName', isRequired: true },
{ name: 'Phone', code: 'Phone', isRequired: false },
{ name: 'Email', code: 'Email', isRequired: false }
],
strings: {
startChatBtn: 'Start!'
}
}
Где:
· ExternalId – идентификатор клиента во внешней системе. Если найден в Sherlock Platform, то откроется существующий чат с отражением истории
|
|
· clientData – данные для инициализации чата. Если данные клиента переданы, то не отражается форма запроса данных клиента
· params – любые параметры, которые будут сохранены в контекст бота для последующей обработки
· settings – настройки чата. Сейчас поддерживается
o chatFormMode – открывать или нет форму запроса данных клиента (0 – открывать, 1 – не открывать).
o channelsMode – открывать сразу чат или панель с иконками каналов (0 – сразу чат, 1 – панель с иконками)
o editorMode – режим редактора в чате (0 – поле ввода в несколько строк, 1 – в одну строку в стиле Telegram
o Container – id div панели на которой разместить виджет и чат. Если null, то виджет и чат открываются по правому краю экрана
o channelsIds – список идентификаторов каналов из таблицы tbl_UserProfile
o logoUrl – ссылка на логотип, отражаемый при открытии чата по умолчанию (до назначения оператора)
o operatorName – имя, отражаемое при открытии чата по умолчанию (до назначения оператора)
· formFields – настройки формы запроса информации при старте чата. Для каждого поля указывается заголовок, предопределенный код и обязательность
· strings – указываются строки, необходимые для локализации чата
Дизайн специальных элементов
1. Фиксированная высота чата
|
|
a. Выставляется высота в css для #sherlockChat
b. В JavaScript меняется формула расчета для messages.js
2. Настройка разного отражения на desktop и мобильных выполняется заданием разных стилей в зависимости от разрешения.
Например:
@media (min-width: 600px) and (max-width: 700px) {
/* Замещаем стили для окон шириной 600-700 пикселов. */
}
@media (min-width: 400px) and (max-width: 599.99px) {
/* Замещаем стили для окон шириной 400-600 пикселов. */
}
@ media ( max- width: 399.99 px) {
/* Замещаем стили для окон шириной до 400 пикселов. */
}
Смотрите http://professorweb.ru/my/css/css_theory/level1/1_5.php для информации
Подключение WhatsApp
Для подключения WhatsApp к Sherlock Platform необходимо получить URL и токен API для подключения номера. Стоимость подключения одного номера составляет 1000 рублей в месяц за каждый номер.
Для подключения номера к Sherlock Platform необходимо:
1. Перейти в Sherlock Platform и добавить канал WhatsApp:
2. В настройках подключения канала указать:
a. Номер телефона
b. URL API
c. Токен
При корректном вводе URL и токена отразится QR код для сканирования:
3. В WhatsApp выбрать пункт WhatsApp Web и отсканировать
4. Дополнительно в настройках канала в Sherlock Platform рекомендуем указать имя профиля.
Примечание:
1. В случае, если в пункте 3 QR код не принимается (код имеет ограниченное время действия), необходимо закрыть окно и повторить действия пункта 2.
|
|
2. Для работы номера необходимо, чтобы WhatsApp был подключен к Интернет на смартфоне.
3. Для переключения номера на другой необходимо сначала в WhatsApp отключить подключение первого номера. И затем повторить шаги 2 и 3.
Дата добавления: 2018-09-20; просмотров: 289; Мы поможем в написании вашей работы! |
Мы поможем в написании ваших работ!