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、次のパッケージNuGet
Microsoft.Bot.Connector.DirectLine
インストールします。クライアント ライブラリNode.js使用するには、
botframework-directlinejs
NPM を使用してライブラリをインストールします (またはソースをダウンロードします)。
Web チャット コントロール
Bot Framework は、Direct-Line を利用したボットをクライアント アプリケーションに埋め込むコントロールを提供します。 詳細については、WebChat コントロールのMicrosoft Bot Framework参照してください。