채널에 봇 연결Connect a bot to channels

적용 대상: SDK v4APPLIES TO: SDK v4

채널은 통신 응용 프로그램과 봇 간의 연결입니다.A channel is a connection between communication applications and a bot. Azure에 등록 된 봇은 채널을 사용 하 여 사용자와의 통신을 용이 하 게 합니다.A bot, registered with Azure, uses channels to facilitate the communication with users.

Alexa, Facebook Messenger, 여유 시간 등의 표준 채널에 연결 하도록 봇을 구성할 수 있습니다.You can configure a bot to connect to any of the standard channels such as Alexa, Facebook Messenger, and Slack. 자세한 내용은 Azure 봇 등록을 참조 하세요.For more information, see Azure Bot registration.

제공 된 채널 외에도 채널을 직접 회선 을 사용 하 여 통신 응용 프로그램에 봇을 연결할 수 있습니다.In addition to the provided channels, you can also connect a bot to your communication application using Direct Line as the channel. 자세한 내용은 Direct Line에 봇 연결을 참조 하세요.For more information, see Connect a bot to Direct Line.

Bot 프레임 워크를 사용 하면 봇이 채널에 보내는 메시지를 표준화 하 여 채널을 구분 하지 않는 방식으로 봇을 개발할 수 있습니다.The Bot Framework allows you to develop a bot in a channel-agnostic way by normalizing messages that the bot sends to a channel. 이것은 다음을 의미합니다.This implies the following:

  • Bot Framework 스키마에서 채널의 스키마로 메시지를 변환 합니다.Convert the messages from the Bot Framework schema into the channel's schema.
  • 채널이 Bot Framework 스키마의 모든 측면을 지원 하지 않는 경우 Bot Connector 서비스는 메시지를 채널이 지 원하는 형식으로 변환 하려고 합니다.If the channel does not support all aspects of the Bot Framework schema, the Bot Connector service tries to convert the message to a format that the channel does support. 예를 들어, 봇이 작업 단추가 있는 카드가 포함된 메시지를 이메일 채널에 보내면 커넥터는 카드를 이미지로 전송하고 메시지의 텍스트에 링크로 작업을 포함시킬 수 있습니다.For example, if the bot sends a message that contains a card with action buttons to the email channel, the connector may send the card as an image and include the actions as links in the message's text.
  • 대부분의 채널의 경우 채널에서 봇을 실행 하려면 채널 구성 정보를 제공 해야 합니다.For most channels, you must provide channel configuration information to run a bot on the channel. 대부분의 채널은 봇에 채널의 계정이 있어야 합니다.Most channels require that a bot have an account on the channel. Facebook Messenger와 같이 다른 사용자에 게는 채널에 등록 된 응용 프로그램을 포함 해야 합니다.Others, like Facebook Messenger, require a bot to have an application registered with the channel also.

채널에 연결 하도록 bot을 구성 하려면 다음 단계를 완료 합니다.To configure a bot to connect to a channel, complete the following steps:

  1. Azure Portal에 로그인합니다.Sign in to the Azure Portal.

  2. 구성하려는 봇을 선택합니다.Select the bot that you want to configure.

  3. 왼쪽 창의 봇 관리 아래에서 채널 을 선택 합니다.In the left pane, select Channels under Bot Management.

  4. 오른쪽 창에서 봇에 추가 하려는 채널의 아이콘을 선택 합니다.In the right pane, select the icon of the channel you want to add to your bot.

    채널에 연결

채널을 구성한 후 해당 채널에서 사용자는 봇을 사용하여 시작할 수 있습니다.After you've configured the channel, users on that channel can start using your bot.

채널에 봇 연결Connect a bot to a channel

연결 단계는 채널 마다 다릅니다.The connection steps are different for each channel. 자세한 내용은 아래 표의 관련 문서를 참조 하세요.See the related article in the table below more information.

