与 Microsoft Teams 集成
与 Microsoft Teams 集成让 Service Desk 能够在发送出站电子邮件时向 Microsoft Teams 发送通知。
生成 Teams 应用程序
第一步是在 Microsoft Teams 中创建应用程序。
要创建 Teams 应用程序:
- 以管理员身份登录到 Microsoft Teams。
- 在应用程序选项卡上,搜索并添加 App Studio。
- 在 App Studio 的清单编辑器选项卡上,选择创建新应用程序。
- 至少指定以下值:
- 短名称
- 全名
- 简短描述
- 完整描述
- 程序包名称(例如 yourcompanyname.isdteamsapp.com)
- version (例如 1.0.0)
- 简短描述
- 详细描述
- 开发人员信息(例如姓名和公司网站地址)
- 网站 URL (需要 https://)
- 隐私声明 URL (需要 https://)
- 使用条款 URL (需要 https://)
- 点击生成。
随即生成应用程序 ID。 - 在功能下,选择机器人,然后点击设置。
- 输入名称,选择我的机器人是单向通知机器人,然后将范围设置为团队。
- 点击创建机器人。
此操作会创建机器人,而且机器人会出现在“机器人”页面中,同时会将 Service Desk 系统设置中使用的 ID 显示为机器人 ID。 - 点击生成新密码。
随即完成密码创建,稍后可在 Service Desk 系统设置中用作机器人密码。 - 在表单中输入机器人端点地址:
https://[URL to server]/[framework instance name]/api/messages?v=*
例如:https://my.example.org/servicedesk.framework.web/api/messages?v=*
- 从测试和分发选项卡中,以 zip 文件形式下载 Teams 应用程序。
为组织上传 Teams 应用程序
创建应用程序后,需要将其上传。
要为组织上传 Teams 应用程序:
- 以管理员身份登录到 Teams。
- 在应用程序选项卡上,点击上传自定义应用程序并上传上一个部分中的 zip 文件。
已上传的应用程序会显示一个图块。 - 点击应用程序的图块,然后点击添加到团队。
- 搜索所需的团队,然后点击设置机器人。
随即便为所选的团队安装 Teams 应用程序。
此时,已准备好将 Service Desk 配置为使用 Teams 应用程序,此后便可在 Teams 中将用户添加到团队。
配置 Service Desk 与 Teams 应用程序之间的集成
创建并上传 Teams 应用程序之后,便可以配置该应用程序与 Service Desk 之间的集成。此操作涉及从 Teams 应用程序配置添加部分 Service Desk 系统设置,随后还需要将成员添加到适当的团队,然后再返回到 Service Desk 系统设置启用并进一步配置集成。
要配置 Service Desk 与 Teams 应用程序之间的集成:
- 以管理员身份登录到 Service Desk 控制台。
- 在设置菜单上,单击系统。
随即显示“系统设置”页面。 - 在 Teams 集成下,设置以下值:
机器人 ID – 创建机器人时在 Microsoft Teams 中生成的 ID
机器人密码 – 创建机器人后在 Microsoft Teams 中生成的密码
团队链接 – 从团队的上下文菜单中选择获取团队链接时创建的 URL
通知图像 URL – 想要在 Teams 通知中出现的图像的 URL - 保存设置。
下一个阶段是设置只读的服务 URL 值。此操作会在完成以下步骤后,在第一条消息发送到 Service Desk Framework 时完成。 - 在 Service Desk 配置中心中,回收 Framework 应用程序池。
- 在 Microsoft Teams 中,将用户添加到已安装 Service Desk 通知应用程序的团队。
这样会将消息发送到 Service Desk Framework,从而填充服务 URL 系统设置。 - 在 Service Desk 系统设置页面上,在 Teams 集成下,将启用 Teams 通知设置为 True 并验证服务 URL 设置是否具有值。
完成上述配置后,除了由 Service Desk 出站电子邮件服务发送的电子邮件之外,添加到已安装应用程序的团队的所有用户还将在 Teams 收到通知。