Cómo utilizar App Connect con Microsoft Teams

Versiones de productos y API compatibles

Para saber qué versiones de producto y API admite este conector, consulte Requisitos detallados del sistema en la página de asistencia IBM.

Conectarse a Microsoft Teams

• Si no tienes una cuenta de Microsoft Teams, puedes registrarte gratis en Microsoft Teams.

Para vincular App Connect a una cuenta de Microsoft Teams, consulta «Conectarse a Microsoft Teams desde App Connect ».

Consideraciones generales sobre el uso de Microsoft Teams en App Connect

• (Consideración general) Puede ver listas de los eventos y acciones desencadenantes que están disponibles en la página Aplicaciones y API del Diseñador de App Connect.

  Para algunas aplicaciones, los eventos y acciones dependen del entorno y de si el conector admite eventos configurables y descubrimiento dinámico de acciones. Si la aplicación admite eventos configurables, verá un enlace Mostrar más eventos configurables bajo la lista de eventos. Si la aplicación admite la detección dinámica de acciones, verá un enlace Mostrar más debajo de la lista de acciones.

• (Consideración general) Si utiliza varias cuentas para una aplicación, el conjunto de campos que se muestra al seleccionar una acción para esa aplicación puede variar para las distintas cuentas. En el editor de flujo, algunas aplicaciones siempre proporcionan un conjunto curado de campos estáticos para una acción. Otras aplicaciones utilizan la detección dinámica para recuperar el conjunto de campos configurados en la instancia a la que está conectado. Por ejemplo, si tiene dos cuentas para dos instancias de una aplicación, la primera cuenta podría utilizar configuraciones listas para su uso inmediato. Sin embargo, la segunda cuenta puede estar configurada con campos personalizados adicionales.
• Microsoft Azure Active Directory los grupos suelen crearse en el centro de administración Microsoft 365 o en el portal Microsoft Azure. Si dispone de los permisos necesarios, puede utilizar la acción "Crear grupo" en App Connect para crear grupos Microsoft 365 o grupos de seguridad.
• Si utilizas una cuenta de usuario sin privilegios de administrador para conectarte a Microsoft Teams, solo podrás utilizar App Connect para actualizar o eliminar grupos si eres el propietario de dicho grupo.
• Cuando utilice la acción Crear mensaje de chat o Recuperar mensajes de chat para crear o recuperar mensajes de chat en App Connect, primero debe seleccionar un chat existente de la lista.
  
  • En el caso de los chats privados con otro usuario cuyo nombre se indica en el campo «Para» de Microsoft Teams, el ID del chat aparece en la lista de chats de 19:50144721-4f5b-4765-9b65-fd554a36c65c_8372f761-5d10-4888-ef47-5be0b7315e72@unq.gbl.spacesApp Connect con el formato.
  • En el caso de los chats grupales (en los que el asunto de la conversación aparece en el campo «Nombre del grupo » y hay varios nombres de usuario en el campo «Para» de Microsoft Teams ), el valor del «Nombre del grupo» (asunto) se muestra en la lista de chats de App Connect, lo que permite identificar fácilmente el chat.

  Si tiene intención de utilizar con frecuencia las acciones «Crear mensaje de chat» o «Recuperar mensajes de chat», considere la posibilidad de crear sus chats con un valor de «Nombre del grupo» (asunto) en Microsoft Teams.

• Cuando utilice la acción Crear respuesta a mensaje o Recuperar respuestas a mensajes para crear o recuperar respuestas a mensajes en App Connect, primero debe seleccionar un equipo, un canal y un mensaje para la respuesta. En la lista de mensajes, los mensajes que se crearon con un asunto muestran dicho asunto, mientras que los mensajes sin asunto muestran un identificador generado por Microsoft Teams.
  

  Si es necesario, puedes comprobar qué ID se ha asignado a un mensaje en Microsoft Teams abriendo el menú «Más opciones » (... ) de un mensaje y haciendo clic en «Copiar enlace ». El ID del mensaje se incluye en el enlace; por ejemplo:

  https://teams.microsoft.com/l/message/19:a954b78415a547a7438c354c54b40f30@thread.tacv2/1595593605014?tenantId=0184ab77-1234-4ac0-5678-bf7eec6de925&groupId=e1c2515c-4512-471e-a772-60ce5ba78921&parentMessageId=1595593605014&teamName=FDteam&channelName=General&createdTime=1595593605014

  

  Si tiene intención de utilizar con frecuencia las acciones «Crear respuesta a un mensaje» o «Recuperar respuestas a mensajes», considere la posibilidad de crear respuestas a mensajes con un asunto en Microsoft Teams.

  
