채널 참조Channels reference

분류된 채널별 활동Categorized activities by channel

적용 대상: SDK v4APPLIES TO: SDK v4

다음 표에서는 어떤 채널에서 어떤 이벤트가 발생할 수 있는지를 보여 줍니다.The following tables show what events (activities on the wire) can come from which channels.

이러한 기호는 테이블에 사용 됩니다.These symbols are used in the tables:

기호Symbol 의미Meaning
Bot이이 활동을 받게 됩니다.The bot should expect to receive this activity.
Bot이 활동을 받을 수 없습니다 .The bot should never expect to receive this activity.
현재 봇에서이를 수신할 수 있는지 여부가 결정 됩니다.Currently undetermined whether the bot can receive this.

활동은 의미에 따라 별도의 범주로 분류할 수 있습니다.Activities can meaningfully be split into separate categories. 각 범주에 대해 가능한 작업 테이블이 있습니다.For each category, we have a table of possible activities. 각 작업 형식에 대 한 자세한 설명과 각 작업 유형에 포함 된 정보는 Bot Framework 활동 스키마 를 참조 하세요.See the Bot Framework activity schema for a detailed description of each type of activity, and the information that each type of activity contains.

대화형Conversational

\ 직접 회선Direct Line Direct Line(웹 채팅)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype(비즈니스용)Skype Business TelegramTelegram TwilioTwilio
message
messageReaction
  • 모든 채널이 메시지 작업을 보냅니다.All channels send message activities.
  • 봇에서 대화를 사용 하는 경우 대화에 메시지 활동을 전달 합니다.If your bot uses a dialog, forward message activities to the dialog.
  • 메시지 반응 대화에 매우 많은 부분이 아니더라도 대화에 전달할 필요가 없습니다.Message reactions don't need to be forwarded to the dialog, even though they're very much part of the conversation.
  • 메시지 반응에는 논리적으로 두 가지 유형이 추가 및 제거 됩니다.There are logically two types of message reactions: added and removed.

메시지 반응 이전 주석에서 엄지 손가락 위에 있는 것입니다.Message reactions are things like a thumbs up on a previous comment. 이러한 사용자는 순서가 잘못 될 수 있으며 단추와 유사한 것으로 간주할 수 있습니다.They can happen out of order, and can be thought of as similar to buttons.

시작Welcome

\ 직접 회선Direct Line Direct Line(웹 채팅)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype(비즈니스용)Skype Business TelegramTelegram TwilioTwilio
conversationUpdate
contactRelationUpdate
  • 채널에서 대화 업데이트 활동을 보내는 것이 일반적입니다.It is common for channels to send conversation update activities.
  • 대화 업데이트의 주요 유형은 추가된 대화 멤버 및 제거된 멤버입니다.The main types of conversation updates are conversation members added and members removed.
  • 일부 채널은 봇이 대화에 추가되면 대화 업데이트를 보내고, 일부는 첫 번째 메시지가 봇에 전송된 후 전송합니다.Some channels send the conversation update when the bot is added to a conversation, and some send it after the first message sent to the bot.
  • 신뢰할 수 있는 시작 동작을 생성하려면 봇 시작 논리에 사용자 상태를 포함합니다.To produce a reliable Welcome behavior, include user state in your bots welcome logic.

애플리케이션 확장성Application extensibility

\ 직접 회선Direct Line Direct Line(웹 채팅)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype(비즈니스용)Skype Business TelegramTelegram TwilioTwilio
event
name = CreateConversationname = CreateConversation
name = ContinueConversationname = ContinueConversation
  • 이벤트 활동은 클라이언트 또는 채널에서 봇으로 프로그래밍 방식의 정보를 전달합니다.Event activities communicate programmatic information from a client or channel to a bot. 이벤트 활동의 의미는 name 필드에서 정의되며, 채널 범위 내에서 유효합니다.The meaning of an event activity is defined by the name field, which is meaningful within the scope of a channel.
  • 클라이언트와 서버를 모두 소유하는 애플리케이션은 이벤트 활동을 사용하여 서비스를 통해 자체 이벤트를 터널하도록 선택할 수 있습니다.An application that owns both the client and server can chose to tunnel their own events through the service using event activities.

