ボットのアクティビティ ハンドラー

このドキュメントは、主要な Bot Framework のドキュメントの「ボットのしくみ」に基づいています。 Microsoft Teams 用に開発されたボットと主要な Bot Framework の主な違いは、Teams で提供される機能にあります。

アクティビティ ハンドラーは、ボットの会話ロジックを整理するために使用されます。 アクティビティは、Teams アクティビティ ハンドラーとボット ロジックを使用して 2 つの方法で処理されます。 Teams アクティビティ ハンドラーは、Teams 固有のイベントと相互作用のサポートを追加します。 ボット オブジェクトには、会話の推論またはターンのロジックが含まれ、ターン ハンドラーを公開します。これは、ボット アダプターからの受信アクティビティを承諾できるメソッドです。

Teams のアクティビティ ハンドラー

Teams のアクティビティ ハンドラーは、Microsoft Bot Framework のアクティビティ ハンドラーから派生したものです。 すべての Teams アクティビティをルーティングしてから、Teams 以外の特定のアクティビティを処理できるようにします。

Teams 用のボットがアクティビティを受け取ると、アクティビティ ハンドラーにルーティングされます。 すべてのアクティビティは、ターン ハンドラーと呼ばれる 1 つのベース ハンドラーを経由してルーティングされます。 ターン ハンドラーは、受信したアクティビティを管理するために必要なアクティビティ ハンドラーを呼び出します。 Teams ボットは、Bot Framework の ActivityHandler クラスから派生した TeamsActivityHandler クラスから派生したものです。

注:

ボット アクティビティの処理に 15 秒以上かかる場合、Teams はボット エンドポイントに再試行要求を送信します。 そのため、ボットに重複する要求が表示されます。

C#

ボットは Bot Framework を使用して作成されます。 ボットがメッセージ アクティビティを受信した場合、ターン ハンドラーは受信したアクティビティの通知を受け取ります。 その後、ターン ハンドラーは受信したアクティビティを OnMessageActivityAsync アクティビティ ハンドラーに送信します。 Teams では、この機能は変わりません。 ボットが会話更新アクティビティを受信した場合、ターン ハンドラーは受信したアクティビティの通知を受け取り、受信したアクティビティを OnConversationUpdateActivityAsync に送信します。 Teams アクティビティ ハンドラーは、最初に特定の Teams イベントがないかチェックします。 イベントが見つからなかった場合、それらを Bot Framework のアクティビティ ハンドラーに渡します。

Teams アクティビティ ハンドラー クラスには、主に OnConversationUpdateActivityAsync と OnInvokeActivityAsync の 2 つの Teams アクティビティ ハンドラーがあります。 OnConversationUpdateActivityAsync はすべての会話更新アクティビティをルーティングし、OnInvokeActivityAsync は Teams によって呼び出されたすべてのアクティビティをルーティングします。

特定の Teams のアクティビティ ハンドラーのロジックを実装するには、「ボット ロジック」セクションに示すように、ボット内のメソッドをオーバーライドする必要があります。 これらのハンドラーの基本実装はありません。 したがって、オーバーライドに必要なロジックを追加します。

Teams のアクティビティ ハンドラーのコード スニペット:

OnTeamsChannelCreatedAsync

protected override Task OnTeamsChannelCreatedAsync(ChannelInfo channelInfo, TeamInfo teamInfo, ITurnContext<IConversationUpdateActivity> turnContext, CancellationToken cancellationToken)
        {
            // Code logic here
        }

OnTeamsChannelDeletedAsync

protected override Task OnTeamsChannelDeletedAsync(ChannelInfo channelInfo, TeamInfo teamInfo, ITurnContext<IConversationUpdateActivity> turnContext, CancellationToken cancellationToken)
        {
            // Code logic here
        }

OnTeamsChannelRenamedAsync

protected override Task OnTeamsChannelRenamedAsync(ChannelInfo channelInfo, TeamInfo teamInfo, ITurnContext<IConversationUpdateActivity> turnContext, CancellationToken cancellationToken)
  {
   // Code logic here
  }

OnTeamsTeamRenamedAsync

