Ejemplo de uso del package Microsoft Teams

En este ejemplo, creará una automatización para enviar una alerta de incidente P1 a un canal específico de Microsoft Teams, notificar directamente al ingeniero de soporte de guardia por chat y registrar la conversación del canal para los registros del incidente.

Procedimiento

  1. Cree una automatización.
    1. En el panel izquierdo, haga clic en Automatización.

      Se muestra la lista de formularios y bots disponibles.

    2. Haga clic en Crear un bot.
    3. Escriba el nombre del bot: MSTeams_demo.
    4. Haga clic en Crear y editar.
  2. Conéctese a Microsoft Teams para establecer una sesión para autenticar y ejecutar todas las acciones posteriores de Teams.
    1. Haga doble clic o arrastre la action Microsoft Teams > Conectar.
    2. En el campo Conexión OAuth2, ingrese MSTeam.
    3. En el campo Nombre de usuario, ingrese office365_dev@automationanywhere.store
    4. Seleccione Predeterminada Sesión local.
  3. Recupere el ID del equipo específico.
    1. Haga doble clic o arrastre la action Microsoft Teams > Obtener equipo por nombre.
    2. En el campo Nombre de sesión, use la misma sesión que utilizó para conectarse a Microsoft Teams, es decir, Default.
    3. En el campo Nombre del equipo, introduzca Support Ops.
      Nota: El equipo de Soporte de Operaciones debe existir en la aplicación Microsoft Teams.
    4. En el campo Asignar el ID de equipo a la variable, introduzca $TeamID$
  4. Recupere el ID de canal único de un canal específico dentro del equipo Support Ops.
    1. Haga doble clic o arrastre la action Microsoft Teams > Obtener canal por nombre.
    2. En el campo Nombre de sesión, use la misma sesión que utilizó para conectarse a Microsoft Teams, es decir, Default.
    3. En el campo ID de equipo, introduzca $TeamID$.
    4. En el campo Nombre del canal, ingrese Gestión de incidentes.
      Nota: Este canal debe existir en la aplicación Microsoft Teams.
    5. En el campo Asignar ID de canal a una variable, cree una nueva variable llamada $ChannelID$.
  5. Publique la alerta en el canal de gestión de incidentes.
    Nota: La suposición aquí es que la aplicación externa está activando esta automatización para enviar el mensaje de alerta al canal Gestión de incidentes.
    1. Haga doble clic o arrastre la action Microsoft Teams > Enviar mensaje al canal.
    2. En el campo ID de equipo ingrese $TeamID$
    3. En el campo ID de canal, ingrese $ChannelID$
    4. En el campo Mensaje introduzca el siguiente mensaje:

      ID de incidente: INC-2025-08-13-045

      Gravedad: P1: grave para la empresa

      Detectado el: 13-ago-2025 02:48 p. m. IST

      Descripción: La API de procesamiento de pedidos está devolviendo 500 errores. No se están procesando todas las nuevas órdenes.

      Impacto: Los clientes de comercio electrónico no pueden completar transacciones.

      Próximos pasos: El ingeniero de guardia investiga los registros de la API y el estado de la base de datos de inmediato.

    5. En el campo Asignar ID de mensaje a variable, cree una nueva variable llamada, $MessageId$ para almacenar el ID del mensaje de alerta.
  6. Recupere detalles del usuario de Soporte Técnico.
    1. Haga doble clic o arrastre la action Microsoft Teams > Obtener detalles del usuario .
    2. En el campo Nombre de sesión, seleccione la misma sesión que utilizó para conectarse a Microsoft Teams, es decir, Predeterminada.
    3. En el campo Nombre de usuario, cree una nueva variable para almacenar la dirección de correo electrónico del usuario para recuperar sus detalles. Variable creada: $email$ (por ejemplo, tony.dean@office.store)
    4. En el campo Asignar los detalles del usuario a una variable, seleccione la opción Diccionario. Ingrese $user_dict$ para almacenar los datos del usuario.
  7. Notifique al ingeniero por chat directo.
    1. Haga doble clic o arrastre la action Microsoft Teams > Enviar mensaje de chat.
    2. En el campo Nombre de sesión, seleccione la misma sesión que utilizó para conectarse a Microsoft Teams, es decir, Predeterminada.
    3. En el campo Enviar mensaje a > Correo electrónico, especifique $user_dict{email}$
    4. En el campo Mensaje, introduzca el siguiente mensaje:

      Hola $user_dict{displayName}$,

      Se ha detectado un incidente grave P1: Fallo en la API de procesamiento de pedidos. ID de incidente: INC-2025-08-13-045 Detectado: 13-ago-2025 02:48 p. m. IST Impacto: Todas las nuevas órdenes están fallando.

      Únase al Puente de Incidentes de inmediato: Enlace de reunión de Teams Ticket: Enlace de ServiceNow

      Alerta automatizada de A360 MS Teams Bot.

    5. En el campo Asignar el ID de mensaje a una variable, cree una nueva variable llamada $user_msgid$.
  8. Confirme que el mensaje se envió al ingeniero.
    1. Haga doble clic o arrastre la action Microsoft Teams > Cuadro de mensaje.
    2. En el campo Escriba el mensaje que desea mostrar, introduzca Mensaje enviado al ingeniero de soporte.
  9. Recupere y registre el historial de chat del Canal.
    1. Haga doble clic o arrastre la action Bucle.
    2. En el campo desplegable del iterador Bucle, seleccione el iterador Microsoft Teams > Para cada mensaje en un canal.
    3. En el campo Nombre de sesión, use la misma sesión que utilizó para conectarse a Microsoft Teams, es decir, Default.
    4. En el campo ID de equipo ingrese $TeamID$
    5. En el campo ID de canal, ingrese $ChannelID$
    6. En el campo Fecha de inicio, cree una nueva variable llamada $start_dt$ con el valor 13/8/2025 03:00 p. m. IST (UTC+5.30) Calcuta Asia
    7. En el campo Fecha de finalización, cree una nueva variable llamada $end_dt$ con el valor 14/8/2025 12:00 a. m. IST (UTC+5.30) Calcuta Asia
    8. En el campo Asignar detalles del mensaje a variable, cree una variable llamada $ChannelMessageDetails$ para almacenar los mensajes del canal.
  10. Extraiga los detalles del mensaje dentro de la acción Bucle.
    Nota: Solo se recuperan los mensajes de grupo y no los hilos individuales.

    Haga doble clic o arrastre la action Diccionario > Obtener para cada clave para recuperar su valor de $ChannelMessageDetails$:
    Clave Variable
    $ChannelMessageDetails (msg_id)$ $msg_id$
    $ChannelMessageDetails (msg)$ $msg$
    $ChannelMessageDetails (sentByUserID)$ $sentByUserID$
    $ChannelMessageDetails (sentByUsername)$ $sentByUsername$
    $ChannelMessageDetails (createdDateTime)$ $createdDateTime$
    $ChannelMessageDetails (modifiedDateTime)$ $modifiedDateTime$
  11. Registre los detalles del mensaje del canal en el archivo de registro de incidentes dentro del bucle acción.
    • Haga doble clic o arrastre la action Registro > Registrar variables en el archivo.
    • En el campo Ruta del archivo de salida, ingrese C:\output\Incident Log File.txt
    • En la opción Al registrar, seleccione Agregar a un archivo de registro existente.
    • Seleccione la opción Selección personalizada para identificar las variables que se registrarán. Seleccione la siguiente variable:
      • $createdDateTime$
      • $modifiedDateTime$
      • $msg$
      • $msg_id$
      • $sentByUserID$
      • $sentByUserName$
  12. Desconectarse de Microsoft Teams.
    1. Haga doble clic o arrastre la action Microsoft Teams > Desconectar.
    2. En el campo Nombre de sesión, seleccione la misma sesión que utilizó para conectarse a Microsoft Teams, es decir, Predeterminada.
  13. Use la action Archivo > Abrir para abrir el archivo de registro de incidentes. La siguiente información se mostrará en el archivo .txt.
    Clave Valor
    msg_id p. ej., 1692210012345
    msg

    Alerta de incidente grave: se requiere acción

    ID de incidente: INC-2025-08-13-045

    Gravedad: P1: grave para la empresa

    Detectado el: 13-ago-2025 02:48 p. m. IST

    Descripción: La API de procesamiento de pedidos está devolviendo 500 errores. No se están procesando

    todos los pedidos nuevos.

    Impacto: Los clientes de comercio electrónico no pueden completar transacciones.

    Próximos pasos: El ingeniero de guardia investiga los registros de API y el estado de la base de datos

    de inmediato.

    sentbyuserid p. ej., a-user-guid
    createddatetime 2025-08-13T14:50:12Z
    modifieddatetime 2025-08-13T14:50:12Z
    sentbyusername p. ej., tony.dean@office.store