管理 Microsoft 365 连接器和自定义连接器

Microsoft Teams 中的连接器将内容和服务更新直接从第三方服务传送到 Teams 频道。 通过使用连接器,用户可以从 Azure DevOps Services、Trello、奇妙清单、GitHub 等常用服务接收更新。 连接器将这些更新直接发布到聊天流中。 此功能使所有团队成员都可以轻松地保持同步并快速接收相关信息。

Teams 和 Microsoft 365 个组使用连接器。 可以在 Teams 和 Microsoft Exchange 中使用相同的连接器。

如果团队权限允许,任何团队成员都可以将连接器添加到频道。 连接器从服务中提取信息的更新会通知所有团队成员。 具有添加或删除权限的任何团队成员都可以修改其他成员完成的连接器设置。

重要

开发人员无法在连接器 开发人员门户上注册新连接器。

更新连接器 URL

Teams 连接器正在转换为新的 URL 以增强安全性。 在此转换期间,你可能会收到通知,要求更新配置的连接器以使用新 URL。 强烈建议立即更新连接器,以防止连接器服务中断。

只有基于 Webhook 的连接器(如传入 Webhook 和第三方连接器)才需要此更改。 轮询连接器(如 RSS)不需要更改。 必须更新连接器的 URL,才能在 2024 年 12 月 31 日之后继续向 Teams 发布通知。

提示

建议记下更新的 URL。 更新后,无法再查看以前的 URL。 旧 URL 可用于查找和标识仍在使用它的系统,必须使用新 URL 进行更新。

若要更新 URL,请执行以下步骤:

  1. 转到 “管理 Teams 频道中的频道 ”,在“连接器”选项下选择 “编辑 ”,然后选择“ 配置 ”部分。 检查此页上的现有连接器连接。

    显示 Teams 中的“管理频道”选项的屏幕截图。

    显示团队中现有连接器连接的已配置部分的屏幕截图。

  2. 仅更新“管理”选项下显示的Attention required那些连接。

    显示 Teams 频道中需要注意的已配置连接的屏幕截图。

  3. 执行下列操作之一:

    • 对于包含 Webhook URL 的连接器,请选择“管理和更新 URL”。

      显示用于更新 Webhook URL 的选项的屏幕截图。

    • 对于其他类型的连接器,请删除连接器并重新创建连接器配置。

  4. 在发布到旧 URL 的系统中使用更新的 URL 或新连接。 “配置”页显示 URL 已更新。

    显示 URL 更新后确认的屏幕截图。

若要了解详细信息或与应用开发人员共享更多信息,请参阅 连接器弃用信息

在 Teams 中启用或禁用连接器

Exchange Online PowerShell v2 模块使用新式身份验证,并与多重身份验证 (MFA) 配合使用,以连接到 Microsoft 365 中的所有与 Exchange 相关的 PowerShell 环境。 管理员可以使用 Exchange Online PowerShell 来禁用整个组织或特定组邮箱的连接器。 如果禁用连接器,它将影响该组织或邮箱中的所有用户。 无法为少数特定用户禁用连接器。

组织设置将替代组设置。 例如,如果管理员为组启用连接器,并为组织禁用相同的连接器,则会为组禁用连接器。 要在 Teams 中启用连接器,请使用新式身份验证(无论是否使用 MFA)连接到 Exchange Online PowerShell

若要启用或禁用连接器,请在 Microsoft Exchange Online PowerShell 中执行以下命令:

  1. 以管理员身份打开 PowerShell。

  2. 使用 命令 Import-Module ExchangeOnlineManagement 导入 Microsoft Exchange 模块。

  3. 若要在组织中禁用连接器,请使用 命令 Set-OrganizationConfig -ConnectorsEnabled:$false

  4. 若要连接管理员帐户,请使用 命令 Connect-ExchangeOnline -UserPrincipalName UPN -ExchangeEnvironmentName O365USGovGCCHigh。 将 替换为 UPN 你的用户主体名称。

  5. 若要为 Teams 启用连接器,请使用以下命令。 若要禁用连接器或可操作消息,请在以下命令中将值设置为 false 而不是 true

    • Set-OrganizationConfig -ConnectorsEnabled:$true
    • Set-OrganizationConfig -ConnectorsEnabledForTeams:$true
    • Set-OrganizationConfig -ConnectorsActionableMessagesEnabled:$true