protected override Task OnTeamsTeamRenamedAsync(TeamInfo teamInfo, ITurnContext<IConversationUpdateActivity> turnContext, CancellationToken cancellationToken)
  {
   // Code logic here
  }

OnTeamsMembersAddedAsync

protected override Task OnTeamsMembersAddedAsync(IList<TeamsChannelAccount> teamsMembersAdded, TeamInfo teamInfo, ITurnContext<IConversationUpdateActivity> turnContext, CancellationToken cancellationToken)
  {
   // Code logic here
  }

OnTeamsMembersRemovedAsync

protected override Task OnTeamsMembersRemovedAsync(IList<TeamsChannelAccount> teamsMembersRemoved, TeamInfo teamInfo, ITurnContext<IConversationUpdateActivity> turnContext, CancellationToken cancellationToken);
  {
   // Code logic here
  }

OnTeamsMessageEditAsync

protected override async Task OnTeamsMessageEditAsync(ITurnContext<IMessageUpdateActivity> turnContext, CancellationToken cancellationToken)
  { 
   // Code logic here 
  } 

OnTeamsMessageUndeleteAsync

protected override async Task OnTeamsMessageUndeleteAsync(ITurnContext<IMessageUpdateActivity> turnContext, CancellationToken cancellationToken)
  { 
   // Code logic here 
  } 

OnTeamsMessageSoftDeleteAsync

 protected override async Task OnTeamsMessageSoftDeleteAsync(ITurnContext<IMessageDeleteActivity> turnContext, CancellationToken cancellationToken)
  { 
   // Code logic here 
  } 

JavaScript

ボットは Bot Framework を使用して作成されます。 ボットがメッセージ アクティビティを受信した場合、ターン ハンドラーは受信したアクティビティの通知を受け取ります。 その後、ターン ハンドラーは受信したアクティビティを onMessage アクティビティ ハンドラーに送信します。 Teams では、この機能は変わりません。 ボットが会話更新アクティビティを受信した場合、ターン ハンドラーは受信したアクティビティの通知を受け取り、受信したアクティビティを dispatchConversationUpdateActivity に送信します。 Teams アクティビティ ハンドラーは、最初に特定の Teams イベントがないかチェックします。 イベントが見つからなかった場合、それらを Bot Framework のアクティビティ ハンドラーに渡します。

Teams アクティビティ ハンドラー クラスには、主に dispatchConversationUpdateActivity と onInvokeActivity の 2 つの Teams アクティビティ ハンドラーがあります。 dispatchConversationUpdateActivity はすべての会話更新アクティビティをルーティングし、onInvokeActivity は Teams によって呼び出されたすべてのアクティビティをルーティングします。

特定の Teams のアクティビティ ハンドラーのロジックを実装するには、「ボット ロジック」セクションに示すように、ボット内のメソッドをオーバーライドする必要があります。 これらのハンドラーのボット ロジックを定義し、最後に必ず next() を呼び出してください。 next()を呼び出すことで、次のハンドラーが確実に実行されます。

Teams のアクティビティ ハンドラーのコード スニペット:

onTeamsChannelCreated

onTeamsChannelCreated(async (channelInfo, teamInfo, context, next) => {
       // code for handling
        await next()
    });

onTeamsChannelDeleted

onTeamsChannelDeleted(async (channelInfo, teamInfo, context, next) => {
       // code for handling
       await next()
    });

onTeamsChannelRenamed

onTeamsChannelRenamed(async (channelInfo, teamInfo, context, next) => {
       // code for handling
       await next()
    });

onTeamsTeamRenamed

onTeamsTeamRenamedAsync(async (teamInfo, context, next) => {
       // code for handling
       await next()
    });

onTeamsMembersAdded

onTeamsMembersAdded(async (membersAdded, teamInfo, context, next) => {
       // code for handling
    await next();
    });

onTeamsMembersRemoved

onTeamsMembersRemoved(async (membersRemoved, teamInfo, context, next) => {
       // code for handling
    await next();
    });

Python

