通过

使用 Office 连接器开发人员仪表板注册连接器

  • 项目

重要

Teams 中的Office 365连接器即将停用。 工作流应用提供类似的功能，具有更高的可伸缩性和安全性。 有关详细信息，请参阅停用 Microsoft Teams 中的Office 365连接器。 连接器开发人员门户中的新连接器注册处于禁用状态。

为应用程序构建 Office 连接器非常简单。 只需在开发人员门户中注册连接器，向应用程序添加集成配置体验，并实现连接器。 可以通过发布到目录使客户更容易发现连接器。

构建你自己的连接器

注册连接器

访问 连接器开发人员门户 并使用 Microsoft 365 凭据登录。 如果没有 Microsoft 365 租户，则可以通过 Microsoft 365 开发人员计划获得租户;有关详细信息，请参阅 常见问题解答。 或者，可以 注册 1 个月的免费试用版或购买 Microsoft 365 计划。

选择“新建连接器”并填写窗体。 选择“保存”后，页面上会出现新选项。

  • 通过“旁加载到 Outlook”按钮，可将连接器暂时添加到已登录用户的 Outlook 体验。 该用户将能够在收件箱或其所属的任何组中配置该连接器。
  • 通过单击“发布到应用商店”按钮，可开始发布过程，包括列入应用商店前的 Microsoft 审核。

添加集成配置体验

通过集成配置体验，用户无需离开 Outlook 即可配置你的连接器。 你的应用程序会将该配置以一个网页的形式呈现，该网页会利用 Microsoft Teams JavaScript 库将配置状态传回 Outlook。

有关详细信息，请参阅集成配置体验。

注意

集成配置体验一文是一篇专门面向 Microsoft Teams 的文档，但其中所述的方法同样适用于 Outlook。

特定于 Outlook 的配置要求

如果你的配置体验需要身份验证，则需要满足其他要求才能在 Windows 版的 Outlook 中完成身份验证流程。

Windows 版 Outlook 会将一个额外的查询参数传递到连接器身份验证起始页。

callbackUrl=<connectors url>

你的应用程序必须保留此值，并在身份验证完成后将其作为附加参数传递至 microsoftTeams.authentication.notifySuccess 或 microsoftTeams.authentication.notifyFailure 方法。

microsoftTeams.authentication.notifySuccess(result, callbackUrl);

将连接器发布到应用商店

全面测试连接器并准备好在 Office 连接器目录中列出后，可以使用 “发布到存储” 按钮提交它以供审阅。 经审查批准后，连接器将被添加到连接器目录。

连接器提交清单

  • 在将连接器提交到 Microsoft Store 前，先确保连接器功能齐全且已经过全面测试。
  • 在各种客户端中测试连接器卡（用户会在这些客户端中使用连接器卡）：Outlook 网页版、Outlook 2016 或更高版本和 Outlook Groups 移动应用。
  • 请确保 Markdown 严格用于文本修饰并且不发送连接器卡有效负载中的 HTML。
  • 添加值时请避免生成过多噪音。 请确保用户不会因为通知过多而陷入困境。
  • 标识发送连接器卡所面向的正确事件。 请确保发送给组的信息对组成员有价值。
  • 在发送报表或摘要时，请使用简要格式，并允许用户选择报表的发送时间和频率。
  • 发送连接器卡时，请充分利用 Markdown 以突出显示卡的重要部分。
  • 通过提供相关操作应尽可能使连接器卡可操作。
  • 所调用操作的故障率应非常低，并且终结点应能够快速响应。
  • 请确保为用户提供暂停或删除配置的设置。
  • 对于连接器提供的功能有面向用户的清晰文档。
  • 在注册连接器时：
    • 请确保连接器的名称和徽标不侵犯任何其他产品或服务的商标或版权。
    • 提供 jpg、jpeg、png 或 gif 类型的高质量徽标，大小为 60 KB 以下。
    • 提供简短的应用说明（例如，“Contoso 技术支持将公司与客户聚集在一起”）。
    • 提供连接器的详细说明（例如，“Contoso Help Desk 连接器通知 Office 365 组有关客户票据的活动”）。
  • 将连接器发布到应用商店时：
    • 请确保按步骤说明填写并共享测试帐户信息，以便我们测试连接器。

后续步骤