ボットを作成する

  • [アーティクル]

重要

この記事は、v3 Bot Framework SDK に基づいています。 SDK の現在のドキュメント バージョン 4.6 以降をお探しの場合は、「 会話ボット 」セクションを参照してください。

Microsoft Bot Framework を使用して作成されたすべてのボットは構成済みであり、Microsoft Teams で動作する準備ができています。

詳細については、 ボットに関する一般的な情報のための「Bot Framework ドキュメント」を参照してください。

Microsoft Teams 用にボットを作成する

Teams 開発者ポータル for Teams は、ボットの作成に役立つツールと、ボットを参照するアプリ パッケージです。 React 制御ライブラリとカード用の構成可能なサンプルも含まれています。 詳細については、「 Teams 開発者ポータル for Teams の概要」を参照してください。 次の手順では、ボットを手動で構成し、 Teams 用 Teams 開発者ポータルを使用しないことを前提としています。

  1. Bot Framework を使用してボットを作成します。 ボットの作成後は必ず、おすすめのチャネル一覧に Microsoft Teams をチャネルとして登録します。 アプリ パッケージ/マニフェストを既に作成している場合は、生成した Microsoft アプリ ID を自由に再利用してください。

    Bot Framework の登録ページ

注:

ボットを Azure で作成しない場合は、こちらのリンクを使用して新しいボットを作成する必要があります (Bot Framework)。 代わりに、Bot Framework ポータルで [ボットを作成する] をクリックすると、代わりに Microsoft Azure でボットが作成されます。

  1. Microsoft.Bot.Connector.Teams NuGet パッケージ、Bot Framework SDK、または Bot Connector API を使用してボットをビルドします。

  2. Bot Framework Emulator を使用してボットをテストします。

  3. Microsoft Azure などのクラウド サービスにボットをデプロイします。 または、アプリをローカルで実行し、ngrok などのトンネリング サービスを使用して、https://45az0eb1.ngrok-free.app/api/messages など、ボットの https:// エンドポイントを公開します。

注:

ボットと Microsoft Azure

2017 年 12 月の時点で、Bot Framework ポータルは、Microsoft Azure でのボットの登録に最適化されています。 留意事項がいくつかあります。

  • Azure で登録したボット用の Microsoft Teams チャネルは無料です。 Teams チャネル経由で送信されるメッセージは、ボットの消費メッセージとしてはカウントされません。
  • Azure を使用せずに新しい Bot Framework ボットの作成は可能ですが、Bot Framework ポータルで公開されなくなった、新しい Bot Framework ボットの作成を使用する必要があります。
  • Bot Framework 内のボットのリストで既存のボットのプロパティを編集する際、特に ngrok を使用している場合、ボットを初めて開発するときに一般的な "メッセージングエンドポイント" などを編集すると、[移行の状態] 列と青い [移行] ボタンが表示され、Microsoft Azure portal に移動します。 必要な場合を除き、[移行] ボタンをクリックしないでください。代わりに、ボットの名前をクリックして、そのプロパティを編集できます:
    ボットのプロパティの編集
  • Microsoft Azure を使用してボットを登録する場合、ボット コードは Microsoft Azure でホストされる必要はあります。
  • Azure ポータルを使用してボットを登録する場合は、Microsoft Azure アカウントを持っている必要があります。 このアカウントは無料で作成できます。 ID を作成するときに本人確認を行うには、クレジット カードを指定する必要がありますが、課金されることはありません。Teams でボットを作成して使用するのは常に無料です。
  • Teams 用開発者ポータルを使用して、Teams 内でアプリとボットの情報を直接登録/更新できるようになりました。 Direct Line、Web チャット、Skype、Facebook Messenger などの他のBot Framework チャネルを追加または構成する場合にのみ、Azure portal を使用する必要があります。

関連項目

Bot Framework サンプル。