Activadores web de Microsoft Teams
- Última actualización2026/01/13
Activadores web de Microsoft Teams
Los activadores web de Microsoft Teams permiten automatizar tareas basadas en los eventos que ocurren en los chats o canales de Microsoft Teams. Los activadores web detectan eventos específicos que ocurren en el Microsoft Teams. Una vez que se producen los eventos, el activador inicia las acciones configuradas.
Resumen
Los activadores web de Microsoft Teams le permiten crear activadores basados en eventos como mensajes de chat directos, mensajes de chat grupales y cambios en la membresía de canales en Microsoft Teams. Puede usar los activadores para activar flujos de trabajo tan pronto como ocurra el evento en Microsoft Teams, lo que reduce el monitoreo manual y el tiempo de respuesta de comunicaciones importantes. Las opciones disponibles en los activadores web de Microsoft Teams le permiten crear automatizaciones basadas en activadores para casos de uso como la asignación de tickets, la extracción de información de cualquier mensaje de chat y el inicio de un hilo de correo electrónico para notificar a las partes interesadas.
La latencia entre que ocurre el evento en una aplicación de Microsoft Teams y el disparador inicia la automatización basada en el evento es de menos de 30 segundos. Si el envío del evento a la sesión falla, el activador vuelve a intentar obtener el evento automáticamente.
Los activadores web de Microsoft Teams ofrecen la opción de utilizar palabras clave para filtrar mensajes. La opción Filtro le permite configurar el activador para casos de uso en los que la automatización debe activarse según palabras clave específicas. Esta opción limita las respuestas del evento a los mensajes que contienen las palabras clave especificadas.
El activador captura la información de la carga útil de la respuesta del evento desde el servidor de Microsoft en un formato JSON estructurado. Esta carga útil incluye la información de autenticación que permite validar los datos. Puede ver la carga útil de la respuesta en la página Registro de auditoría como pares clave-valor. Puede utilizar esta información de pares clave-valor como entradas para las acciones posteriores dentro de la sesión.
Autenticación
Los activadores web de Microsoft Teams usan OAuth para autenticar la conexión a la cuenta de Microsoft 365. Configure la conexión OAuth con los parámetros aplicables de Microsoft Entra para Microsoft Teams. Para obtener más información sobre cómo configurar conexiones OAuth, consulte Crear conexiones OAuth.
Los activadores web de Microsoft Teams utilizan certificados de Microsoft Azure para autenticar la suscripción a la cuenta de Microsoft y descifrar los datos entrantes de los servidores de Microsoft. Inicie sesión en el portal de Microsoft Azure y cree un certificado. Para obtener más información sobre cómo crear certificados en el portal de Microsoft Azure, consulte Certificate creation methods en el portal de Microsoft Learn. Para obtener más información sobre la administración de certificados, consulte Managing encryption keys.
Asegúrese de agregar el certificado creado en la Credential Vault. Realice lo siguiente para agregar los datos del certificado a la Credential Vault:
- Abra el archivo de certificado en cualquier editor de texto.
- Copie todo el contenido del archivo del certificado.
- Inicie sesión en Control Room como administrador.
- Vaya a y haga clic en Crear credencial.
- Ingrese un Nombre de la credencial y una Descripción apropiados para la credencial.
- Ingrese un nombre apropiado en Nombre del atributo en la sección Atributos.
- Seleccione Estándar y pegue el contenido del certificado en el campo Valor en la sección Entrada de Atributos.
- Haga clic en Crear credencial para guardar los datos del certificado en la Credential Vault.
Eventos admitidos
Los siguientes eventos son compatibles tanto en la configuración de activadores de chat individual como de equipos:
| Eventos | Descripción |
|---|---|
| Cuando se añade un mensaje de chat. | Cuando llega un nuevo mensaje. |
| Cuando se actualiza un mensaje de chat | Cuando se edita un mensaje de chat existente. |
| Cuando se borra un mensaje de chat | Cuando se elimina un mensaje de chat existente. |
Los siguientes eventos son compatibles en la configuración del activador de membresía de equipo:
| Eventos | Descripción |
|---|---|
| Cuando se añade un nuevo miembro al equipo | Cuando los propietarios del equipo agregan un nuevo miembro al equipo seleccionado. |
| Cuando se actualiza un miembro del equipo | Cuando los propietarios del equipo editan los detalles de miembros existentes. |
| Cuando se retira a un miembro del equipo | Cuando los propietarios del equipo eliminan a un miembro del equipo seleccionado. |
Requisitos previos
Asegúrese de que se cumplan los siguientes requisitos previos:
- Una licencia de Bot Creator o Citizen Developer.
- Permisos ACTIVADORES DE EVENTOS y Ver mis bots.
- Permisos de Registro y Descarga en las carpetas en las que se encuentra la automatización.
- Una conexión activa de OAuth para la cuenta de Microsoft 365.
- Un certificado de Microsoft Azure.
Configuración
Las siguientes configuraciones están disponibles para los activadores web de Microsoft Teams:
- Conexión OAuth de la Control Room
- Utilice la opción Elegir y siga las indicaciones del modal Elegir una conexión OAuth para seleccionar la conexión OAuth. OAuth autentica la conexión entre la cuenta de la Control Room y de Microsoft 365.
- Chat
- Use esta opción para configurar el activador según los chats individuales. El nombre del chat funciona en base al correo electrónico del destinatario del chat y no al nombre de visualización del destinatario.
- Detectar el evento: Especifique el tipo de evento que el activador debe detectar.
- Nombre del chat: Ingrese el nombre del chat. También puede usar el botón Obtener nombres de chat para seleccionar un chat usando el modal Chat.
- Filtro: Habilite la casilla de verificación e ingrese las palabras clave para filtrar los mensajes.
- Equipos y canal
-
Chat del equipo: Utilice la opción Chat del equipo para configurar el activador según los mensajes publicados en un canal de Teams. Las siguientes configuraciones están disponibles para esta opción:
- Elija uno o varios eventos: Especifique uno o más tipos de eventos que el activador debe detectar.
- Nombre del equipo: Ingrese el nombre del equipo. También puede usar el botón Seleccionar nombre de equipo para seleccionar el equipo usando el modal Equipos.
- Nombre del canal: Introduzca el nombre del canal. También puede usar la opción Seleccionar nombre de canal para seleccionar el equipo usando el modal Canales.
- Filtro: Habilite la casilla de verificación e ingrese las palabras clave para filtrar los mensajes.
-
Miembros del equipo: Utilice la opción Miembros del equipo para configurar el activador según los cambios de miembros dentro de un equipo. Las siguientes configuraciones están disponibles para esta opción:
- Opciones de miembros: Especifique uno o más tipos de eventos que el activador debe detectar.
- Nombre del equipo: Ingrese el nombre del equipo. También puede usar el botón Seleccionar nombre de equipo para seleccionar el equipo usando el modal Equipos.
- Certificado
- Use la opción Certificado para seleccionar el certificado de autenticación y cifrado.
- Credencial: Use la opción Elegir y siga las indicaciones del modal Seleccionar una credencial para seleccionar el certificado Microsoft Azure guardado en la Credential Vault.
- String insegura: Utilice la opción String insegura para ingresar el contenido del archivo de certificado directamente en el campo de entrada.
- Respuesta
- Use la opción Respuesta para guardar los datos de respuesta del activador en una variable de Registro. Puede crear una nueva variable o seleccionar una variable existente para almacenar estos datos de respuesta.
Lectura de datos de respuesta del activador en Registro de auditoría
Los datos de respuesta del activador contienen toda la información del registro del evento en el que ocurrió un cambio. Estos datos de respuesta se almacenan en formato de pares clave-valor. Puede extraer estos datos y utilizarlos como entradas para otras acciones dentro de la automatización. Una vez que el bot termina de ejecutarse, la información de los datos del activador se registra como tipo de evento Bot ejecutado por un activador en el registro de auditoría.