Microsoft TeamsMicrosoft Teams

  • Microsoft Teams 다른 작업 유형과 함께 몇 가지 Teams 특정 활동을 invoke 정의합니다.Along with other activity types, Microsoft Teams defines a few Teams-specific invoke activities. 자세한 내용은 Microsoft Teams 봇 작동 방식을 참조하세요.See How Microsoft Teams bots work for more information.
  • 호출 활동은 클라이언트 또는 채널에서 봇으로 프로그래밍 방식의 정보를 전달하며, 채널에서 사용할 해당 반환 페이로드가 있습니다.Invoke activities communicate programmatic information from a client or channel to a bot, and have a corresponding return payload for use within the channel. 호출 활동의 의미는 name 필드에서 정의되며, 채널 범위 내에서 유효합니다.The meaning of an invoke activity is defined by the name field, which is meaningful within the scope of a channel.

메시지 업데이트Message update

\ 직접 회선Direct Line Direct Line(웹 채팅)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype(비즈니스용)Skype Business TelegramTelegram TwilioTwilio
messageUpdate
messageDelete
  • 메시지 업데이트는 현재 Teams에서 지원 됩니다.Message update is currently supported by Teams.

OAuthOAuth

\ 직접 회선Direct Line Direct Line(웹 채팅)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype(비즈니스용)Skype Business TelegramTelegram TwilioTwilio
invoke

중요

대화 상자와 OAuth 프롬프트가 작동 하려면 대화 상자에 다음과 같은 호출 작업을 전달 해야 합니다.For dialogs and OAuth prompts to work, you must forward the following invoke activities to the dialog:

  • signin/verifyState
  • signin/tokenExchange
  • tokens/response

범주화되지 않음Uncategorized

\ 직접 회선Direct Line Direct Line(웹 채팅)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype(비즈니스용)Skype Business TelegramTelegram TwilioTwilio
endOfConversation
installationUpdate
typing

사용 하지 않음Out of use

  • deleteUserData
  • handoff
  • invoke: 지불 요청invoke: payment request
  • invoke: 주소invoke: address
  • ping

참고

핸드 오프 활동은 사용자 간 시나리오와 다릅니다.The handoff activity is different from the handoff-to-human scenario. 자세한 내용은 봇에서 인간으로 대화 전환을 참조 하세요.See Transition conversations from bot to human for more information.

채널 당 지원 되는 작업 요약Summary of activities supported per channel

직접 회선Direct Line

  • conversationUpdate
  • event
    • CreateConversation
    • ContinueConversation
  • invoke
    • signin/tokenExchange
    • signin/verifyState
    • tokens/response
  • message

EmailEmail

  • message

FacebookFacebook

  • invoke
    • tokens/response
  • message

GroupMeGroupMe

  • conversationUpdate
  • invoke
    • tokens/response
  • message

KikKik

  • conversationUpdate
  • invoke
    • tokens/response
  • message

TeamsTeams

  • conversationUpdate
  • invoke
  • message
  • messageDelete
  • messageReaction
  • messageUpdate

SlackSlack

  • conversationUpdate
  • invoke
    • tokens/response
  • message

SkypeSkype

  • contactRelationUpdate
  • invoke
    • tokens/response
  • message

Skype(비즈니스용)Skype Business

  • contactRelationUpdate
  • invoke
    • tokens/response
  • message

TelegramTelegram

  • conversationUpdate
  • invoke
    • tokens/response
  • message

TwilioTwilio

  • message

요약 테이블 모든 채널에 대 한 모든 작업Summary table all activities to all channels

\ 직접 회선Direct Line Direct Line(웹 채팅)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik TeamsTeams SlackSlack SkypeSkype Skype(비즈니스용)Skype Business TelegramTelegram TwilioTwilio
contactRelationUpdate
conversationUpdate
endOfConversation
event
- CreateConversation
- ContinueConversation
installationUpdate
message
messageDelete
messageReaction
messageUpdate
typing

및 활동에 대 한 지원은 event invoke 활동의 이름에 따라 다르며 채널에 따라 다릅니다.Support for event and invoke activities varies by the activity's name and varies by channel.

채널별 작업 지원Action support by channel