ボットは Bot Framework を使用して作成されます。 ボットがメッセージ アクティビティを受信した場合、ターン ハンドラーは受信したアクティビティの通知を受け取ります。 その後、ターン ハンドラーは受信したアクティビティを on_message_activity アクティビティ ハンドラーに送信します。 Teams では、この機能は変わりません。 ボットが会話更新アクティビティを受信した場合、ターン ハンドラーは受信したアクティビティの通知を受け取り、受信したアクティビティを on_conversation_update_activity に送信します。 Teams アクティビティ ハンドラーは、最初に特定の Teams イベントがないかチェックします。 イベントが見つからなかった場合、それらを Bot Framework のアクティビティ ハンドラーに渡します。

Teams アクティビティ ハンドラー クラスには、主に on_conversation_update_activity と on_invoke_activity の 2 つの Teams アクティビティ ハンドラーがあります。 on_conversation_update_activity はすべての会話更新アクティビティをルーティングし、on_invoke_activity は Teams によって呼び出されたすべてのアクティビティをルーティングします。

特定の Teams のアクティビティ ハンドラーのロジックを実装するには、「ボット ロジック」セクションに示すように、ボット内のメソッドをオーバーライドする必要があります。 これらのハンドラーの基本実装はありません。 したがって、オーバーライドに必要なロジックを追加します。

ボット ロジック

ボット ロジックは、1 つ以上のボット チャネルから受信したアクティビティを処理し、それに応じて送信アクティビティを生成します。 これは、Teams アクティビティ ハンドラー クラスから派生したボットに当てはまります。これは、最初に Teams アクティビティをチェックします。 Teams アクティビティがないか確認したら、他のすべてのアクティビティが Bot Framework のアクティビティ ハンドラーに渡されます。

C#

主要な Bot Framework ハンドラー

注:

• 追加および削除されたメンバーのアクティビティを除き、このセクションで説明するすべてのアクティビティ ハンドラーは Teams 以外のボットと同様に動作し続けます。
• onInstallationUpdateActivityAsync() メソッドは、ボットを Teams に追加するときに Teams ロケールを取得するために使用されます。

アクティビティ ハンドラーは、メッセージ スレッドの代わりに新しいメンバーがチームに追加されるチームのコンテキストで異なります。

ActivityHandlerで定義されているハンドラーの一覧には、次のイベントが含まれます。

イベント	ハンドラー	説明
任意のアクティビティの種類を受信しました	OnTurnAsync	このメソッドは、受信したアクティビティの種類に基づいて、他のハンドラーのいずれかを呼び出します。
メッセージ アクティビティを受信しました	OnMessageActivityAsync	このメソッドをオーバーライドして、 Message アクティビティを処理できます。
受信したメッセージ更新アクティビティ	OnMessageUpdateActivityAsync	このメソッドをオーバーライドして、メッセージ更新アクティビティを処理できます。
受信したメッセージ削除アクティビティ	OnMessageDeleteActivityAsync	このメソッドをオーバーライドして、メッセージ削除アクティビティを処理できます。
会話更新アクティビティを受信しました	OnConversationUpdateActivityAsync	このメソッドは、ConversationUpdate アクティビティで、ボット以外のメンバーが会話に参加または退出した場合にハンドラーを呼び出します。
ボット以外のメンバーが会話に参加しました	OnMembersAddedAsync	このメソッドは、会話に参加するメンバーを処理するためにオーバーライドできます。
ボット以外のメンバーが会話を退出しました	OnMembersRemovedAsync	このメソッドは、会話を退出するメンバーを処理するためにオーバーライドできます。
イベント アクティビティを受信しました	OnEventActivityAsync	このメソッドは、Event アクティビティで、イベントの種類に固有のハンドラーを呼び出します。
トークン応答イベント アクティビティを受信しました	OnTokenResponseEventAsync	このメソッドは、トークン応答イベントを処理するためにオーバーライドできます。
トークン応答以外のイベント アクティビティを受信しました	OnEventAsync	このメソッドは、他の種類のイベントを処理するためにオーバーライドできます。
その他のアクティビティの種類を受信しました	OnUnrecognizedActivityTypeAsync	このメソッドは、それ以外の場合は処理されないアクティビティの種類を処理するためにオーバーライドできます。

Teams に固有のアクティビティ ハンドラー

