如何使用从Microsoft团队的Web解决方案加载的配置创建连接器

时间:2017-08-27 12:41:39

标签: microsoft-teams office365connectors

我正在尝试为Microsoft Teams创建连接器。 我已在连接器开发人员仪表板中完成注册并下载了manifest.json。

我可以在Teams中侧载连接器清单,也可以在连接器列表中找到连接器。

当我选择连接器并想要配置它时,我所有的entererd数据都会正确显示。

我的问题是 - 我想让连接器的用户根据他们在我网站上的订阅选择配置参数(例如在Trello连接器中)。

例如,用户在我的网站上创建了他订阅的几个区域。我想让他们选择一个他希望在Microsoft Teams会话中获取更新的区域。

从文档中,我无法找到从我的网站将配置参数加载到连接器配置对话框的位置或方式。 我的清单看起来像这样(URL和ID被替换)

 {
  "$schema": "https://statics.teams.microsoft.com/sdk/v1.0/manifest/MicrosoftTeams.schema.json",
  "manifestVersion": "1.0",
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "version": "1.0",
  "packageName": "com.example.org",
  "developer": {
    "name": "Developer Company",
    "websiteUrl": "https://www.example.com",
    "privacyUrl": "https://www.example.com",
    "termsOfUseUrl": "https://www.example.com"
  },
  "description": {
    "full": "The connector sends notifications ....",
    "short": "Lorem ipsum dolor sit amet"
  },
  "icons": {
    "outline": "https://outlook.office.com/connectors/Content/Images/IncomingWebhook.jpg",
    "color": "https://outlook.office.com/connectors/Content/Images/IncomingWebhook.jpg"
  },
   "configurableTabs": [
        {
            "configurationUrl": "https://teamsnodesample.azurewebsites.net/tabs/configure",
            "canUpdateConfiguration": true,
            "scopes": [
                "team"
            ]
        }
    ],
  "connectors": [
    {
      "connectorId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "scopes": [
        "team"
      ]
    }
  ],
  "name": {
    "full": "My Organisation",
    "short": "My Organisation"
  },
  "accentColor": "#FFFFFF",
  "needsIdentity": "true"
}

trello连接器配置的用户体验如下面的屏幕截图所示。我无法弄清楚如何集成连接器配置的所有对话框。

Screen 1

Screen 2

Screen 3

Screen 4

Screen 5

1 个答案:

答案 0 :(得分:1)

1)在连接器开发者信息中心中注册连接器并为您的用户设置登录页面重定向网址(例如ngrok端点)您的服务正在运行),Microsoft团队旁边有一个选项可以复制代码并下载Manifest。我看到你已经使用了清单来支持团队。复制代码提供了一个链接,您可以在代码中的着陆页面html中使用该链接。

2)点击连接器旁边的配置,它会弹出一个窗口,显示访问要安装的网站 - > 。这会将您带到在门户网站上注册连接器时指定的登录页面。如果您已将代码放在提货页面中,那么您应该能够看到一个连接到office365连接器的按钮。当您单击它时,它将转到重定向URL。您应该能够呼叫您的api并向用户显示任何配置体验。

此代码示例也可能有用: https://github.com/OfficeDev/microsoft-teams-sample-get-started/tree/master/Node/connector