Azure CLI を使用してボットをチャネルへ接続する

  • [アーティクル]

チャネルは、通信アプリケーションとボットとの間の接続です。 Azure に登録されているボットは、チャネルを使用してユーザーとの通信を有効にします。 この記事にあるコマンドは、ボットをさまざまなチャネルに接続します。 詳細情報については、「ボットをチャネルに接続する」を参照してください。

前提条件

  • Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。

  • CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。

    • ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、Azure CLI でのサインインに関するページを参照してください。

    • 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。

    • az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。

サンプル コマンド

次のセクションでは、Azure CLI コマンドを使用してボットをチャネルに接続します。 これらの例では、ContosoBotRG リソース グループに ContosoBot と名付けられたボットを使用します。

これらのチャネルの一部では、認証するためにアプリケーションに接続するコマンドが必要です。 テスト目的でこれらのコマンドを実行している場合、実際の値を使用しないと失敗する可能性があります。

Direct Line

Direct Line は、ボットをモバイル アプリ、Web ページ、またはその他のアプリケーションに統合します。 詳細については、「Direct Line の概要」を参照してください。

これらのサンプル コマンドでは、az bot directline create を使用して Direct Line チャネルへの接続を作成します。 この例では、コンソールで接続を示し、接続を削除します。

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 メールに接続する」を参照してください。

これらのサンプル コマンドは、az bot email create を使用して Office 365 メールのチャネルへの接続を作成します。 この例では、コンソールで接続を示し、接続を削除します。

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 に接続する」を参照してください。

これらのサンプル コマンドでは、az bot facebook create を使用して Facebook のチャネルへの接続を作成します。 この例では、コンソールで接続を示し、接続を削除します。

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 に接続する」を参照してください

これらのサンプル コマンドでは、az bot msteams create を使用して Microsoft Teams のチャネルへの接続を作成します。 この例では、コンソールで接続を示し、接続を削除します。

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 に接続する」を参照してください。

これらのサンプル コマンドは、az bot skype create を使用して Skype のチャネルへの接続を作成します。 この例では、コンソールで接続を示し、接続を削除します。

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 に接続する」を参照してください。

これらのサンプル コマンドは、az bot slack create を使用して Slack のチャネルへの接続を作成します。 この例では、コンソールで接続を示し、接続を削除します。

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

これらのサンプル コマンドでは、az bot sms create を使用して SMS のチャネルへの接続を作成します。 この例では、コンソールで接続を示し、接続を削除します。

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 を使用して Telegram のチャネルへの接続を作成します。 この例では、コンソールで接続を示し、接続を削除します。

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

チャネルへの接続を削除するには、適切な delete コマンドを使用します。

この記事で使用されている Azure CLI コマンド

この記事では、次の Azure CLI コマンドが使用されています。

次のステップ