직접 회선 API 3.0의 주요 개념Key concepts in Direct Line API 3.0

직접 회선 API를 통해 봇과 고유한 클라이언트 애플리케이션 간에 통신을 사용할 수 있습니다.You can enable communication between your bot and your own client application by using the Direct Line API. 이 문서에서는 직접 회선 API 3.0의 주요 개념을 소개하고 관련 개발자 리소스에 대한 정보를 제공합니다.This article introduces key concepts in Direct Line API 3.0 and provides information about relevant developer resources. SDK, REST API 또는 웹 채팅을 사용하여 클라이언트를 빌드할 수 있습니다.You can build a client using the SDK, REST API, or Web Chat.

인증Authentication

Direct Line API 3.0 요청을 인증하려면 Azure Portal의 Direct Line 채널 구성 페이지에서 가져오는 비밀 을 사용하거나 런타임에 가져오는 토큰 을 사용합니다.Direct Line API 3.0 requests can be authenticated either by using a secret that you obtain from the Direct Line channel configuration page in the Azure Portal or by using a token that you obtain at runtime. 자세한 내용은 인증을 참조하세요.For more information, see Authentication.

대화 시작Starting a conversation

직접 회선 대화는 클라이언트에서 명시적으로 열고, 봇과 클라이언트가 참여하고 유효한 자격 증명이 있는 경우에만 실행될 수 있습니다.Direct Line conversations are explicitly opened by clients and may run as long as the bot and client participate and have valid credentials. 자세한 내용은 대화 시작을 참조하세요.For more information, see Start a conversation.

메시지 보내기Sending messages

직접 회선 API 3.0을 사용하면 클라이언트가 HTTP POST 요청을 실행하여 봇에 메시지를 보낼 수 있습니다.Using Direct Line API 3.0, a client can send messages to your bot by issuing HTTP POST requests. 클라이언트는 요청당 하나의 메시지를 보낼 수 있습니다.A client may send a single message per request. 자세한 내용은 봇에 작업 보내기를 참조하세요.For more information, see Send an activity to the bot.

메시지 수신Receiving messages

직접 회선 API 3.0을 사용하면 클라이언트가 WebSocket 스트림을 통하거나 HTTP GET 요청을 발행하여 봇으로부터 메시지를 수신할 수 있습니다.Using Direct Line API 3.0, a client can receive messages from your bot either via WebSocket stream or by issuing HTTP GET requests. 이러한 기술 중 하나를 사용하면 클라이언트는 ActivitySet의 일환으로 봇으로부터 한 번에 여러 메시지를 받을 수 있습니다.Using either of these techniques, a client may receive multiple messages from the bot at a time as part of an ActivitySet. 자세한 내용은 봇에서 작업 수신을 참조하세요.For more information, see Receive activities from the bot.

개발자 리소스Developer resources

클라이언트 라이브러리Client libraries

Bot Framework는 C# 및 Node.js를 통해 직접 회선 API 3.0에 쉽게 액세스할 수 있는 클라이언트 라이브러리를 제공합니다.The Bot Framework provides client libraries that facilitate access to Direct Line API 3.0 via C# and Node.js.

  • Visual Studio 프로젝트 내에서 .NET 클라이언트 라이브러리를 사용하려면 Microsoft.Bot.Connector.DirectLine NuGet 패키지를 설치합니다.To use the .NET client library within a Visual Studio project, install the Microsoft.Bot.Connector.DirectLine NuGet package.

  • Node.js 클라이언트 라이브러리를 사용 하려면 botframework-directlinejs NPM (또는 원본다운로드)를 사용 하 여 라이브러리를 설치 합니다.To use the Node.js client library, install the botframework-directlinejs library using NPM (or download the source).

웹 채팅 컨트롤Web chat control

Bot Framework는 클라이언트 애플리케이션에 직접 회선 기반 봇을 포함할 수 있는 컨트롤을 제공합니다.The Bot Framework provides a control that enables you to embed a Direct-Line-powered bot into your client application. 자세한 내용은 Microsoft Bot Framework 웹 채팅 컨트롤을 참조하세요.For more information, see the Microsoft Bot Framework WebChat control.