Создание сервиса Microsoft Azure. Подключение Skype бота

Руководство по настройке

Sherlock Platform

Подключение каналов связи

Книга содержит руководство по подключению соцсетей и мессенджеров к Sherlock Platform, а также описание особенностей работы в этих каналах.

Содержание

1 Подключение каналов в Sherlock Platform.. 3

2 Страница ВКонтакте. 4

2.1 Настройка подключения. 4

2.2 Особенности работы ВКонтакте. 8

3 Создание сервиса Microsoft Azure. Подключение Skype бота. 9

3.1 Создание бота в Microsoft Azure. 9

3.2 Подключение бота Microsoft Azure к Sherlock Platform.. 11

4 Подключение бота Telegram.. 12

4.1 Создание бота Telegram с помощью Bot Father 12

4.2 Прямое подключение бота Telegram.. 13

4.3 Подключение бота в настройках сервиса Microsoft Azure. 14

4.4 Добавление бота в группу. 14

5 Подключение страницы Facebook. 15

5.1 Общие настройки для подключения страницы Facebook. 15

5.1.1 Получить Page ID.. 15

5.1.2 Создайте приложение Facebook. 15

5.1.3 Включите мессенджер. 15

5.1.4 Сформировать маркер доступа к странице. 16

5.1.5 Включите webhooks. 16

5.2 Прямое подключение страницы Facebook. 17

5.3 Подключение страницы Facebook через Microsoft Azure. 19

5.3.1 Предоставить webhook callback URL и токен проверки. 19

5.3.2 Укажите параметры доступа Facebook. 19

5.3.3 Включите бота. 20

5.4 Публикация приложения. 20

6 Подключение Viber. 23

6.1 Регистрация публичного аккаунта (public account) или бота Viber 23

6.2 Подключение публичного аккаунта Viber к Sherlock Platform.. 25

7 Настройка виджета и чата на сайт. 26

7.1 Настройка параметров чата на сайт и виджета. 26

7.2 Подключение чата. 26

7.3 Описание входных параметров. 27

7.4 Дизайн специальных элементов. 29

8 Подключение WhatsApp. 30

Подключение каналов в Sherlock Platform

Подключение всех каналов происходит в модуле Настройки, вкладка Каналы.

Рисунок 1.1 Список каналов, подключённых к Sherlock Platform

Часть каналов подключаются прямо к Sherlock Platform, а часть через Microsoft Azure. Прямое подключение используется для:

1. ВКонтакте – смотрите Страница ВКонтакте

2. Viber – смотрите Подключение Viber

3. Telegram

4. Чат на сайт – смотрите Настройка виджета и чата на сайт

Следующие каналы подключаются через Microsoft Azure:

1. Skype Bot – Skype Bot подключается автоматически при регистрации и создании бота в Microsoft Azure. Смотрите Создание сервиса Microsoft Azure. Подключение Skype бота

2. Telegram – смотрите Подключение бота Telegram

3. Facebook – смотрите Подключение страницы Facebook

При добавлении канала указываются параметры подключения, зависящие от конкретного канала и следующие общие реквизиты:

Реквизит	Описание
Имя	Произвольное название канал для отражения в интерфейсе
Бот для обработки	Бот, который будет автоматически запускаться при поступлении обращения из данного канала
Тип запроса по умолчанию	Тип запроса, назначаемый для нового обращения. Может использоваться для последующей обработки и статистики
Создавать новое обращение в канале при наличии открытых обращений в других каналах	Данная опция актуальна, если к Sherlock Platform подключено несколько идентичных каналов. Например, два канала ВКонтакте или Telegram. Опция определяет будет или нет создаваться новое обращение при поступлении вопроса в один канал, если с этим клиентом уже идет общение в другом канале.
Права по умолчанию	В таблице указываются группы и конкретные сотрудники, которым по умолчанию предоставляются права на обращения, поступившие в данный канал

Страница ВКонтакте

Настройка подключения

1. Надо войти ВКонтакте и перейти к администрированию группы

2. Перейти в раздел Работа с API => Ключи доступа и сформировать ключ доступа с правами: сообщения сообщества, фотографии, документы. Ключ необходимо запомнить.

Рисунок 2.1 Профиль ВКонтакте: Создание ключа в ВК

3. В Callback API/Настройки задать CallBack API. Делается в несколько шагов:

a. Сначала Вам надо открыть вкладку и скопировать строку, которую должен вернуть сервер

Рисунок 2.2 Профиль ВКонтакте: Настройки Callback API в ВК

b. Перейти в Sherlock Platform получить адрес сервера и секретный ключ на странице добавления канала.

Дополнительно в профиле канала в Sherlock Platform рекомендуем указать название профиля (рекомендуем название группы ВК), ключ, строку подтверждения и секретный ключ (если был изменен в ВК).

Рисунок 2.3 Профиль ВКонтакте в Sherlock Platform

c. В Callback API/Настройки ввести Адрес сервера (определяется во время установки Sherlock Platform).

Рисунок 2.4 Профиль ВКонтакте: Адрес сервера в ВК

ВАЖНО: ВКонтактене поддерживает указание порта для Call-back адреса. Обязательно использовать стандартный HTTPS порт 443.

d. В Callback API/Типы событий отметить необходимые события канала:

Тип события

Когда требуется включать

Блок Сообщения

Входящее сообщение

Всегда

Исходящее сообщение

Если планируется, что часть ответов будут давать пользователи прямо в ВКонтакте. Не рекомендуется включать для ботов!

Редактирование сообщения

Всегда

Разрешение на получение

Если необходима обработка события на подписку пользователя

Запрет на получение

Всегда

Статус набора текста