TeamsActivityHandlerでは、コア Bot Framework ハンドラー セクションのハンドラーの一覧が拡張され、次のイベントが含まれます。

イベント	ハンドラー	説明
channelCreated	OnTeamsChannelCreatedAsync	このメソッドは、作成される Teams チャネルを処理するためにオーバーライドできます。 詳細については、「会話更新イベントで作成されたチャネル」を参照してください。
channelDeleted	OnTeamsChannelDeletedAsync	このメソッドは、削除される Teams チャネルを処理するためにオーバーライドできます。 詳細については、「会話更新イベントで削除されたチャネル」を参照してください。
channelRenamed	OnTeamsChannelRenamedAsync	このメソッドは、名前が変更される Teams チャネルを処理するためにオーバーライドできます。 詳細については、「会話更新イベントでチャネルの名前が変更されました」を参照してください。
teamRenamed	OnTeamsTeamRenamedAsync	return Task.CompletedTask; このメソッドは、名前が変更される Teams チームを処理するためにオーバーライドできます。 詳細については、「会話の更新イベントでチーム名が変更されました」を参照してください。
MembersAdded	OnTeamsMembersAddedAsync	このメソッドは ActivityHandler の OnMembersAddedAsync メソッドを呼び出します。 このメソッドは、チームに参加するメンバーを処理するためにオーバーライドできます。 詳細については、会話更新イベントに追加されたチーム メンバーに関するページを参照してください。
MembersRemoved	OnTeamsMembersRemovedAsync	このメソッドは ActivityHandler の OnMembersRemovedAsync メソッドを呼び出します。 このメソッドは、チームを離れるメンバーを処理するためにオーバーライドできます。 詳細については、会話更新イベントで削除されたチーム メンバーに関するページを参照してください。
messageEdit	OnTeamsMessageEditAsync	このメソッドをオーバーライドして、Teams メッセージ編集イベントを処理できます。
messageUndelete	OnTeamsMessageUndeleteAsync	このメソッドをオーバーライドして、Teams メッセージの削除を取り消すイベントを処理できます。
messageSoftDelete	OnTeamsMessageSoftDeleteAsync	このメソッドをオーバーライドして、Teams メッセージの論理的な削除イベントを処理できます。

Teams の呼び出しアクティビティ

OnInvokeActivityAsync Teams アクティビティ ハンドラーから呼び出される Teams アクティビティ ハンドラーの一覧には、次の呼び出しの種類が含まれています。

呼び出しの種類	ハンドラー	説明
CardAction.Invoke	OnTeamsCardActionInvokeAsync	コネクタがカード アクション呼び出しアクティビティを受け取ると、このメソッドが呼び出されます。
fileConsent/invoke	OnTeamsFileConsentAcceptAsync	ユーザーがファイル同意カードを受け入れると、このメソッドが呼び出されます。
fileConsent/invoke	OnTeamsFileConsentAsync	コネクタがファイル同意カード アクティビティを受け取ると、このメソッドが呼び出されます。
fileConsent/invoke	OnTeamsFileConsentDeclineAsync	ユーザーがファイル同意カードを拒否すると、このメソッドが呼び出されます。
actionableMessage/executeAction	OnTeamsO365ConnectorCardActionAsync	コネクタが Microsoft 365 Groups アクション アクティビティのコネクタ カードを受け取ると、このメソッドが呼び出されます。
signin/verifyState	OnTeamsSigninVerifyStateAsync	コネクタが signIn 検証状態アクティビティを受け取ると、このメソッドが呼び出されます。
task/fetch	OnTeamsTaskModuleFetchAsync	ダイアログ (TeamsJS v1.x のタスク モジュールと呼ばれます) がフェッチされたときにロジックを提供するには、派生クラスでこのメソッドをオーバーライドできます。
task/submit	OnTeamsTaskModuleSubmitAsync	ダイアログが送信されたときにロジックを提供するために、派生クラスでこのメソッドをオーバーライドできます。

このセクションに記載されている Invoke アクティビティは、Teams の会話ボット用です。 Bot Framework SDK は、メッセージ拡張機能に固有の呼び出しアクティビティもサポートしています。 詳細については、「メッセージ拡張機能とは」を参照してください。

