Подключение бота в каналы с помощью Azure CLI

Статья
10/09/2024

Канал — это подключение между коммуникационным приложением и ботом. Бот, зарегистрированный в Azure, использует каналы для взаимодействия с пользователями. Команды, приведенные в этой статье, подключают бота к различным каналам. Дополнительные сведения см. в разделе Подключение бота в каналы.

Необходимые компоненты

Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см . в кратком руководстве по Bash в Azure Cloud Shell.
Если вы предпочитаете выполнять справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.
- Если вы используете локальную установку, выполните вход в Azure CLI с помощью команды az login. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.
- Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.
- Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

Бот, развернутый в Azure. Если у вас еще нет одного, ознакомьтесь с руководством по подготовке бота в Azure и учебнике. Публикация базового бота.

Примеры команд

В следующих разделах используются команды Azure CLI для подключения бота к каналу. В этих примерах используется бот с именем ContosoBot в ContosoBotRG группе ресурсов.

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

Direct Line

Direct Line интегрирует бота в мобильное приложение, веб-страницу или другие приложения. См. сведения о Direct Line.

Эти примеры команд создают подключение к каналу Direct Line с помощью az bot directline create. В примере показано подключение в консоли и удаляется соединение.

az bot directline create --resource-group ContosoBotRG --name ContosoBot --disablev1
az bot directline show --resource-group ContosoBotRG --name ContosoBot
az bot directline delete --resource-group ContosoBotRG --name ContosoBot

Электронная почта Office 365

Вы можете разрешить боту взаимодействовать с пользователями с помощью электронной почты Office 365. Дополнительные сведения см. в статье Подключение бота по электронной почте Office 365.

Эти примеры команд создают подключение к каналу для электронной почты Office 365 с помощью az bot email create. В примере показано подключение в консоли и удаляется соединение.

az bot email create --resource-group ContosoBotRG --name ContosoBot \
   --email-address ContosoBot@outlook.com --password <password>
az bot email show --resource-group ContosoBotRG --name ContosoBot
az bot email delete --resource-group ContosoBotRG --name ContosoBot

Facebook

Вы можете подключить бота как к Facebook Messenger, так и к Facebook Workplace. Он может взаимодействовать с пользователями на обеих платформах. Дополнительные сведения см. в разделе Подключение бота в Facebook.

Эти примеры команд создают подключение к каналу для Facebook с помощью az bot facebook create. В примере показано подключение в консоли и удаляется соединение.

az bot facebook create --resource-group ContosoBotRG --name ContosoBot --appid <myAppId> \
   --page-id <myPageId> --secret <secret> --token <token>
az bot facebook show --resource-group ContosoBotRG --name ContosoBot
az bot facebook delete --resource-group ContosoBotRG --name ContosoBot

Microsoft Teams

Бот можно настроить для взаимодействия с Microsoft Teams. Дополнительные сведения см. в статье Подключение бота в Microsoft Teams.

Эти примеры команд создают подключение к каналу Microsoft Teams с помощью az bot msteams create. В примере показано подключение в консоли и удаляется соединение.

az bot msteams create --resource-group ContosoBotRG --name ContosoBot --calling-web-hook https://www.contosoapp.com/ \
   --enable-calling 
az bot msteams show --resource-group ContosoBotRG --name ContosoBot 
az bot msteams delete --resource-group ContosoBotRG --name ContosoBot

Skype

Бот можно настроить для взаимодействия с Skype. Дополнительные сведения см. в разделе Подключение бота в Skype.

Эти примеры команд создают подключение к каналу для Skype с помощью az bot skype create. В примере показано подключение в консоли и удаляется соединение.

az bot skype create --resource-group ContosoBotRG --name ContosoBot --enable-messaging --enable-screen-sharing
az bot skype show --resource-group ContosoBotRG --name ContosoBot 
az bot skype delete --resource-group ContosoBotRG --name ContosoBot

Slack

Бот можно настроить для взаимодействия с пользователями через Slack. Дополнительные сведения см. в разделе Подключение бота в Slack.

Эти примеры команд создают подключение к каналу для Slack с помощью az bot slack create. В примере показано подключение в консоли и удаляется соединение.

az bot slack create --resource-group ContosoBotRG --name ContosoBot --client-id <clientid> \
   --client-secret <secret> --verification-token <token>
az bot slack show --resource-group ContosoBotRG --name ContosoBot
az bot slack delete --resource-group ContosoBotRG --name ContosoBot

SMS

Эти примеры команд создают подключение к каналу sms с помощью az bot sms create. В примере показано подключение в консоли и удаляется соединение.

az bot sms create --resource-group ContosoBotRG --name ContosoBot --account-sid <sid> --auth-token <token> \
   --phone <smsphonenumber> --is-validated
az bot sms show --resource-group BotRG
az bot sms delete --resource-group BotRG

Бот можно настроить для взаимодействия с пользователями через Telegram. Дополнительные сведения см. в разделе Подключение бота в Telegram.

Эти примеры команд создают подключение к каналу для Telegram с помощью az bot telegram create. В примере показано подключение в консоли и удаляется соединение.

az bot telegram create --resource-group ContosoBotRG --name ContosoBot --access-token <token> --is-validated
az bot telegram show --resource-group ContosoBotRG --name ContosoBot 
az bot telegram delete --resource-group ContosoBotRG --name ContosoBot

Очистка развертывания

Если вы создали группу ресурсов для тестирования, выполните команду az group delete , чтобы удалить группу ресурсов и все, что она содержит.

az group delete --name ContosoBotRG

Чтобы удалить подключение к каналу, используйте соответствующую команду удаления.

Команды Azure CLI, используемые в этой статье

В рамках этой статьи использованы следующие команды Azure CLI.

Поделиться через