다음을 통해 공유


TeamsActivityHandler 클래스

정의

TeamsActivityHandler는 ActivityHandler에서 파생됩니다. Microsoft Teams 특정 이벤트 및 상호 작용에 대한 지원을 추가합니다.

public class TeamsActivityHandler : Microsoft.Bot.Builder.ActivityHandler
type TeamsActivityHandler = class
    inherit ActivityHandler
Public Class TeamsActivityHandler
Inherits ActivityHandler
상속
TeamsActivityHandler

생성자

TeamsActivityHandler()

TeamsActivityHandler는 ActivityHandler에서 파생됩니다. Microsoft Teams 특정 이벤트 및 상호 작용에 대한 지원을 추가합니다.

메서드

OnAdaptiveCardInvokeAsync(ITurnContext<IInvokeActivity>, AdaptiveCardInvokeValue, CancellationToken)

봇이 적응형 카드 동작 실행을 보낼 때 호출됩니다.

(다음에서 상속됨 ActivityHandler)
OnCommandActivityAsync(ITurnContext<ICommandActivity>, CancellationToken)

OnTurnAsync(ITurnContext, CancellationToken) 기본 동작을 사용할 때 명령 작업이 수신될 때 호출됩니다. 명령은 작업을 수행하기 위한 요청이며 수신기는 일반적으로 하나 이상의 commandResult 활동으로 응답합니다. 또한 수신기는 지원되지 않는 명령 작업을 명시적으로 거부해야 합니다.

(다음에서 상속됨 ActivityHandler)
OnCommandResultActivityAsync(ITurnContext<ICommandResultActivity>, CancellationToken)

OnTurnAsync(ITurnContext, CancellationToken) 기본 동작을 사용할 때 CommandResult 작업이 수신될 때 호출됩니다. CommandResult 활동을 사용하여 명령 실행 결과를 전달할 수 있습니다.

(다음에서 상속됨 ActivityHandler)
OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken)

채널에서 대화 업데이트 활동을 수신할 때 호출됩니다. 대화 업데이트 활동은 채널에 추가되거나 채널에서 제거되는 사용자에게 응답할 때 유용합니다. 예를 들어 봇은 사용자에게 인사말을 하여 추가되는 사용자에 응답할 수 있습니다.

OnEndOfConversationActivityAsync(ITurnContext<IEndOfConversationActivity>, CancellationToken)

파생 클래스에서 이를 재정의하여 대화 논리와 같은 EndOfConversation 작업에 특정한 논리를 제공합니다.

(다음에서 상속됨 ActivityHandler)
OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken)

채널에서 이벤트 활동을 수신할 때 호출됩니다. 이벤트 활동은 다양한 것을 전달하는 데 사용할 수 있습니다.

OnEventAsync(ITurnContext<IEventActivity>, CancellationToken)

OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) 기본 동작을 사용할 때 tokens/response 이외의 이벤트가 수신될 때 호출됩니다. 봇이 기타 이벤트를 처리하려는 경우 이 메서드를 선택적으로 재정의할 수 있습니다. 기본적으로 이 메서드는 아무 작업도 수행하지 않습니다.

(다음에서 상속됨 ActivityHandler)
OnInstallationUpdateActivityAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

파생 클래스에서 이를 재정의하여 InstallationUpdate 작업에 특정한 논리를 제공합니다.

(다음에서 상속됨 ActivityHandler)
OnInstallationUpdateAddAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

파생 클래스에서 이를 재정의하여 'action'이 'add'로 설정된 InstallationUpdate 작업에 특정한 논리를 제공합니다.

(다음에서 상속됨 ActivityHandler)
OnInstallationUpdateRemoveAsync(ITurnContext<IInstallationUpdateActivity>, CancellationToken)

파생 클래스에서 이를 재정의하여 'action'이 'remove'로 설정된 InstallationUpdate 작업과 관련된 논리를 제공합니다.

(다음에서 상속됨 ActivityHandler)
OnInvokeActivityAsync(ITurnContext<IInvokeActivity>, CancellationToken)

커넥터에서 호출 작업을 수신할 때 호출됩니다. 호출 활동을 사용하여 다양한 것을 전달할 수 있습니다.

OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)

봇이 아닌 멤버가 대화에 참가하는 경우(예: 봇의 시작 논리)에 대한 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

(다음에서 상속됨 ActivityHandler)
OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken)

봇 이외의 멤버가 대화를 떠날 때(예: 봇의 good-bye 논리) 논리를 제공하기 위해 파생 클래스에서 이를 재정의합니다.

(다음에서 상속됨 ActivityHandler)
OnMessageActivityAsync(ITurnContext<IMessageActivity>, CancellationToken)