JavaScript

主要な Bot Framework ハンドラー

注:

追加および削除されたメンバーのアクティビティを除き、このセクションで説明するすべてのアクティビティ ハンドラーは Teams 以外のボットと同様に動作し続けます。

アクティビティ ハンドラーは、メッセージ スレッドの代わりに新しいメンバーがチームに追加されるチームのコンテキストで異なります。

ActivityHandlerで定義されているハンドラーの一覧には、次のイベントが含まれます。

イベント	ハンドラー	説明
任意のアクティビティの種類を受信しました	onTurn	このメソッドは、受信したアクティビティの種類に基づいて、他のハンドラーのいずれかを呼び出します。
メッセージ アクティビティを受信しました	onMessage	このメソッドは、Message アクティビティを処理するのに役立ちます。
受信したメッセージ更新アクティビティ	onMessageUpdate	このメソッドは、メッセージが更新された場合にハンドラーを呼び出します。
受信したメッセージ削除アクティビティ	onMessageDelete	このメソッドは、メッセージが削除された場合にハンドラーを呼び出します。
会話更新アクティビティを受信しました	onConversationUpdate	このメソッドは、ConversationUpdate アクティビティで、ボット以外のメンバーが会話に参加または退出した場合にハンドラーを呼び出します。
ボット以外のメンバーが会話に参加しました	onMembersAdded	このメソッドは、会話に参加するメンバーを処理するのに役立ちます。
ボット以外のメンバーが会話を退出しました	onMembersRemoved	このメソッドは、会話を退出するメンバーを処理するのに役立ちます。
イベント アクティビティを受信しました	onEvent	このメソッドは、Event アクティビティで、イベントの種類に固有のハンドラーを呼び出します。
トークン応答イベント アクティビティを受信しました	onTokenResponseEvent	このメソッドは、トークン応答イベントを処理するのに役立ちます。
その他のアクティビティの種類を受信しました	onUnrecognizedActivityType	このメソッドは、それ以外の場合は処理されないアクティビティの種類を処理するのに役立ちます。
メッセージの編集	onTeamsMessageEditEvent	このメソッドをオーバーライドして、会話内のメッセージが編集されたときに処理できます。
メッセージの削除の取り消し	onTeamsMessageUndeleteEvent	このメソッドをオーバーライドして、会話内の削除されたメッセージが削除されない場合を処理できます。 たとえば、ユーザーが削除されたメッセージを元に戻すことにした場合などです。
メッセージの論理的な削除	onTeamsMessageSoftDeleteEvent	このメソッドをオーバーライドして、会話内のメッセージが論理的に削除されたときに処理できます。

Teams に固有のアクティビティ ハンドラー

TeamsActivityHandlerでは、コア Bot Framework ハンドラー セクションのハンドラーの一覧が拡張され、次のイベントが含まれます。

イベント	ハンドラー	説明
channelCreated	onTeamsChannelCreated	このメソッドは、作成される Teams チャネルを処理するためにオーバーライドできます。 詳細については、「会話更新イベントで作成されたチャネル」を参照してください。
channelDeleted	onTeamsChannelDeleted	このメソッドは、削除される Teams チャネルを処理するためにオーバーライドできます。 詳細については、「会話更新イベントで削除されたチャネル」を参照してください。
channelRenamed	onTeamsChannelRenamed	このメソッドは、名前が変更される Teams チャネルを処理するためにオーバーライドできます。 詳細については、「会話更新イベントでチャネルの名前が変更されました」を参照してください。
teamRenamed	onTeamsTeamRenamed	return Task.CompletedTask; このメソッドは、名前が変更される Teams チームを処理するためにオーバーライドできます。 詳細については、「会話の更新イベントでチーム名が変更されました」を参照してください。
MembersAdded	onTeamsMembersAdded	このメソッドは ActivityHandler の OnMembersAddedAsync メソッドを呼び出します。 このメソッドは、チームに参加するメンバーを処理するためにオーバーライドできます。 詳細については、会話更新イベントに追加されたチーム メンバーに関するページを参照してください。
MembersRemoved	onTeamsMembersRemoved	このメソッドは ActivityHandler の OnMembersRemovedAsync メソッドを呼び出します。 このメソッドは、チームを離れるメンバーを処理するためにオーバーライドできます。 詳細については、会話更新イベントで削除されたチーム メンバーに関するページを参照してください。

