DIRECT LINE API 3.0 の主な概念

ボットと独自のクライアント アプリケーションの間の通信を有効にするには、Direct Line API を使用します。 この記事では、DIRECT LINE API 3.0 の主要な概念について説明し、関連する開発者リソースに関する情報を提供します。 SDK、REST API、または API を使用してクライアントをビルドWeb チャット。

認証

Direct Line API 3.0 要求は、Azure Portal の Direct Line チャネル構成ページから取得したシークレットを使用するか、実行時に取得するトークンを使用して認証できます。 詳細については、「認証」を 参照してください

会話の開始

Direct Lineはクライアントによって明示的に開かれ、ボットとクライアントが参加し、有効な資格情報を持っている限り実行できます。 詳細については、「会話を開始 する」を参照してください

メッセージの送信

クライアントDirect Line API 3.0 を使用して、要求を発行することでボットにメッセージをHTTP POST送信できます。 クライアントは、要求ごとに 1 つのメッセージを送信できます。 詳細については、「ボットに アクティビティを送信する」を参照してください

メッセージの受信

クライアントDirect Line API 3.0 WebSocket を使用して、ストリームまたは要求を発行することで、ボットからメッセージをHTTP GET受信できます。 これらの手法のいずれかを使用して、クライアントは、 の一部として一度にボットから複数のメッセージを受信できます ActivitySet。 詳細については、ボットからのアクティビティ の受信に関するページを参照してください

開発者リソース

クライアント ライブラリ

Bot Framework には、api 3.0 へのアクセスを容易にするクライアント ライブラリがDirect Lineを介して api 3.0 にC#提供Node.js。

  • プロジェクト内で .NET クライアント ライブラリを使用Visual Studio、次のパッケージNuGetMicrosoft.Bot.Connector.DirectLineインストールします。

  • クライアント ライブラリNode.js使用するには、botframework-directlinejsNPM を使用してライブラリをインストールします (またはソースをダウンロードします)。

Web チャット コントロール

Bot Framework は、Direct-Line を利用したボットをクライアント アプリケーションに埋め込むコントロールを提供します。 詳細については、WebChat コントロールのMicrosoft Bot Framework参照してください