TeamsActivityHandler class

Pacote:

botbuilder

Adiciona suporte para eventos e interações específicos do Microsoft Teams.

Extends

ActivityHandler

Comentários

Os desenvolvedores podem lidar com as atividades de Atualização de Conversa enviadas do Microsoft Teams por meio de dois métodos:

1. Substituir métodos começando com on.. e não terminando em ..Event() (por exemplo, onTeamsMembersAdded()) ou em vez disso
2. Passando retornos de chamada para métodos que começam com on..e terminando em ...Event() (por exemplo, onTeamsMembersAddedEvent()), para se manter em linha com a implementação mais antiga do {@see ActivityHandler}.

Os desenvolvedores devem usar nº 1 ou nº 2, acima para todas as atividades de Atualização de Conversa e não nº 2 e nº 3 para a mesma atividade. Ou seja, os desenvolvedores devem substituir onTeamsMembersAdded() e não usar onTeamsMembersAdded() e onTeamsMembersAddedEvent().

Os desenvolvedores que desejam lidar com atividades de invocação devem métodos de substituição começando com handle...() (por exemplo, handleTeamsTaskModuleFetch()).

Métodos

onTeamsChannelCreatedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsChannelCreated, como para quando um canal é criado.
onTeamsChannelDeletedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsChannelDeleted, como para quando um canal é excluído.
onTeamsChannelRenamedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsChannelRenamed, como para quando um canal é renomeado.
onTeamsChannelRestoredEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsChannelRestored, como para quando um canal é restaurado.
onTeamsMeetingEndEvent((meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para quando uma reunião do Teams termina.
onTeamsMeetingStartEvent((meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para quando uma reunião do Teams é iniciada.
onTeamsMembersAddedEvent((membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsMembersAdded, como para quando membros diferentes do bot ingressarem no canal, como a lógica de boas-vindas do bot.
onTeamsMembersRemovedEvent((membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsMembersRemoved, como quando membros diferentes do bot saem do canal, como a lógica de adeus do bot.
onTeamsReadReceiptEvent((receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para quando um Recibo de Leitura é enviado.
onTeamsTeamArchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsTeamArchived, como para quando uma equipe é arquivada.
onTeamsTeamDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsTeamDeleted, como quando uma equipe é excluída.
onTeamsTeamHardDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsTeamHardDeleted, como para quando uma equipe é excluída.
onTeamsTeamRenamedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsTeamRenamed, como para quando uma equipe é renomeada.
onTeamsTeamRestoredEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsTeamRestored, como para quando uma equipe é restaurada.
onTeamsTeamUnarchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra um manipulador para eventos TeamsTeamUnarchived, como para quando uma equipe não é criada.

Métodos herdados

onCommand(BotHandler)	Registra um manipulador de eventos de atividade para a atividade do comando .
onCommandResult(BotHandler)	Registra um manipulador de eventos de atividade para a atividade CommandResult.
onConversationUpdate(BotHandler)	Registra um manipulador de eventos de atividade para a atualização de conversa evento, emitido para cada atividade de atualização de conversa de entrada.
onDialog(BotHandler)	Registra um manipulador de eventos de atividade para a caixa de diálogo evento, emitido como o último evento para uma atividade de entrada.
onEndOfConversation(BotHandler)	Registra um manipulador de eventos de atividade para a atividade de fim da conversa.
onEvent(BotHandler)	Registra um manipulador de eventos de atividade para o evento evento, emitido para cada atividade de evento de entrada.
onInstallationUpdate(BotHandler)	Registra um manipulador de eventos de atividade para a atividade installationupdate.
onInstallationUpdateAdd(BotHandler)	Registra um manipulador de eventos de atividade para o atividade add de instalação.
onInstallationUpdateRemove(BotHandler)	Registra um manipulador de eventos de atividade para o instalaçãoupdate remover atividade.
onMembersAdded(BotHandler)	Registra um manipulador de eventos de atividade para os membros adicionados evento, emitido para qualquer atividade de atualização de conversa de entrada que inclua membros adicionados à conversa.
onMembersRemoved(BotHandler)	Registra um manipulador de eventos de atividade para os membros removidos evento, emitido para qualquer atividade de atualização de conversa de entrada que inclua membros removidos da conversa.
onMessage(BotHandler)	Registra um manipulador de eventos de atividade para a mensagem evento, emitido para cada atividade de mensagem de entrada.
onMessageReaction(BotHandler)	Registra um manipulador de eventos de atividade para a reação da mensagem evento, emitido para cada atividade de reação de mensagem de entrada.
onReactionsAdded(BotHandler)	Registra um manipulador de eventos de atividade para as reações adicionadas evento, emitido para qualquer atividade de reação de mensagem de entrada que descreva as reações adicionadas a uma mensagem.
onReactionsRemoved(BotHandler)	Registra um manipulador de eventos de atividade para as reações removidas evento, emitido para qualquer atividade de reação de mensagem de entrada que descreve as reações removidas de uma mensagem.
onTokenResponseEvent(BotHandler)	Registra um manipulador de eventos de atividade para o evento tokens-resposta, emitido para qualquer atividade de evento de tokens/response de entrada. Eles são gerados como parte do fluxo de autenticação OAuth.
onTurn(BotHandler)	Registra um manipulador de eventos de atividade para o evento, emitido para cada atividade de entrada, independentemente do tipo.
onTyping(BotHandler)	Registra um manipulador de eventos de atividade para o digitando atividade.
onUnrecognizedActivityType(BotHandler)	Registra um manipulador de eventos de atividade para o tipo de atividade não reconhecido evento, emitido para uma atividade de entrada com um tipo para o qual o ActivityHandler não fornece um manipulador de eventos.
run(TurnContext)	Chamado para iniciar o processo de emissão de eventos.

Detalhes do método

onTeamsChannelCreatedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsChannelCreated, como para quando um canal é criado.

function onTeamsChannelCreatedEvent(handler: (channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento criado pelo canal do teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsChannelDeletedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsChannelDeleted, como para quando um canal é excluído.

function onTeamsChannelDeletedEvent(handler: (channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento excluído do canal do teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsChannelRenamedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsChannelRenamed, como para quando um canal é renomeado.

function onTeamsChannelRenamedEvent(handler: (channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento renomeado pelo canal do Teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsChannelRestoredEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsChannelRestored, como para quando um canal é restaurado.

function onTeamsChannelRestoredEvent(handler: (channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento restaurado do canal do teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsMeetingEndEvent((meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para quando uma reunião do Teams termina.

function onTeamsMeetingEndEvent(handler: (meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada que manipula eventos de Fim de Reunião.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsMeetingStartEvent((meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para quando uma reunião do Teams é iniciada.

function onTeamsMeetingStartEvent(handler: (meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada que manipula eventos de Início da Reunião.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsMembersAddedEvent((membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsMembersAdded, como para quando membros diferentes do bot ingressarem no canal, como a lógica de boas-vindas do bot.

function onTeamsMembersAddedEvent(handler: (membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento adicionado aos membros das equipes.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsMembersRemovedEvent((membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsMembersRemoved, como quando membros diferentes do bot saem do canal, como a lógica de adeus do bot.

function onTeamsMembersRemovedEvent(handler: (membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento removido pelos membros das equipes.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsReadReceiptEvent((receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para quando um Recibo de Leitura é enviado.

function onTeamsReadReceiptEvent(handler: (receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada que manipula eventos de Confirmação de Leitura.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsTeamArchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsTeamArchived, como para quando uma equipe é arquivada.

function onTeamsTeamArchivedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento arquivado da equipe do Teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsTeamDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsTeamDeleted, como quando uma equipe é excluída.

function onTeamsTeamDeletedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento excluído pela equipe do Teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsTeamHardDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsTeamHardDeleted, como para quando uma equipe é excluída.

function onTeamsTeamHardDeletedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento de exclusão dura da equipe do teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsTeamRenamedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsTeamRenamed, como para quando uma equipe é renomeada.

function onTeamsTeamRenamedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento renomeado pela equipe do Teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsTeamRestoredEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsTeamRestored, como para quando uma equipe é restaurada.

function onTeamsTeamRestoredEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento restaurado pela equipe do Teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

onTeamsTeamUnarchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)

Registra um manipulador para eventos TeamsTeamUnarchived, como para quando uma equipe não é criada.

function onTeamsTeamUnarchivedEvent(handler: (teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>): this

Parâmetros

handler

(teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>

Um retorno de chamada para lidar com o evento não abrangente da equipe do Teams.

Retornos

this

Uma promessa que representa o trabalho enfileirado.

Detalhes do método herdado

onCommand(BotHandler)

Registra um manipulador de eventos de atividade para a atividade do comando .

function onCommand(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

Para manipular um evento Command, use o onCommand manipulador de eventos específico do tipo.

herdado de ActivityHandler.onCommand

onCommandResult(BotHandler)

Registra um manipulador de eventos de atividade para a atividade CommandResult.

function onCommandResult(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

Para manipular um evento CommandResult, use o onCommandResult manipulador de eventos específico do tipo.

herdado de ActivityHandler.onCommandResult

onConversationUpdate(BotHandler)

Registra um manipulador de eventos de atividade para a atualização de conversa evento, emitido para cada atividade de atualização de conversa de entrada.

function onConversationUpdate(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

As atividades de atualização de conversa descrevem as alterações nos metadados de uma conversa, como título, participantes ou outras informações específicas do canal.

Para lidar quando os membros são adicionados ou removidos da conversa, use os onMembersAdded e onMembersRemoved manipuladores de eventos de subtipo.

Herdado de ActivityHandler.onConversationUpdate

onDialog(BotHandler)

Registra um manipulador de eventos de atividade para a caixa de diálogo evento, emitido como o último evento para uma atividade de entrada.

function onDialog(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

herdado de ActivityHandler.onDialog

onEndOfConversation(BotHandler)

Registra um manipulador de eventos de atividade para a atividade de fim da conversa.

function onEndOfConversation(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

Essa atividade normalmente é enviada de uma habilidade para um chamador de habilidade que indica o fim dessa conversa filho em particular.

Para lidar com um fim de conversa, use o onEndOfConversation manipulador de eventos específico do tipo.

herdado de ActivityHandler.onEndOfConversation

onEvent(BotHandler)

Registra um manipulador de eventos de atividade para o evento evento, emitido para cada atividade de evento de entrada.

function onEvent(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

As atividades de evento comunicam informações programáticas de um cliente ou canal para um bot. O significado de uma atividade de evento é definido pelo nome da atividade propriedade, o que é significativo dentro do escopo de um canal. As atividades de evento são projetadas para transportar informações interativas (como cliques de botão) e informações não interativas (como uma notificação de um cliente atualizando automaticamente um modelo de fala inserido).

Para lidar com um evento de tokens/response, use o manipulador de eventos onTokenResponseEvent subtipo. Para lidar com outros eventos nomeados, adicione lógica a esse manipulador.

herdado de ActivityHandler.onEvent

onInstallationUpdate(BotHandler)

Registra um manipulador de eventos de atividade para a atividade installationupdate.

function onInstallationUpdate(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

Para manipular um evento InstallationUpdate, use o manipulador de eventos onInstallationUpdate tipo específico.

herdado de ActivityHandler.onInstallationUpdate

onInstallationUpdateAdd(BotHandler)

Registra um manipulador de eventos de atividade para o atividade add de instalação.

function onInstallationUpdateAdd(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler. Para manipular um evento InstallationUpdateAdd, use o onInstallationUpdateAdd manipulador de eventos específico do tipo.

herdado de ActivityHandler.onInstallationUpdateAdd

onInstallationUpdateRemove(BotHandler)

Registra um manipulador de eventos de atividade para o instalaçãoupdate remover atividade.

function onInstallationUpdateRemove(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

Para manipular um evento InstallationUpdateRemove, use o onInstallationUpdateRemove manipulador de eventos específico do tipo.

Herdado de ActivityHandler.onInstallationUpdateRemove

onMembersAdded(BotHandler)

Registra um manipulador de eventos de atividade para os membros adicionados evento, emitido para qualquer atividade de atualização de conversa de entrada que inclua membros adicionados à conversa.

function onMembersAdded(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

A propriedade membros adicionados da atividade contém os membros adicionados à conversa, o que pode incluir o bot.

Para lidar com eventos de atualização de conversa em geral, use o onConversationUpdate manipulador de eventos específico do tipo.

Herdado de ActivityHandler.onMembersAdded

onMembersRemoved(BotHandler)

Registra um manipulador de eventos de atividade para os membros removidos evento, emitido para qualquer atividade de atualização de conversa de entrada que inclua membros removidos da conversa.

function onMembersRemoved(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

A propriedade membersRemoved da atividade contém os membros removidos da conversa, o que pode incluir o bot.

Para lidar com eventos de atualização de conversa em geral, use o onConversationUpdate manipulador de eventos específico do tipo.

Herdado de ActivityHandler.onMembersRemoved

onMessage(BotHandler)

Registra um manipulador de eventos de atividade para a mensagem evento, emitido para cada atividade de mensagem de entrada.

function onMessage(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

As atividades de mensagem representam o conteúdo destinado a ser mostrado em uma interface de conversa e podem conter texto, fala, cartões interativos e anexos binários ou desconhecidos. Nem todas as atividades de mensagem contêm texto, a propriedade de texto da atividade pode ser ou .

Herdado de ActivityHandler.onMessage

onMessageReaction(BotHandler)

Registra um manipulador de eventos de atividade para a reação da mensagem evento, emitido para cada atividade de reação de mensagem de entrada.

function onMessageReaction(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

As atividades de reação de mensagem representam uma interação social em uma atividade de mensagem existente dentro de uma conversa. A atividade original é referida pela propriedade de replyToId da atividade de reação da mensagem. O da propriedade representa a origem da reação, como o usuário que reagiu à mensagem.

Para lidar quando as reações são adicionadas ou removidas de mensagens na conversa, use o onReactionsAdded e onReactionsRemoved manipuladores de eventos de subtipo.

Herdado de ActivityHandler.onMessageReaction

onReactionsAdded(BotHandler)

Registra um manipulador de eventos de atividade para as reações adicionadas evento, emitido para qualquer atividade de reação de mensagem de entrada que descreva as reações adicionadas a uma mensagem.

function onReactionsAdded(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

Reações da atividade Adicionadas propriedade inclui uma ou mais reações que foram adicionadas.

Para lidar com eventos de reação de mensagem em geral, use o onMessageReaction manipulador de eventos específico do tipo.

herdado de ActivityHandler.onReactionsAdded

onReactionsRemoved(BotHandler)

Registra um manipulador de eventos de atividade para as reações removidas evento, emitido para qualquer atividade de reação de mensagem de entrada que descreve as reações removidas de uma mensagem.

function onReactionsRemoved(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

A propriedade reactionsRemoved da atividade inclui uma ou mais reações que foram removidas.

Para lidar com eventos de reação de mensagem em geral, use o onMessageReaction manipulador de eventos específico do tipo.

herdado de ActivityHandler.onReactionsRemoved

onTokenResponseEvent(BotHandler)

Registra um manipulador de eventos de atividade para o evento tokens-resposta, emitido para qualquer atividade de evento de tokens/response de entrada. Eles são gerados como parte do fluxo de autenticação OAuth.

function onTokenResponseEvent(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

O valor da atividade propriedade contém o token de usuário.

Se o bot manipular a autenticação usando um OAuthPrompt em uma caixa de diálogo, a caixa de diálogo precisará receber essa atividade para concluir o fluxo de autenticação.

Para lidar com outros eventos nomeados e eventos de evento em geral, use o onEvent manipulador de eventos específico do tipo.

Herdado de ActivityHandler.onTokenResponseEvent

onTurn(BotHandler)

Registra um manipulador de eventos de atividade para o evento, emitido para cada atividade de entrada, independentemente do tipo.

function onTurn(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Herdado de ActivityHandler.onTurn

onTyping(BotHandler)

Registra um manipulador de eventos de atividade para o digitando atividade.

function onTyping(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

Para lidar com um evento de digitação, use o onTyping manipulador de eventos específico do tipo.

herdado de ActivityHandler.onTyping

onUnrecognizedActivityType(BotHandler)

Registra um manipulador de eventos de atividade para o tipo de atividade não reconhecido evento, emitido para uma atividade de entrada com um tipo para o qual o ActivityHandler não fornece um manipulador de eventos.

function onUnrecognizedActivityType(handler: BotHandler): this

Parâmetros

handler

BotHandler

O manipulador de eventos.

Retornos

this

Uma referência ao objeto ActivityHandler.

Comentários

O ActivityHandler não define eventos para todos os tipos de atividade definidos no esquema de atividade do Bot Framework. Além disso, canais e adaptadores personalizados podem criar Atividades com tipos que não estão no esquema. Quando o manipulador de atividade recebe esse evento, ele emite um evento de tipo de atividade não reconhecido.

A propriedade do tipo da atividade contém o tipo de atividade.

herdado de ActivityHandler.onUnrecognizedActivityType

run(TurnContext)

Chamado para iniciar o processo de emissão de eventos.

function run(context: TurnContext): Promise<void>

Parâmetros

context

TurnContext

O objeto de contexto para a curva atual.

Retornos

Promise<void>

Comentários

Normalmente, você forneceria esse método como o manipulador de funções que o adaptador chama para executar a lógica do bot depois que a atividade recebida tiver sido pré-processada pelo adaptador e roteada por meio de qualquer middleware.

Por exemplo:

 server.post('/api/messages', (req, res) => {
     adapter.processActivity(req, res, async (context) => {
         // Route to bot's activity logic.
         await bot.run(context);
     });
});

Consulte também

• BotFrameworkAdapter.processActivity

Herdado de ActivityHandler.run