다음 표에서는 각 채널에서 지원 되는 최대 제안 작업 및 카드 작업 수를 보여 줍니다.The following table shows the maximum number of suggested actions and card actions that are supported in each channel. ❌는 지정 된 채널에서 작업이 지원 되지 않음을 나타냅니다.The ❌ indicates that the action is not supported at all in the specified channel.

\ 직접 회선Direct Line Direct Line(웹 채팅)Direct Line (Web Chat) EmailEmail FacebookFacebook GroupMeGroupMe KikKik 꺾은선형Line TeamsTeams SlackSlack SkypeSkype Skype(비즈니스용)Skype Business TelegramTelegram TwilioTwilio
제안된 작업Suggested actions 100100 100100 1010 2020 1313 1010 100100
카드 작업Card actions 100100 100100 33 2020 9999 33 100100 33

위의 표에 표시된 숫자에 대한 자세한 내용은 여기에 나열된 채널 지원 코드를 참조하세요.For more information about the numbers shown in the above table, refer to channel support code listed here.

권장 동작 에 대 한 자세한 내용은 입력 문서에 대 한 사용 방법 단추 를 참조 하세요.For more information on suggested actions, see how to Use button for input article.

카드 동작 에 대 한 자세한 내용은 메시지에 미디어 추가 문서의 영웅 카드 보내기 섹션을 참조 하세요.For more information on card actions, see the Send a hero card section of the Add media to messages article.

채널당 카드 지원Card support by channel

채널Channel 적응형 카드Adaptive Card 애니메이션 카드Animation card 오디오 카드Audio card 영웅 카드Hero card 수신 카드Receipt card 로그인 카드Sign-in card 미리 보기 카드Thumbnail card 비디오 카드Video card
EmailEmail 🖼🖼 📄📄 📄📄 📄📄
FacebookFacebook ⚠🖼⚠🖼
GroupMeGroupMe 🖼🖼 📄📄 📄📄 📄📄 📄📄 📄📄 📄📄 📄📄
KikKik 🖼🖼 📄📄 📄📄
꺾은선형Line ⚠🖼⚠🖼 📄📄 📄📄
Microsoft TeamsMicrosoft Teams
SkypeSkype
SlackSlack 🖼🖼 📄📄 📄📄 📄📄 📄📄
TelegramTelegram ⚠🖼⚠🖼 📄📄
TwilioTwilio 🖼🖼 📄📄 📄📄 📄📄 📄📄 📄📄
웹 채팅Web Chat

참고

Direct Line 채널은 기술적으로 모든 카드를 지원하지만 이를 구현하는 것은 클라이언트의 입니다.The Direct Line channel technically supports all cards, but it's up to the client to implement them.

  • ✔: 지원됨 - 카드는 일부 채널이 카드 작업의 하위 집합만 지원하거나 각 카드에서 허용되는 작업 수를 제한할 수 있다는 점을 제외하고 완전히 지원됩니다.✔: Supported - card is supported fully with the exception that some channels only support a subset of card actions or may limit the number of actions allowed on each card. 채널에 따라 다릅니다.Varies by channel.
  • ⚠: 부분 지원 - 입력 또는 단추가 포함된 카드는 전혀 표시되지 않을 수 있습니다.⚠: Partial support - card may not be displayed at all if it contains inputs or buttons. 채널에 따라 다릅니다.Varies by channel.
  • ❌: 지원되지 않습니다.❌: No support
  • 🖼: 카드가 이미지로 변환됩니다.🖼: Card is converted to an image
  • 📄: 카드가 서식 없는 텍스트로 변환됩니다. 링크를 클릭할 수 없고, 이미지가 표시되지 않을 수 있으며, 미디어를 재생할 수 없습니다.📄: Card is converted to unformatted text - links may not be clickable, images may not display, and media may not be playable. 채널에 따라 다릅니다.Varies by channel.

이러한 범주는 의도적으로 광범위하며, 카드, 기능 및 채널의 가능한 많은 조합으로 인해 각 채널에서 모든 카드 기능을 지원하는 방법을 완전히 설명하지는 않습니다.These categories are intentionally broad and don't fully explain how every card feature is supported in each channel due to the many possible combinations of cards, features, and channels. 이 테이블을 기본 참조로 사용하지만 원하는 채널에서 각 카드를 테스트합니다.Use this table as a base reference, but test each of your cards in the desired channel.