Teams の呼び出しアクティビティ

次の表に、 onInvokeActivity Teams アクティビティ ハンドラーから呼び出される Teams アクティビティ ハンドラーの一覧を示します。

呼び出しの種類	ハンドラー	説明
CardAction.Invoke	handleTeamsCardActionInvoke	このメソッドは、カード アクションの呼び出しアクティビティがコネクタから受信されたときに呼び出されます。
fileConsent/invoke	handleTeamsFileConsentAccept	このメソッドは、ユーザーがファイル同意カードを受け入れたときに呼び出されます。
fileConsent/invoke	handleTeamsFileConsent	このメソッドは、ファイルの同意カード アクティビティがコネクタから受信されたときに呼び出されます。
fileConsent/invoke	handleTeamsFileConsentDecline	このメソッドは、ユーザーがファイル同意カードを拒否したときに呼び出されます。
actionableMessage/executeAction	handleTeamsO365ConnectorCardAction	このメソッドは、Microsoft 365 Groups アクション アクティビティのコネクタ カードがコネクタから受信されたときに呼び出されます。
signin/verifyState	handleTeamsSigninVerifyState	このメソッドは、 signIn 検証状態アクティビティがコネクタから受信されたときに呼び出されます。
task/fetch	handleTeamsTaskModuleFetch	このメソッドは、ダイアログがフェッチされたときにロジックを提供するために、派生クラスでオーバーライドできます。
task/submit	handleTeamsTaskModuleSubmit	このメソッドは、ダイアログが送信されたときにロジックを提供するために、派生クラスでオーバーライドできます。

このセクションに示す呼び出しアクティビティは、Teams の会話型ボット用です。 Bot Framework SDK は、メッセージ拡張機能に固有の呼び出しアクティビティもサポートしています。 詳細については、「メッセージ拡張機能とは」を参照してください。

Python

主要な Bot Framework ハンドラー

注:

追加および削除されたメンバーのアクティビティを除き、このセクションで説明するすべてのアクティビティ ハンドラーは Teams 以外のボットと同様に動作し続けます。

アクティビティ ハンドラーは、メッセージ スレッドの代わりに新しいメンバーがチームに追加されるチームのコンテキストで異なります。

ActivityHandlerで定義されているハンドラーの一覧には、次のイベントが含まれます。

イベント	ハンドラー	説明
任意のアクティビティの種類を受信しました	on_turn	このメソッドは、受信したアクティビティの種類に基づいて、他のハンドラーのいずれかを呼び出します。
メッセージ アクティビティを受信しました	on_message_activity	このメソッドは、Message アクティビティを処理するためにオーバーライドできます。
会話更新アクティビティを受信しました	on_conversation_update_activity	このメソッドは、ボット以外のメンバーが会話に参加または退出するとハンドラーを呼び出します。
ボット以外のメンバーが会話に参加しました	on_members_added_activity	このメソッドは、会話に参加するメンバーを処理するためにオーバーライドできます。
ボット以外のメンバーが会話を退出しました	on_members_removed_activity	このメソッドは、会話を退出するメンバーを処理するためにオーバーライドできます。
イベント アクティビティを受信しました	on_event_activity	このメソッドは、イベントの種類に固有のハンドラーを呼び出します。
トークン応答イベント アクティビティを受信しました	on_token_response_event	このメソッドは、トークン応答イベントを処理するためにオーバーライドできます。
トークン応答以外のイベント アクティビティを受信しました	on_event	このメソッドは、他の種類のイベントを処理するためにオーバーライドできます。
その他のアクティビティの種類を受信しました	on_unrecognized_activity_type	このメソッドは、処理されない任意の種類のアクティビティを処理するためにオーバーライドできます。

Teams に固有のアクティビティ ハンドラー

TeamsActivityHandlerでは、コア Bot Framework ハンドラー セクションのハンドラーの一覧が拡張され、次のイベントが含まれます。