• Cuando se utiliza la acción Crear mensaje de chat, Crear mensaje o Crear respuesta a mensaje para crear un mensaje o una respuesta en App Connect, se puede añadir un archivo adjunto al mensaje especificando un tipo de contenido y el contenido asociado. Actualmente, sólo se admiten archivos adjuntos de tarjetas enriquecidas. Puede utilizar el campo Tipo de contenido para seleccionar un formato de tarjeta y, a continuación, utilizar el campo Contenido para especificar un objeto de tarjeta enriquecido que defina el formato JSON de la tarjeta. Los accesorios para tarjetas compatibles son los siguientes.

  Tipo de contenido	Descripción	Contenido
  application/vnd.microsoft.card.adaptive	Una tarjeta Adaptable que puede contener texto, voz, imágenes, botones y campos de entrada.	Especifique un objeto AdaptiveCard.
  application/vnd.microsoft.card.hero	Una tarjeta Hero que puede contener una imagen grande, uno o más botones y algo de texto.	Especifique un objeto HeroCard.
  application/vnd.microsoft.card.thumbnail	Una tarjeta de miniatura que puede contener una imagen en miniatura, uno o más botones y algo de texto.	Especifique un objeto ThumbnailCard.
  application/vnd.microsoft.com.card.receipt	Una tarjeta que proporciona un recibo.	Especifique un objeto ReceiptCard. Restricción: Esta tarjeta actualmente da salida parcial.
  application/vnd.microsoft.com.card.signin	Una tarjeta de inicio de sesión que solicita a un usuario que inicie sesión.	Especifique un objeto SignInCard.

  Para obtener más información sobre estos archivos adjuntos de tarjetas, consulte Referencia de tarjetas en la documentación de Microsoft.

  Los siguientes ejemplos proporcionan muestras de JSON para cada tipo de contenido.

  Tarjeta adaptable:

  json
  
  {
      "type": "AdaptiveCard",
      "body": [
          {
              "type": "TextBlock",
              "size": "Medium",
              "weight": "Bolder",
              "text": "Profile Info"
          },
          {
              "type": "FactSet",
              "facts": [
                  {
                      "title": "Given name",
                      "value": "John"
                  },
                  {
                      "title": "Surname",
                      "value": "Doe"
                  },
                  {
                      "title": "Job title",
                      "value": "Software Dev"
                  },
                  {
                      "title": "Office location",
                      "value": "NYC"
                  },
                  {
                      "title": "Email",
                      "value": "john@doe.com"
                  }
              ]
          },
          {
              "type": "TextBlock",
              "text": "Business phones",
              "weight": "Bolder"
          },
          {
              "type": "TextBlock",
              "text": "{$data}",
              "$data": "{businessPhones}",
              "spacing": "None"
          }
      ],
      "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
      "version": "1.0"
  }

  Carta de héroe:

  json
  {
       "title": "Seattle Center Monorail",
       "subtitle": "Seattle Center Monorail",
       "text": "The Seattle Center Monorail is an elevated train line between Seattle Center (near the Space Needle) and downtown Seattle. It was built for the 1962 World's Fair. Its original two trains, completed in 1961, are still in service.",
       "images": [
         {
           "url":"https://upload.wikimedia.org/wikipedia/commons/thumb/4/49/Seattle_monorail01_2008-02-25.jpg/1024px-Seattle_monorail01_2008-02-25.jpg"
         }
       ],
      "buttons": [
        {
           "type": "openUrl",
           "title": "Official website",
           "value": "https://www.seattlemonorail.com"
         },
        {
          "type": "openUrl",
          "title": "Wikipeda page",
          "value": "https://en.wikipedia.org/wiki/Seattle_Center_Monorail"
         }
       ]
     }

  Tarjeta miniatura:

  json
  {
      "title": "Bender",
      "subtitle": "tale of a robot who dared to love",
      "text": "Bender Bending Rodríguez is a main character in the animated television series Futurama. He was created by series creators Matt Groening and David X. Cohen, and is voiced by John DiMaggio",
      "images": [
        {
          "url": "https://upload.wikimedia.org/wikipedia/en/a/a6/Bender_Rodriguez.png",
          "alt": "Bender Rodríguez"
        }
      ],
      "buttons": [
        {
          "type": "imBack",
          "title": "Thumbs Up",
          "image": "http://moopz.com/assets_c/2012/06/emoji-thumbs-up-150-thumb-autox125-140616.jpg",
          "value": "I like it"
        },
        {
          "type": "imBack",
          "title": "Thumbs Down",
          "image": "http://yourfaceisstupid.com/wp-content/uploads/2014/08/thumbs-down.png",
          "value": "I don't like it"
        },
        {
          "type": "openUrl",
          "title": "I feel lucky",
          "image": "http://thumb9.shutterstock.com/photos/thumb_large/683806/148441982.jpg",
          "value": "https://www.bing.com/images/search?q=bender&qpvt=bender&qpvt=bender&qpvt=bender&FORM=IGRE"
        }
      ],
      "tap": {
        "type": "imBack",
        "value": "Tapped it!"
      }
    }

  Tarjeta de recibo (parcial):

  json
  {
          "title": "I'm a receipt card",
          "items": [
            {
              "title": "Sushi",
              "subtitle": "2 piece",
              "image": {
                "url": "https://mydeploy.azurewebsites.net/sushi.png"
              },
              "price": "16.25",
              "quantity": "1"
            },
            {
              "title": "Tenpura",
              "subtitle": "1 dish",
              "image": {
                "url": "https://mydeploy.azurewebsites.net/tenpura.jpg"
              },
              "price": "34.50",
              "quantity": "2"
            }
          ],
          "total": "275.25",
          "tax": "27.52",
          "buttons": [
            {
              "type": "openUrl",
              "title": "Go to my site",
              "value": "https://blogs.msdn.microsoft.com/tsmatsuz"
            }
          ]
        }

  Tarjeta de acceso:

  json
  {
      "buttons": [
          {
              "title": "Log In",
              "type": "openUrl",
              "value": "https://login.microsoftonline.com"
          }
      ],
      "text": "Sign in to our app"
  }

Consideraciones posteriores a la conexión

Ten en cuenta lo siguiente una vez que te hayas conectado a Microsoft Teams :

Requisitos previos para descargar contenidos de grabación y transcripción de llamadas

Para utilizar las acciones «Descargar el contenido de la grabación de la llamada» y «Descargar el contenido de la transcripción de la llamada », debe programar la reunión como un evento de calendario de « Microsoft Teams ». Para programar la reunión como un evento del calendario de Microsoft Teams, en la acción «Crear evento », debes establecer la opción «¿Es una reunión en línea? » True en.

Eventos y acciones

Microsoft Teams eventos

Estos eventos son para cambios en esta aplicación que desencadenan un flujo para empezar a completar las acciones en el flujo.

Su flujo completa estas acciones en esta aplicación.