TeamsActivityHandler class

Paquete:

botbuilder

Agrega compatibilidad con eventos e interacciones específicos de Microsoft Teams.

Extends

ActivityHandler

Comentarios

Los desarrolladores pueden controlar las actividades de actualización de conversación enviadas desde Microsoft Teams a través de dos métodos:

1. Invalidar métodos a partir de on.. y no terminar en ..Event() (por ejemplo, onTeamsMembersAdded()), o en su lugar
2. Pasar devoluciones de llamada a métodos a partir de on..y que terminan en ...Event() (por ejemplo, onTeamsMembersAddedEvent()), para mantenerse en línea con la implementación anterior de {@see ActivityHandler}.

Los desarrolladores deben usar el número 1 o el número 2 anterior para todas las actividades de actualización de conversaciones y no tanto #2 como #3 para la misma actividad. Lo que significa que los desarrolladores deben invalidar onTeamsMembersAdded() y no usar tanto onTeamsMembersAdded() como onTeamsMembersAddedEvent().

Los desarrolladores que quieran controlar las actividades invoke deben invalidar los métodos a partir de handle...() (por ejemplo, handleTeamsTaskModuleFetch()).

Métodos

onTeamsChannelCreatedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsChannelCreated, como cuando se crea un canal.
onTeamsChannelDeletedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsChannelDeleted, como cuando se elimina un canal.
onTeamsChannelRenamedEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsChannelRenamed, como cuando se cambia el nombre de un canal.
onTeamsChannelRestoredEvent((channelInfo: ChannelInfo, teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsChannelRestored, como cuando se restaura un canal.
onTeamsMeetingEndEvent((meeting: MeetingEndEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para cuando finaliza una reunión de Teams.
onTeamsMeetingStartEvent((meeting: MeetingStartEventDetails, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para cuando se inicia una reunión de Teams.
onTeamsMembersAddedEvent((membersAdded: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsMembersAdded, como cuando los miembros distintos del bot se unen al canal, como la lógica de bienvenida del bot.
onTeamsMembersRemovedEvent((membersRemoved: TeamsChannelAccount[], teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsMembersRemoved, como cuando los miembros que no sean el bot abandonan el canal, como la lógica del buen bye del bot.
onTeamsReadReceiptEvent((receiptInfo: ReadReceiptInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para cuando se envía un recibo de lectura.
onTeamsTeamArchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsTeamArchived, como cuando se archiva un equipo.
onTeamsTeamDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsTeamDeleted, como cuando se elimina un equipo.
onTeamsTeamHardDeletedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsTeamHardDeleted, como cuando un equipo se elimina de forma permanente.
onTeamsTeamRenamedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsTeamRenamed, como cuando se cambia el nombre de un equipo.
onTeamsTeamRestoredEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsTeamRestored, como cuando se restaura un equipo.
onTeamsTeamUnarchivedEvent((teamInfo: TeamInfo, context: TurnContext, next: () => Promise<void>) => Promise<void>)	Registra un controlador para eventos TeamsTeamUnarchived, como cuando un equipo no está archivado.

Métodos heredados

onCommand(BotHandler)	Registra un controlador de eventos de actividad para la actividad de del comando .
onCommandResult(BotHandler)	Registra un controlador de eventos de actividad para la actividad CommandResult.
onConversationUpdate(BotHandler)	Registra un controlador de eventos de actividad para el evento actualización de conversación, emitido para cada actividad de actualización de conversación entrante.
onDialog(BotHandler)	Registra un controlador de eventos de actividad para el evento de cuadro de diálogo, emitido como el último evento de una actividad entrante.
onEndOfConversation(BotHandler)	Registra un controlador de eventos de actividad para el final de la conversación actividad.
onEvent(BotHandler)	Registra un controlador de eventos de actividad para el evento de evento, emitido para cada actividad de evento entrante.
onInstallationUpdate(BotHandler)	Registra un controlador de eventos de actividad para la actividad installationupdate.
onInstallationUpdateAdd(BotHandler)	Registra un controlador de eventos de actividad para la actividad installationupdate add.
onInstallationUpdateRemove(BotHandler)	Registra un controlador de eventos de actividad para la actividad installationupdate remove.
onMembersAdded(BotHandler)	Registra un controlador de eventos de actividad para los miembros de agregados evento, emitido para cualquier actividad de actualización de conversación entrante que incluya miembros agregados a la conversación.
onMembersRemoved(BotHandler)	Registra un controlador de eventos de actividad para los miembros de quitados evento, emitido para cualquier actividad de actualización de conversación entrante que incluya miembros quitados de la conversación.
onMessage(BotHandler)	Registra un controlador de eventos de actividad para el evento de mensaje, emitido para cada actividad de mensaje entrante.
onMessageReaction(BotHandler)	Registra un controlador de eventos de actividad para la reacción de mensaje evento, emitido para cada actividad de reacción entrante del mensaje.
onReactionsAdded(BotHandler)	Registra un controlador de eventos de actividad para las reacciones de agregadas evento, emitido para cualquier actividad de reacción de mensaje entrante que describa las reacciones agregadas a un mensaje.
onReactionsRemoved(BotHandler)	Registra un controlador de eventos de actividad para las reacciones de quitadas evento, emitido para cualquier actividad de reacción de mensaje entrante que describa las reacciones eliminadas de un mensaje.
onTokenResponseEvent(BotHandler)	Registra un controlador de eventos de actividad para el evento de tokens-response, emitido para cualquier actividad de evento de tokens/response entrante. Estos se generan como parte del flujo de autenticación de OAuth.
onTurn(BotHandler)	Registra un controlador de eventos de actividad para el evento turn, emitido para cada actividad entrante, independientemente del tipo.
onTyping(BotHandler)	Registra un controlador de eventos de actividad para el escritura actividad.
onUnrecognizedActivityType(BotHandler)	Registra un controlador de eventos de actividad para el tipo de actividad no reconocido evento, emitido para una actividad entrante con un tipo para el que el ActivityHandler no proporciona un controlador de eventos.
run(TurnContext)	Se llama para iniciar el proceso de emisión de eventos.

Detalles del método

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

Registra un controlador para eventos TeamsChannelCreated, como cuando se crea un canal.

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>

Devolución de llamada para controlar el evento creado por el canal de teams.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsChannelDeleted, como cuando se elimina un canal.

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>

Devolución de llamada para controlar el evento eliminado del canal de teams.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsChannelRenamed, como cuando se cambia el nombre de un canal.

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>

Devolución de llamada para controlar el evento cambiado de nombre del canal de teams.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsChannelRestored, como cuando se restaura un canal.

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>

Devolución de llamada para controlar el evento restaurado del canal de teams.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para cuando finaliza una reunión de Teams.

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>

Devolución de llamada que controla los eventos meeting End.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para cuando se inicia una reunión de Teams.

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>

Devolución de llamada que controla los eventos de inicio de reunión.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsMembersAdded, como cuando los miembros distintos del bot se unen al canal, como la lógica de bienvenida del 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>

Devolución de llamada para controlar el evento agregado a los miembros de los equipos.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsMembersRemoved, como cuando los miembros que no sean el bot abandonan el canal, como la lógica del buen bye del 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>

Devolución de llamada para controlar el evento quitado de los miembros de los equipos.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para cuando se envía un recibo de lectura.

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>

Devolución de llamada que controla los eventos read Receipt.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsTeamArchived, como cuando se archiva un equipo.

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>

Devolución de llamada para controlar el evento archivado del equipo de teams.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsTeamDeleted, como cuando se elimina un equipo.

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>

Devolución de llamada para controlar el evento eliminado por el equipo de teams.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsTeamHardDeleted, como cuando un equipo se elimina de forma permanente.

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>

Devolución de llamada para controlar el evento eliminado de forma permanente del equipo de equipos.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsTeamRenamed, como cuando se cambia el nombre de un equipo.

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>

Devolución de llamada para controlar el evento cambiado de nombre del equipo de teams.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsTeamRestored, como cuando se restaura un equipo.

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>

Devolución de llamada para controlar el evento restaurado por el equipo de teams.

Devoluciones

this

Promesa que representa el trabajo en cola.

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

Registra un controlador para eventos TeamsTeamUnarchived, como cuando un equipo no está archivado.

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>

Devolución de llamada para controlar el evento sin archivar del equipo de teams.

Devoluciones

this

Promesa que representa el trabajo en cola.

Detalles de los métodos heredados

onCommand(BotHandler)

Registra un controlador de eventos de actividad para la actividad de del comando .

function onCommand(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Para controlar un evento Command, use el onCommand controlador de eventos específico del tipo.

heredado de ActivityHandler.onCommand

onCommandResult(BotHandler)

Registra un controlador de eventos de actividad para la actividad CommandResult.

function onCommandResult(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Para controlar un evento CommandResult, use el onCommandResult controlador de eventos específico del tipo.

heredado de ActivityHandler.onCommandResult

onConversationUpdate(BotHandler)

Registra un controlador de eventos de actividad para el evento actualización de conversación, emitido para cada actividad de actualización de conversación entrante.

function onConversationUpdate(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Las actividades de actualización de conversaciones describen los cambios en los metadatos de una conversación, como título, participantes u otra información específica del canal.

Para controlar cuándo se agregan o quitan miembros de la conversación, use el onMembersAdded y onMembersRemoved controladores de eventos de subtipo.

heredado de ActivityHandler.onConversationUpdate

onDialog(BotHandler)

Registra un controlador de eventos de actividad para el evento de cuadro de diálogo, emitido como el último evento de una actividad entrante.

function onDialog(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Heredado de ActivityHandler.onDialog

onEndOfConversation(BotHandler)

Registra un controlador de eventos de actividad para el final de la conversación actividad.

function onEndOfConversation(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Normalmente, esta actividad se envía desde una aptitud a un llamador de aptitud que indica el final de esa conversación secundaria concreta.

Para controlar un extremo de conversación, use el onEndOfConversation controlador de eventos específico del tipo.

heredado de ActivityHandler.onEndOfConversation

onEvent(BotHandler)

Registra un controlador de eventos de actividad para el evento de evento, emitido para cada actividad de evento entrante.

function onEvent(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Las actividades de eventos comunican información mediante programación de un cliente o canal a un bot. El significado de una actividad de evento se define mediante el nombre de la actividad propiedad, que es significativo dentro del ámbito de un canal. Las actividades de eventos están diseñadas para llevar información interactiva (como clics de botón) e información no interactiva (como una notificación de un cliente que actualiza automáticamente un modelo de voz incrustado).

Para controlar un evento de evento tokens/response, use el onTokenResponseEvent controlador de eventos de subtipo. Para controlar otros eventos con nombre, agregue lógica a este controlador.

heredado de ActivityHandler.onEvent

onInstallationUpdate(BotHandler)

Registra un controlador de eventos de actividad para la actividad installationupdate.

function onInstallationUpdate(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Para controlar un evento InstallationUpdate, use el onInstallationUpdate controlador de eventos específico del tipo.

heredado de ActivityHandler.onInstallationUpdate

onInstallationUpdateAdd(BotHandler)

Registra un controlador de eventos de actividad para la actividad installationupdate add.

function onInstallationUpdateAdd(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de . Para controlar un evento InstallationUpdateAdd, use el onInstallationUpdateAdd controlador de eventos específico del tipo.

Heredado de ActivityHandler.onInstallationUpdateAdd

onInstallationUpdateRemove(BotHandler)

Registra un controlador de eventos de actividad para la actividad installationupdate remove.

function onInstallationUpdateRemove(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Para controlar un evento InstallationUpdateRemove, use el onInstallationUpdateRemove controlador de eventos específico del tipo.

heredado de ActivityHandler.onInstallationUpdateRemove

onMembersAdded(BotHandler)

Registra un controlador de eventos de actividad para los miembros de agregados evento, emitido para cualquier actividad de actualización de conversación entrante que incluya miembros agregados a la conversación.

function onMembersAdded(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

La propiedad miembros de la actividadAdded contiene los miembros agregados a la conversación, lo que puede incluir el bot.

Para controlar los eventos de actualización de conversaciones en general, use el controlador de eventos onConversationUpdate específico del tipo.

Heredado de ActivityHandler.onMembersAdded

onMembersRemoved(BotHandler)

Registra un controlador de eventos de actividad para los miembros de quitados evento, emitido para cualquier actividad de actualización de conversación entrante que incluya miembros quitados de la conversación.

function onMembersRemoved(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

La propiedad membersRemoved de la actividad contiene los miembros quitados de la conversación, lo que puede incluir el bot.

Para controlar los eventos de actualización de conversaciones en general, use el controlador de eventos onConversationUpdate específico del tipo.

Heredado de ActivityHandler.onMembersRemoved

onMessage(BotHandler)

Registra un controlador de eventos de actividad para el evento de mensaje, emitido para cada actividad de mensaje entrante.

function onMessage(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Las actividades de mensaje representan contenido destinado a mostrarse dentro de una interfaz conversacional y pueden contener texto, voz, tarjetas interactivas y datos adjuntos binarios o desconocidos. No todas las actividades de mensaje contienen texto, la propiedad texto de la actividad puede ser null o undefined.

Heredado de ActivityHandler.onMessage

onMessageReaction(BotHandler)

Registra un controlador de eventos de actividad para la reacción de mensaje evento, emitido para cada actividad de reacción entrante del mensaje.

function onMessageReaction(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Las actividades de reacción de mensajes representan una interacción social en una actividad de mensaje existente dentro de una conversación. El propiedad replyToId de la actividad de reacción del mensaje hace referencia a la actividad original. El de propiedad representa el origen de la reacción, como el usuario que ha reaccionado al mensaje.

Para controlar cuándo se agregan o quitan las reacciones de los mensajes de la conversación, use los controladores de eventos onReactionsAdded y onReactionsRemoved subtipo.

heredado de ActivityHandler.onMessageReaction

onReactionsAdded(BotHandler)

Registra un controlador de eventos de actividad para las reacciones de agregadas evento, emitido para cualquier actividad de reacción de mensaje entrante que describa las reacciones agregadas a un mensaje.

function onReactionsAdded(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

La propiedad reacciones de la actividadAdded incluye una o varias reacciones agregadas.

Para controlar eventos de reacción de mensajes en general, use el onMessageReaction controlador de eventos específico del tipo.

Heredado de ActivityHandler.onReactionsAdded

onReactionsRemoved(BotHandler)

Registra un controlador de eventos de actividad para las reacciones de quitadas evento, emitido para cualquier actividad de reacción de mensaje entrante que describa las reacciones eliminadas de un mensaje.

function onReactionsRemoved(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

La propiedad reacciones de la actividadRemoved incluye una o varias reacciones que se quitaron.

Para controlar eventos de reacción de mensajes en general, use el onMessageReaction controlador de eventos específico del tipo.

Heredado de ActivityHandler.onReactionsRemoved

onTokenResponseEvent(BotHandler)

Registra un controlador de eventos de actividad para el evento de tokens-response, emitido para cualquier actividad de evento de tokens/response entrante. Estos se generan como parte del flujo de autenticación de OAuth.

function onTokenResponseEvent(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

El valor de la actividad propiedad contiene el token de usuario.

Si el bot controla la autenticación mediante un OAuthPrompt dentro de un cuadro de diálogo, el cuadro de diálogo deberá recibir esta actividad para completar el flujo de autenticación.

Para controlar otros eventos con nombre y eventos en general, use el onEvent controlador de eventos específico del tipo.

Heredado de ActivityHandler.onTokenResponseEvent

onTurn(BotHandler)

Registra un controlador de eventos de actividad para el evento turn, emitido para cada actividad entrante, independientemente del tipo.

function onTurn(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

heredado de ActivityHandler.onTurn

onTyping(BotHandler)

Registra un controlador de eventos de actividad para el escritura actividad.

function onTyping(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

Para controlar un evento Typing, use el onTyping controlador de eventos específico del tipo.

Heredado de ActivityHandler.onTyping

onUnrecognizedActivityType(BotHandler)

Registra un controlador de eventos de actividad para el tipo de actividad no reconocido evento, emitido para una actividad entrante con un tipo para el que el ActivityHandler no proporciona un controlador de eventos.

function onUnrecognizedActivityType(handler: BotHandler): this

Parámetros

handler

BotHandler

Controlador de eventos.

Devoluciones

this

Referencia al objeto activityHandler de .

Comentarios

El ActivityHandler no define eventos para todos los tipos de actividad definidos en el esquema de actividad de Bot Framework . Además, los canales y adaptadores personalizados pueden crear Activities con tipos que no están en el esquema. Cuando el controlador de actividad recibe este evento, emite un evento de tipo de actividad no reconocido.

El tipo de de la actividad propiedad contiene el tipo de actividad.

Heredado de ActivityHandler.onUnrecognizedActivityType

run(TurnContext)

Se llama para iniciar el proceso de emisión de eventos.

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

Parámetros

context

TurnContext

Objeto de contexto del turno actual.

Devoluciones

Promise<void>

Comentarios

Normalmente, proporcionaría este método como controlador de función al que llama el adaptador para realizar la lógica del bot después de que el adaptador haya procesado previamente la actividad recibida y enrutada a través de cualquier middleware.

Por ejemplo:

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

Consulte también

• BotFrameworkAdapter.processActivity

Heredado de ActivityHandler.run