イベント	ハンドラー	説明
channelCreated	on_teams_channel_created	このメソッドは、作成される Teams チャネルを処理するためにオーバーライドできます。 詳細については、「会話更新イベントで作成されたチャネル」を参照してください。
channelDeleted	on_teams_channel_deleted	このメソッドは、削除される Teams チャネルを処理するためにオーバーライドできます。 詳細については、「会話更新イベントで削除されたチャネル」を参照してください。
channelRenamed	on_teams_channel_renamed	このメソッドは、名前が変更される Teams チャネルを処理するためにオーバーライドできます。 詳細については、「会話更新イベントでチャネルの名前が変更されました」を参照してください。
teamRenamed	on_teams_team_renamed	このメソッドは、名前が変更される Teams チームを処理するためにオーバーライドできます。 詳細については、「会話の更新イベントでチーム名が変更されました」を参照してください。
MembersAdded	on_teams_members_added	このメソッドは ActivityHandler の OnMembersAddedAsync メソッドを呼び出します。 このメソッドは、チームに参加するメンバーを処理するためにオーバーライドできます。 詳細については、会話更新イベントに追加されたチーム メンバーに関するページを参照してください。
MembersRemoved	on_teams_members_removed	このメソッドは ActivityHandler の OnMembersRemovedAsync メソッドを呼び出します。 このメソッドは、チームを離れるメンバーを処理するためにオーバーライドできます。 詳細については、会話更新イベントで削除されたチーム メンバーに関するページを参照してください。

Teams の呼び出しアクティビティ

on_invoke_activity Teams アクティビティ ハンドラーから呼び出される Teams アクティビティ ハンドラーの一覧には、次の呼び出しの種類が含まれています。

呼び出しの種類	ハンドラー	説明
CardAction.Invoke	on_teams_card_action_invoke	このメソッドは、カード アクションの呼び出しアクティビティがコネクタから受信されたときに呼び出されます。
fileConsent/invoke	on_teams_file_consent_accept	このメソッドは、ユーザーがファイル同意カードを受け入れたときに呼び出されます。
fileConsent/invoke	on_teams_file_consent	このメソッドは、ファイルの同意カード アクティビティがコネクタから受信されたときに呼び出されます。
fileConsent/invoke	on_teams_file_consent_decline	このメソッドは、ユーザーがファイル同意カードを拒否したときに呼び出されます。
actionableMessage/executeAction	on_teams_o365_connector_card_action	このメソッドは、Microsoft 365 Groups アクション アクティビティのコネクタ カードがコネクタから受信されたときに呼び出されます。
signin/verifyState	on_teams_signin_verify_state	このメソッドは、 signIn 検証状態アクティビティがコネクタから受信されたときに呼び出されます。
task/fetch	on_teams_task_module_fetch	このメソッドは、ダイアログがフェッチされたときにロジックを提供するために、派生クラスでオーバーライドできます。
task/submit	on_teams_task_module_submit	このメソッドは、ダイアログが送信されたときにロジックを提供するために、派生クラスでオーバーライドできます。

このセクションに示す呼び出しアクティビティは、Teams の会話型ボット用です。 Bot Framework SDK は、メッセージ拡張機能に固有の呼び出しアクティビティもサポートしています。 詳細については、「メッセージ拡張機能とは」を参照してください。

---

ボット アクティビティ ハンドラーについて理解したので、会話と、ボットが受信または送信するメッセージに応じてボットがどのように動作するかを確認しましょう。

コード サンプル

サンプルの名前	説明	.NET	Node.js	Python
Teams 会話ボット	このサンプル アプリでは、Bot Framework v4 で使用できるさまざまなボット会話イベントを使用する方法を示します。	表示	表示	表示
ボット サンプル	Bot Framework v4 サンプルのセット。	表示	表示	表示

次の手順

会話の基本

関連項目

• Teams 用のボットを構築する
• Teams JavaScript client SDK
• Teams のアプリ マニフェストのスキーマ
• Bot Framework Connector サービスの API リファレンス
• Teams の特定のコンテキストをボット用に取得する
• ボットの会話内のメッセージ
• コンポーネントとウォーターフォールダイアログ