채널Channel 설명Description
AlexaAlexa 사용자 지정 기술을 지 원하는 Alexa 장치를 통해 사용자와 통신 합니다.Communicate with users through Alexa devices that support Custom Skills.
Direct LineDirect Line 봇을 모바일 앱, 웹 페이지 또는 기타 애플리케이션에 통합합니다.Integrate a bot into a mobile app, web page, or other applications.
Office 365 전자 메일Office 365 email 봇이 Office 365 이메일을 통해 사용자와 통신할 수 있도록 합니다.Enable a bot to communicate with users via Office 365 email.
FacebookFacebook 두 플랫폼에서 사용자와 통신할 수 있도록 Facebook Messenger 및 Facebook Workplace 모두에 봇을 연결합니다.Connect a bot to both Facebook Messenger and Facebook Workplace, so that it can communicate with users on both platforms.
KikKik Kik 메시징 앱을 통해 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users through the Kik messaging app.
LINELINE LINE 앱을 통해 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users through the LINE app.
Microsoft 팀Microsoft Teams Microsoft Teams를 통해 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users through Microsoft Teams.
SkypeSkype Skype를 통해 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users through Skype.
비즈니스용 SkypeSkype for Business Busine용 Skype를 통해 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users through Skype for Busines.
SlackSlack Slack을 통해 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users through Slack.
TelegramTelegram Telegram을 통해 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users through Telegram.
TelephonyTelephony Bot Framework 전화 통신 채널을 통해 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users through the Bot Framework Telephony channel.
TwilioTwilio Twilio 클라우드 통신 플랫폼을 통해 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users through the Twilio cloud communication platform.
WeChatWeChat WeChat 플랫폼을 사용하여 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users using the WeChat platform.
웹 채팅Web Chat Bot Framework Service 사용하여 봇을 만들 때 자동으로 구성됩니다.Automatically configured for you when you create a bot with the Bot Framework Service.
WebexWebex Webex를 사용하여 사용자와 통신하도록 봇을 구성합니다.Configure a bot to communicate with users using the Webex.
추가 채널Additional channels Botkit 및 커뮤니티 리포지토리를통해 제공된 플랫폼을 통해 어댑터로 사용할 수 있는 추가 채널입니다.Additional channels available as an adapter through provided platforms via Botkit and community repositories.

봇 스키마 변환 버전Bot schema transformation version

위에서 설명한 대로 채널은 들어오는 메시지를 다른 서비스에서 Bot Framework 프로토콜 스키마로 변환합니다.As described above, a channel converts incoming messages from other services to the Bot Framework protocol schema. 마찬가지로 봇에서 다른 서비스로 보낸 메시지는 Bot Framework 네이티브 스키마에서 이러한 서비스의 형식으로 변환됩니다.Likewise, messages sent by the bot to other services are transformed from the Bot Framework native schema to the format of these services. 이 프로세스를 스키마 변환이라고 합니다.This process is called schema transformation. Bot Framework 서비스는 기존 봇의 동작이 변경 되지 않도록 하기 위해 프로토콜의 이전 버전과의 호환성을 유지 합니다.The Bot Framework Service maintains backward compatibility of the protocol in order to avoid changing behavior of the existing bots.

경우에 따라 기존 봇의 동작을 변경할 수 있는 스키마 변환 프로세스를 변경 해야 할 수 있습니다.Occasionally, a change in the schema transformation process needs to take place that can, potentially, change the behavior of the existing bots. 이러한 변경의 예는 사용자의 하위 집합이 기존 (그러나 잘못 된) 동작에 대 한 종속성을 수행한 경우의 버그 수정이 될 수 있습니다.An example of such a change could be any bug fix if a subset of the users have taken a dependency on the existing (however erroneous) behavior. 이러한 변경의 또 다른 예는 bot을 활용 하는 다른 서비스의 업데이트나 향상 된 기능입니다. 그러나 이러한 업데이트를 채택 하면 기존 동작이 변경 될 수 있습니다.Another example of such a change would be updates or improvements in other services that would benefit bots; however adopting these updates can, potentially, change the existing behavior.

Bot 개발자는 bot의 스키마 변환 버전 을 제어 하 여 새 동작을 사용 하도록 설정 하는 시기를 제어할 수 있습니다.By controlling the schema transformation version of their bots, bot developers can control when (if ever) to enable new behavior. 기본적으로 새로 만든 bot은 최신 스키마 변환 버전을 가져옵니다.By default, newly created bots get the most recent schema transformation version. 기존 봇은이 버전에 도입 된 향상 된 기능을 활용할 준비가 되 면 최신 버전으로 업그레이드할 수 있습니다.Existing bots can be upgraded to the newest version when they are ready to take advantage of the improvements introduced in this version. 모든 봇은 언제 든 지 업그레이드 하거나 다운 그레이드할 수 있습니다.Any bot can be upgraded or downgraded at any time.