파생 클래스에서 이를 재정의하여 대화 논리와 같은 Message 작업에 특정한 논리를 제공합니다.

(다음에서 상속됨 ActivityHandler)
OnMessageDeleteActivityAsync(ITurnContext<IMessageDeleteActivity>, CancellationToken)

메시지 삭제 작업을 수신할 때 호출됩니다. 대화 논리와 같은 활동을 MessageDelete.

OnMessageReactionActivityAsync(ITurnContext<IMessageReactionActivity>, CancellationToken)

OnTurnAsync(ITurnContext, CancellationToken) 기본 동작을 사용할 때 커넥터에서 이벤트 활동을 수신할 때 호출됩니다. 메시지 반응은 이전에 보낸 활동에 'like' 또는 'sad' 등(종종 이모지)을 추가하는 사용자에 해당합니다. 메시지 반응은 일부 채널에서만 지원됩니다. 메시지 반응에 해당하는 활동은 replyToId 속성에 표시됩니다. 이 속성의 값은 보내기 호출의 응답으로 봇에 다시 제공된 이전에 보낸 활동의 활동 ID입니다.

(다음에서 상속됨 ActivityHandler)
OnMessageUpdateActivityAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken)

메시지 업데이트 작업이 수신될 때 호출됩니다. 대화 논리와 같은 활동을 MessageUpdate.

OnReactionsAddedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)

이전 활동에 대한 반응이 대화에 추가되는 경우에 대한 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

(다음에서 상속됨 ActivityHandler)
OnReactionsRemovedAsync(IList<MessageReaction>, ITurnContext<IMessageReactionActivity>, CancellationToken)

이전 활동에 대한 반응이 대화에서 제거되는 경우에 대한 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

(다음에서 상속됨 ActivityHandler)
OnSearchInvokeAsync(ITurnContext<IInvokeActivity>, SearchInvokeValue, CancellationToken)

봇이 'application/search'라는 이름을 가진 'invoke' 활동을 보낼 때 호출됩니다.

(다음에서 상속됨 ActivityHandler)
OnSignInInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)

커넥터에서 signIn 호출 작업을 수신할 때 호출됩니다.

OnTeamsAnonymousAppBasedLinkQueryAsync(ITurnContext<IInvokeActivity>, AppBasedLinkQuery, CancellationToken)

커넥터에서 익명 앱 기반 링크 쿼리 작업을 수신할 때 호출됩니다.

OnTeamsAppBasedLinkQueryAsync(ITurnContext<IInvokeActivity>, AppBasedLinkQuery, CancellationToken)

커넥터에서 앱 기반 링크 쿼리 작업을 수신할 때 호출됩니다.

OnTeamsCardActionInvokeAsync(ITurnContext<IInvokeActivity>, CancellationToken)

커넥터에서 카드 동작 호출 작업을 수신할 때 호출됩니다.

