如何在 Microsoft Teams 中使用 App Connect

支持的产品和应用程序接口版本

要了解该连接器支持哪些产品和 API 版本，请参阅 IBM 支持页面上的详细系统要求。

连接到 Microsoft Teams

• 如果您还没有 Microsoft Teams 账户，可以免费注册： Microsoft Teams。

要将 App Connect 连接到 Microsoft Teams 账户，请参阅 《从 App Connect 连接到 Microsoft Teams 》。

在 App Connect 中使用 Microsoft Teams 的通用注意事项

• (一般考虑）您可以在 App Connect Designer 的应用程序和 API 页面上查看可用的触发事件和操作列表。

  对于某些应用，事件和操作取决于环境以及连接器是否支持可配置事件和动态发现操作。 如果应用程序支持可配置事件，您会在事件列表下看到“ 显示更多可配置事件” 链接。 如果应用程序支持动态发现操作，您会在操作列表下看到 “显示更多” 链接。

• (一般注意事项）如果某个应用程序使用多个账户，不同账户在为该应用程序选择操作时显示的字段集可能不同。 在流程编辑器中，某些应用程序总是为某个操作提供一组经过编辑的静态字段。 其他应用程序使用动态发现功能来检索所连接实例上配置的字段集。 例如，如果一个应用程序的两个实例有两个账户，第一个账户可能会使用可立即使用的设置。 不过，第二个账户可能配置了额外的自定义字段。
• Microsoft Azure Active Directory 组通常在 Microsoft 365 管理中心或 Microsoft Azure 门户中创建。 如果拥有所需的权限，可以在 App Connect 中使用 "创建组 "操作来创建 Microsoft 365 组或安全组。
• 如果您使用非管理员用户帐户连接到 Microsoft Teams ，则只有当您是该群组的所有者时，才能使用 App Connect 来更新或删除群组。
• 当您在 App Connect 中使用" 创建聊天消息 "或 "检索聊天消息 "操作来创建或检索聊天消息时，必须先从列表中选择一个现有的聊天。
  
  • 对于在 Microsoft Teams 的“收件人 ”字段中指定了用户名的用户，其一对一聊天的聊天 ID 将在 19:50144721-4f5b-4765-9b65-fd554a36c65c_8372f761-5d10-4888-ef47-5be0b7315e72@unq.gbl.spacesApp Connect 的“聊天 ”列表中以 格式显示。
  • 对于群聊（在 Microsoft Teams 中 ，群组名称字段包含对话主题， 而“收件人 ”字段包含多个用户名）， 群组名称 （主题）的值会显示在 App Connect 的聊天列表中，从而便于识别该聊天。

  如果您打算频繁使用 “创建聊天消息 ”或 “检索聊天消息 ”操作，建议您在 Microsoft Teams 中为聊天设置一个“组名 （主题）”值。

• 当您在 App Connect 中使用" 创建消息回复 "或 "检索消息回复 "操作来创建或检索消息回复时，必须先选择回复所属的团队、频道和消息。 在 “消息列表”中，带有主题的消息会显示其主题值，而没有主题的消息则会显示由 Microsoft Teams 生成的 ID 值。
  

  如有需要，您可以在 Microsoft Teams 中查看某条消息对应的 ID：打开该消息的 “更多选项 ”菜单（... ），然后点击“复制链接 ”。 链接中包含信息 ID，例如

  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

  

  如果您打算频繁使用 “创建消息回复 ”或 “检索消息回复 ”操作，建议在 Microsoft Teams 中创建带有主题的消息回复。

  
• 当您使用创建聊天消息、 创建消息或创建消息回复操作在 App Connect 中创建消息或回复时，您可以通过指定内容类型和关联内容向消息添加附件。 目前只支持丰富的卡片附件。 您可以使用内容类型字段选择卡片格式，然后使用内容字段指定定义卡片 JSON 格式的富卡片对象。 支持的卡附件如下。

  内容类型	描述	内容
  application/vnd.microsoft.card.adaptive	自适应卡片可包含文本、语音、图像、按钮和输入框。	指定 AdaptiveCard 对象。
  application/vnd.microsoft.card.hero	英雄卡可以包含一张大图片、一个或多个按钮以及一些文字。	指定 HeroCard 对象。
  application/vnd.microsoft.card.thumbnail	缩略图卡，可包含一张缩略图、一个或多个按钮以及一些文字。	指定 ThumbnailCard 对象。
  application/vnd.microsoft.com.card.receipt	提供收据的收据卡。	指定 ReceiptCard 对象。 限制： 此卡目前只能提供部分输出。
  application/vnd.microsoft.com.card.signin	要求用户登录的登录卡。	指定 SignInCard 对象。

  有关这些卡片附件的更多信息，请参阅 Microsoft 文档中的 《卡片参考》。

  以下示例提供了每种内容类型的 JSON 示例。

  自适应卡：

  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"
  }

  英雄卡

  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"
         }
       ]
     }

  缩略图卡：

  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!"
      }
    }

  收据卡（部分）：

  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"
            }
          ]
        }

  登录卡：

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

岗位连接注意事项

连接到 Microsoft Teams 后，请注意以下事项：

下载通话录音和通话转录内容的前提条件

要使用 “下载通话录音内容 ”和 “下载通话文字记录内容 ”操作，您必须将会议安排为 Microsoft Teams 日历事件。 若要以“ Microsoft Teams ”日历事件的形式安排会议，在 “创建事件 ”操作中，您需要将 “是否为在线会议 ” True设置为。

事件和行动

Microsoft Teams 活动

这些事件用于处理本应用程序中的更改，这些更改会触发流程开始完成流程中的操作。

您的流程将在此应用程序上完成这些操作。