구성 창에서 봇의 스키마 변환 버전을 변경할 수 있습니다.You can change your bot's schema transformation version in the Configuration pane:

구성 창의 스키마 변환 버전 필드

지원 되는 스키마 변환 버전Supported schema transformation versions

  • 버전 1.3Version 1.3

    • 소개 된 날짜: 2021 년 5 월Date introduced: May 2021
    • 변경 내용:Changes:
      • 직접 줄: 적응 카드의 Deserialize/Reserialize을 제거 합니다.Direct Line: Remove Deserialize/Reserialize of Adaptive Cards. 적응 카드의 콘텐츠는 그대로 클라이언트에 전달 됩니다.The content of Adaptive Cards will be passed to the client as is.
  • 버전 1.2Version 1.2

    • 소개 날짜: 4 월 2021Date introduced: April 2021
    • 변경 내용:Changes:
      • 여유 시간 채널: 첨부 파일 이름은 메시지 텍스트 값에 사용 됩니다.Slack channel: Attachment name is used for Message Text value.
      • Facebook 채널: facebook Graph API v 9.0으로 업그레이드 합니다.Facebook channel: Upgrade to Facebook Graph API v9.0.
  • 버전 1.1Version 1.1

  • 버전 1.0Version 1.0

    • 원래 버전Original version

봇 게시Publish a bot

게시 프로세스는 각 채널마다 다릅니다.The publishing process is different for each channel.

SkypeSkype

참고

2019년 10월 31일부터 Skype 채널은 더 이상 새 봇 게시 요청을 수락하지 않습니다.As of October 31, 2019 the Skype channel no longer accepts new Bot publishing requests. 즉, Skype 채널을 사용하여 봇 개발을 계속할 수 있지만 봇은 100명의 사용자로 제한되며,This means that you can continue to develop bots using the Skype channel, but your bot will be limited to 100 users. 더 많은 대상에게 봇을 게시할 수 없습니다.You will not be able to publish your bot to a larger audience. 현재 Skype 봇은 중단 없이 계속 실행됩니다.Current Skype bots will continue to run uninterrupted. 자세한 내용은 Skype에서 일부 기능을 더 이상 사용할 수 없는 이유를 참조하세요.Read more about why some features are not available in Skype anymore.

봇은 구성 페이지의 Skype에 게시됩니다.Bots are published to Skype from the configuration page. 봇을 게시하면 봇이 검토를 위해 제출됩니다.Publishing a bot submits it for review. 검토 전에는 봇이 연락처 100개로 제한됩니다.Before review, the bot is limited to 100 contacts. 승인된 봇은 연락처 제한이 없으며 Skype 봇 디렉터리에 봇을 포함하도록 선택할 수 있습니다.Approved bots do not have limited contacts and you may opt to have the bot included in the Skype bot directory.

비즈니스용 SkypeSkype for Business

중요

비즈니스용 Skype Online이 2021년 7월 31일에 사용 중지됩니다.Skype for Business Online will retire on July 31, 2021. 비즈니스용 Skype Online 고객은 사용 중지 날짜 이전에 서비스 변화를 체감할 수 없을 것입니다.Skype for Business Online customers should see no change to the service before the retirement date. 자세한 내용은 비즈니스용 Skype Online 사용 중지 예정을 읽어 보세요.Read Skype for Business Online to Be Retired for more details.

비즈니스용 Skype 봇은 테넌트 관리자를 통해 비즈니스 온라인용 Skype 테넌트에 등록됩니다.Skype for Business bots are registered with a Skype for Business Online tenant by a Tenant Administrator.

검토 상태를 보려면 Bot Framework 포털에서 봇을 열고 채널 을 클릭합니다.To view the status of a review, open the bot in the Bot Framework Portal and click Channels. 봇이 승인되지 않으면 그 결과가 이유에 연결됩니다.If the bot is not approved, the result will link to the reason why. 필요한 변경을 마친 후 봇을 다시 제출하여 검토를 받습니다.After making the required changes, resubmit the bot for review.

추가 리소스Additional resources

SDK에는 봇을 빌드하는 데 사용할 수 있는 샘플이 포함되어 있습니다.The SDK includes samples that you can use to build bots. 샘플 목록을 보려면 GitHub의 샘플 리포지토리를 방문하세요.Visit the Samples repo on GitHub to see a list of samples.