有关 PowerShell 模块交换的详细信息,请参阅 Set-OrganizationConfig。 要启用或禁用 Microsoft Outlook 连接器,将应用连接到 Outlook 中的组。 若要详细了解 UPN) (用户主体名称,请参阅 Microsoft 365 中的 UPN

注意

传播这些更改最多需要 24 小时。

为组织发布连接器

若要使自定义连接器可供组织的用户使用,请将自定义连接器应用上传到组织的应用目录。 组织中的用户可以在团队中安装、配置和使用连接器。

重要

自定义连接器在政府社区云 (GCC)、政府社区云-High (GCCH) 和国防部 (DOD) 环境中不可用。

若要在团队或频道中使用连接器,请从频道右上角打开“更多选项”菜单。 从菜单中选择“连接器 ”,然后找到或搜索所需的连接器。 如有必要,请配置所选连接器。

显示从频道右上角的“更多”选项向 Teams 中的频道添加连接器的屏幕截图。

在 GCC 或 GCCH 中使用连接器

默认情况下,在政府云社区 (GCC) 和政府社区 Cloud-High (GCCH) 环境中禁用连接器。 若要让用户在 GCC 或 GCCH 环境中使用连接器,请执行以下步骤:

  1. 必须在 Teams 中启用连接器

  2. 若要设置参数,请连接到 powerShell Exchange Online

  3. 若要在 Teams 中使用传入 Webhook,请使用以下 manifest.json创建自定义应用。 若要在自定义应用中使用图标,请遵循 创建应用图标的准则

    {
      "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
      "manifestVersion": "1.5",
      "id": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
      "version": "1.0.0",
      "packageName": "com.incomingwebhook.microsoft",
      "developer": {
        "name": "Microsoft Corporation",
        "websiteUrl": "https://go.microsoft.com/fwlink/?linkid=837668",
        "privacyUrl": "https://privacy.microsoft.com/privacystatement",
        "termsOfUseUrl": "https://www.microsoft.com/servicesagreement"
      },
      "description": {
        "full": "The Incoming Webhook connector enables external services to notify you about activities that you want to track.",
        "short": "Send data from a service to your Microsoft 365 group in real time. "
      },
      "icons": {
        "outline": "outline.png",
        "color": "color.png"
      },
      "connectors": [
        {
          "connectorId": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
          "scopes": ["team"]
        }
      ],
      "name": {
        "full": "Incoming Webhook",
        "short": "Incoming Webhook"
      },
      "accentColor": "#FFFFFF",
      "permissions": ["identity", "messageTeamMembers"]
    }
    
  4. 在 Teams 管理中心上传自定义应用

在 Teams 中使用连接器时的注意事项

  • 默认情况下,在政府云社区 (GCC) 环境和政府社区 Cloud-High (GCCH) 中禁用连接器。 若要启用连接器,请使用 ConnectorsEnabled cmdlet 将 或 ConnectorsEnabledForTeams 参数$trueSetOrganizationConfig设置为 。 若要设置参数,请连接到 powerShell Exchange Online

  • 如果向团队添加连接器的用户离开团队,连接器将继续工作。

  • 无法为以下连接器配置新连接:

    • 啊哈!
    • Airbrake
    • Aircall
    • 应用链接
    • AppSignal
    • 青苗
    • Bitbucket
    • 伙伴
    • Buildkite
    • 查特拉
    • CircleCI
    • CodeShip
    • 常量接触
    • GetResponse
    • 幽灵检查器
    • Heroku
    • Honeybadger
    • 对讲机
    • Logentries
    • Mailchimp
    • Microsoft Forms
    • Opsgenie
    • PagerDuty
    • Papertrail
    • Pivotal Tracker
    • Raygun
    • Runscope
    • SatisMeter
    • 信号
    • 哨兵
    • 简单传入/输出
    • Stack Exchange
    • 颠覆
    • TestFairy
    • Travis CI
    • Trello
    • 向上向下
    • Userlike
    • Wrike
    • XP-Dev
    • Zendesk