Интеграция Skype Custom для персонального использования

Чтобы подключить отправку уведомлений через Skype, пользователю нужно создать Skype-бот в облачной платформе Microsoft Azure.

Посмотреть подробную инструкцию, как создать бот Skype в Microsoft Azure >>

Но чтобы все заработало, важно настроить интеграцию и разрешить подписку в свойствах нужного канала Notify.Events.

Если хотя бы один из этих пунктов не был выполнен, на этапе подписки на канал вы увидите такое сообщение:

Шаг 1. Настройка интеграции

1. Перейдите на экран Интеграции. Это можно сделать через выпадающее меню в верхнем правом углу экрана. Перед этим убедитесь, что вы залогинены в системе.

2. Нажмите на кнопку Создать.

3. Кликните по карточке Skype Custom.

4. Заполните все необходимые поля в карточке интеграции:

• Название – задайте индивидуальное или оставьте исходное.
• Bot name – скопируйте Bot handle из панели бота в Microsoft Azure (Settings > Bot Profile).

• Client ID – скопируйте Microsoft App ID из панели бота в Microsoft Azure (Settings > Configuration).

• Client Secret – создайте Client Secret в панели бота в Microsoft Azure (Settings > Configuration > Microsoft App ID - Manage > New client secret > Expires - 24 months > Add) и скопируйте строку Value.

• Обрабатывать входящие сообщения (и позволять подписываться через интерфейс Notify.Events) – поставьте галочку, чтобы Notify.Events мог обрабатывать входящие уведомления, а вы получали их в Skype.

• Incoming Message URL – скопируйте и вставьте сгенерированный персональный адрес в поле Messaging endpoint в настройках вашего бота в Microsoft Azure (Settings > Configuration) и проставьте галочку в поле Enable Streaming Endpoint.

5. После нажатия на кнопку Сохранить созданная интеграция появится на экране Интеграции.

Шаг 2. Разрешение подписки

1. Перейдите в свойства канала через кнопку Редактировать на главном экране Панели управления или на экране канала.

2. Поставьте галочку напротив Skype Custom в поле Разрешить подписку через интеграцию и нажмите кнопку Сохранить. Skype Custom будет отображаться в этом поле только после успешного выполнения Шага 1.

На следующем этапе вы сможете добавить кастомную интеграцию на канал.

Шаг 3. Добавление кастомной интеграции на канал

После того как вы настроили интеграцию Skype Custom и разрешили подписку, вы сможете добавить ее на выбранный канал в качестве получателя. Для этого:

1. На экране канала нажмите кнопку Подписаться в разделе Получатели.

2. На экране Подписка на канал выберите Skype Custom.

3. Нажмите на кнопку, чтобы добавить бот в свой список контактов.

4. Если вы авторизованы в Skype, в новом окне автоматически откроется диалог с вашим ботом. Скопируйте команду подписки и отправьте ее в диалог. Вы можете изменить язык на русский, отправив команду locale ru.

Важно! Сразу после создания бот может не реагировать на команды. Подождите 15-20 минут и отправьте команду подписки заново. При последующих подписках через тот же бот задержка обычно не возникает.

Готово! Теперь подписка появится в разделе Получатели на экране канала, и вы будете получать уведомления из заданных сервисов в Skype.

Создание и настройка бота Skype в Microsoft Azure

Чтобы подключить интеграцию Skype Custom, нужно создать бот Skype через приложение Azure Bot. Для этого нужно будет залогиниться в Microsoft Azure. Если вы еще не зарегистрированы, создайте бесплатный аккаунт через электронную почту, номер телефона, логин Skype или учетные данные GitHub.

Сейчас Microsoft Azure не разрешает регистрацию новых пользователей из России и просит подтвердить аккаунт данными зарубежной кредитной или дебетовой карты.

1. На домашней странице Microsoft Azure зайдите в существующую ресурсную группу или создайте новую. Создайте новый ресурс с помощью кнопки Create.

2. Найдите Azure Bot через поисковую строку в Marketplace и кликните по карточке.

3. Создайте бот через кнопку Create.

4. Заполните требуемые поля:
• Bot Handle – задайте произвольное имя бота.
• Pricing – выберите бесплатный тариф Free. Вероятнее всего, его будет достаточно для использования бота.
• Type of App – выберите Multi Tenant.
• Creation Type – выберите Create new Microsoft App ID.

Нажмите кнопку Review + Create, и подтвердите создание бота на следующей странице.


5. Когда процесс создания будет завершен, вы увидите сообщение “Your deployment is complete” и активную кнопку Go to resource – нажмите на нее. Теперь бот появится в списке ресурсов.

6. Из профиля бота перейдите в Settings > Channels и выберите Skype.

7. Убедитесь, что во вкладке Messaging стоит галочка в строке Enable messaging (иначе сообщения в Skype не будут доходить). Если вы планируете добавлять бот в групповые чаты, перейдите во вкладку Groups, поставьте галочку для Enable adding to a group и нажмите Apply внизу экрана, чтобы сохранить изменения.

Поздравляем, вы создали бота Skype! Теперь вы можете вернуться наверх к инструкции и настроить интеграцию Skype Custom, чтобы начать получать уведомления через ваш бот.