OnTeamsChannelCreatedAsync(ChannelInfo, TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 채널 생성 이벤트 활동을 수신할 때 호출됩니다. 만든 채널은 새 채널을 만드는 사용자에 해당합니다.

OnTeamsChannelDeletedAsync(ChannelInfo, TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 Channel Deleted 이벤트 활동을 수신할 때 호출됩니다. 삭제된 채널은 기존 채널을 삭제하는 사용자에 해당합니다.

OnTeamsChannelRenamedAsync(ChannelInfo, TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 채널 이름 바꾸기 이벤트 작업을 수신할 때 호출됩니다. 이름이 바뀐 채널은 기존 채널의 이름을 바꾸는 사용자에 해당합니다.

OnTeamsChannelRestoredAsync(ChannelInfo, TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 채널 복원 이벤트 활동을 수신할 때 호출됩니다. 복원된 채널은 이전에 삭제된 채널을 복원하는 사용자에 해당합니다.

OnTeamsConfigFetchAsync(ITurnContext<IInvokeActivity>, JObject, CancellationToken)

구성을 가져올 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsConfigSubmitAsync(ITurnContext<IInvokeActivity>, JObject, CancellationToken)

구성이 제출될 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsFileConsentAcceptAsync(ITurnContext<IInvokeActivity>, FileConsentCardResponse, CancellationToken)

사용자가 파일 동의 카드를 수락할 때 호출됩니다.

OnTeamsFileConsentAsync(ITurnContext<IInvokeActivity>, FileConsentCardResponse, CancellationToken)

커넥터에서 파일 동의 카드 작업을 수신할 때 호출됩니다.

OnTeamsFileConsentDeclineAsync(ITurnContext<IInvokeActivity>, FileConsentCardResponse, CancellationToken)

사용자가 파일 동의 카드를 거부할 때 호출됩니다.

OnTeamsMeetingEndAsync(MeetingEndEventDetails, ITurnContext<IEventActivity>, CancellationToken)

커넥터에서 Teams 모임 종료 이벤트 활동을 수신할 때 호출됩니다. 모임이 종료될 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsMeetingParticipantsJoinAsync(MeetingParticipantsEventDetails, ITurnContext<IEventActivity>, CancellationToken)

커넥터에서 Teams 참가자 참가 이벤트 활동을 수신할 때 호출됩니다. 모임 참가자가 추가될 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsMeetingParticipantsLeaveAsync(MeetingParticipantsEventDetails, ITurnContext<IEventActivity>, CancellationToken)

Teams 참가자 휴가 이벤트 활동이 커넥터에서 수신될 때 호출됩니다. 모임 참가자가 제거될 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsMeetingStartAsync(MeetingStartEventDetails, ITurnContext<IEventActivity>, CancellationToken)

커넥터에서 Teams 모임 시작 이벤트 활동을 수신할 때 호출됩니다. 모임이 시작될 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsMembersAddedAsync(IList<TeamsChannelAccount>, TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

봇 이외의 멤버가 채널에 조인하는 경우(예: 봇의 시작 논리)에 대한 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsMembersAddedDispatchAsync(IList<ChannelAccount>, TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

봇 이외의 멤버가 채널에 조인하는 경우(예: 봇의 시작 논리)에 대한 논리를 제공하도록 파생 클래스에서 이를 재정의합니다. UseIt는 제공된 계정과 연결된 멤버를 가져옵니다.

OnTeamsMembersRemovedAsync(IList<TeamsChannelAccount>, TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

봇 이외의 멤버가 봇의 good-bye 논리와 같이 채널을 떠날 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsMembersRemovedDispatchAsync(IList<ChannelAccount>, TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

봇 이외의 멤버가 봇의 good-bye 논리와 같이 채널을 떠날 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다. 제공된 계정과 연결된 멤버를 가져옵니다.

OnTeamsMessageEditAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken)

편집 메시지 이벤트 활동을 수신할 때 호출됩니다.

OnTeamsMessageSoftDeleteAsync(ITurnContext<IMessageDeleteActivity>, CancellationToken)

일시 삭제 메시지 이벤트 활동을 수신할 때 호출됩니다.

OnTeamsMessageUndeleteAsync(ITurnContext<IMessageUpdateActivity>, CancellationToken)

일시 삭제 취소 메시지 이벤트 작업을 수신할 때 호출됩니다.

OnTeamsMessagingExtensionBotMessagePreviewEditAsync(ITurnContext<IInvokeActivity>, MessagingExtensionAction, CancellationToken)

커넥터에서 메시징 확장 봇 메시지 미리 보기 편집 작업을 수신할 때 호출됩니다.

OnTeamsMessagingExtensionBotMessagePreviewSendAsync(ITurnContext<IInvokeActivity>, MessagingExtensionAction, CancellationToken)

커넥터에서 메시징 확장 봇 메시지 미리 보기 보내기 작업을 수신할 때 호출됩니다.

OnTeamsMessagingExtensionCardButtonClickedAsync(ITurnContext<IInvokeActivity>, JObject, CancellationToken)

카드 단추를 메시징 확장 프로그램에서 클릭할 때 논리를 제공하려면 파생 클래스에서 이를 재정의합니다.

OnTeamsMessagingExtensionConfigurationQuerySettingUrlAsync(ITurnContext<IInvokeActivity>, MessagingExtensionQuery, CancellationToken)

커넥터에서 메시징 확장 구성 쿼리 설정 URL 활동을 수신할 때 호출됩니다.

OnTeamsMessagingExtensionConfigurationSettingAsync(ITurnContext<IInvokeActivity>, JObject, CancellationToken)

메시징 확장에 대한 구성이 설정된 경우에 대한 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsMessagingExtensionFetchTaskAsync(ITurnContext<IInvokeActivity>, MessagingExtensionAction, CancellationToken)

커넥터에서 메시징 확장 페치 작업을 수신할 때 호출됩니다.

OnTeamsMessagingExtensionQueryAsync(ITurnContext<IInvokeActivity>, MessagingExtensionQuery, CancellationToken)

커넥터에서 메시징 확장 쿼리 작업을 수신할 때 호출됩니다.

OnTeamsMessagingExtensionSelectItemAsync(ITurnContext<IInvokeActivity>, JObject, CancellationToken)

메시징 확장 선택 항목 작업이 커넥터에서 수신될 때 호출됩니다.

OnTeamsMessagingExtensionSubmitActionAsync(ITurnContext<IInvokeActivity>, MessagingExtensionAction, CancellationToken)

커넥터에서 메시징 확장 제출 작업 작업을 수신할 때 호출됩니다.

OnTeamsMessagingExtensionSubmitActionDispatchAsync(ITurnContext<IInvokeActivity>, MessagingExtensionAction, CancellationToken)

메시징 확장 전송 작업 디스패치 작업이 커넥터에서 수신될 때 호출됩니다.

OnTeamsO365ConnectorCardActionAsync(ITurnContext<IInvokeActivity>, O365ConnectorCardActionQuery, CancellationToken)

커넥터에서 O365 커넥터 카드 작업 작업을 수신할 때 호출됩니다.

OnTeamsReadReceiptAsync(ReadReceiptInfo, ITurnContext<IEventActivity>, CancellationToken)

커넥터에서 이전에 보낸 메시지에 대한 읽기 확인이 수신될 때 호출됩니다. 봇이 읽음 확인 이벤트를 수신할 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsSigninVerifyStateAsync(ITurnContext<IInvokeActivity>, CancellationToken)

signIn 확인 상태 작업이 커넥터에서 수신될 때 호출됩니다.

OnTeamsTabFetchAsync(ITurnContext<IInvokeActivity>, TabRequest, CancellationToken)

탭을 가져올 때 논리를 제공하려면 파생 클래스에서 이를 재정의합니다.

OnTeamsTabSubmitAsync(ITurnContext<IInvokeActivity>, TabSubmit, CancellationToken)

탭이 제출될 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsTaskModuleFetchAsync(ITurnContext<IInvokeActivity>, TaskModuleRequest, CancellationToken)

파생 클래스에서 이를 재정의하여 작업 모듈을 가져올 때 논리를 제공합니다.

OnTeamsTaskModuleSubmitAsync(ITurnContext<IInvokeActivity>, TaskModuleRequest, CancellationToken)

작업 모듈이 제출될 때 논리를 제공하도록 파생 클래스에서 이를 재정의합니다.

OnTeamsTeamArchivedAsync(TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 Team Archived 이벤트 활동을 수신할 때 호출됩니다. 팀 보관은 팀을 보관하는 사용자에 해당합니다.

OnTeamsTeamDeletedAsync(TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 팀 삭제 이벤트 활동을 수신할 때 호출됩니다. 팀 삭제는 팀을 삭제하는 사용자에 해당합니다.

OnTeamsTeamHardDeletedAsync(TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 Team Hard Deleted 이벤트 활동을 수신할 때 호출됩니다. 팀 하드 삭제는 팀을 하드 삭제하는 사용자에 해당합니다.

OnTeamsTeamRenamedAsync(TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 Team Renamed 이벤트 활동을 수신할 때 호출됩니다. 팀 이름 바꾸기는 기존 팀의 이름을 바꾸는 사용자에 해당합니다.

OnTeamsTeamRestoredAsync(TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 팀 복원 이벤트 활동을 수신할 때 호출됩니다. 팀 복원은 팀을 복원하는 사용자에 해당합니다.

OnTeamsTeamUnarchivedAsync(TeamInfo, ITurnContext<IConversationUpdateActivity>, CancellationToken)

커넥터에서 Team Unarchived 이벤트 활동을 수신할 때 호출됩니다. Team Unarchived는 팀을 구성하지 않은 사용자에 해당합니다.

OnTokenResponseEventAsync(ITurnContext<IEventActivity>, CancellationToken)

OnEventActivityAsync(ITurnContext<IEventActivity>, CancellationToken) 기본 동작을 사용할 때 tokens/response 이벤트가 수신될 때 호출됩니다. OAuthPrompt사용하는 경우 이 Activity 현재 대화 상자로 전달하도록 이 메서드를 재정의합니다. 기본적으로 이 메서드는 아무 작업도 수행하지 않습니다.

(다음에서 상속됨 ActivityHandler)
OnTurnAsync(ITurnContext, CancellationToken)

인바운드 Activity처리하기 위해 런타임 시 어댑터(예: BotFrameworkAdapter)에서 호출됩니다.

(다음에서 상속됨 ActivityHandler)
OnTypingActivityAsync(ITurnContext<ITypingActivity>, CancellationToken)

파생 클래스에서 이를 재정의하여 대화 논리와 같은 Typing 작업에 특정한 논리를 제공합니다.

(다음에서 상속됨 ActivityHandler)
OnUnrecognizedActivityTypeAsync(ITurnContext, CancellationToken)

메시지, 대화 업데이트 또는 이벤트 이외의 활동이 OnTurnAsync(ITurnContext, CancellationToken) 기본 동작을 사용할 때 수신될 때 호출됩니다. 재정의되는 경우 ContactRelationUpdate 또는 EndOfConversation같은 다른 활동 유형에 응답할 수 있습니다. 기본적으로 이 메서드는 아무 작업도 수행하지 않습니다.

(다음에서 상속됨 ActivityHandler)

적용 대상