通过 Awardco 与 Viva Engage 的集成,组织可以在其社区内无缝分享公开的 Awardco 认可。为实现此目的,您需要创建一个机器人用户,将该用户添加到您希望发布认可的任何社区,创建一个 Viva Engage 应用程序以模拟该用户,并将该应用程序连接到 Awardco。您必须拥有 Microsoft 365 管理员权限来创建用户,确保该用户具有访问 Viva Engage 的有效许可,并以 Awardco 管理员身份登录以将机器人用户的帐户连接到 Awardco。请按照以下文章中概述的步骤成功配置集成。
注意:此集成允许您在 Viva Engage 中查看即时认可的认可动态。然而,它不支持通过 Viva Engage 直接发送认可,不包括自动化程序的认可,也不显示动态中的图片和视频。
- 在 Microsoft Entra ID 中注册应用程序
- 获取客户端 ID 和客户端密钥
- 配置 API 权限
- 创建机器人用户
- 将机器人用户添加到社区
- 将 Viva Engage 应用程序连接到 Awardco
- 设置认可发布的元数据
- 常见问题解答(FAQ)
在 Microsoft Entra ID 中注册应用程序
- Microsoft 365 管理员(或具有相应权限的人,如应用程序开发者或云应用程序管理员)需要登录 Microsoft Azure 门户(http://portal.azure.com)。
- 选择 Microsoft Entra ID(或搜索它)。
- 在“管理”下,选择“应用注册”,然后点击“+ 新注册”。
- 填写注册详细信息:
- 名称:为应用程序命名一个有意义的名称(例如,“Awardco Viva Engage 集成”)。
- 支持的帐户类型:选择“仅限此组织目录中的帐户”(单租户)。
- 重定向 URI:输入以下内容,将 [your-subdomain] 替换为贵公司的 https://[your-subdomain].awardco.com/viva-engage/auth。
- 注册应用程序。
获取客户端 ID 和客户端密钥
- 注册完成后,您将进入应用程序的概览页面。应用程序(客户端)ID 即为客户端 ID。请保存以备后用。
- 客户端密钥:在左侧导航中,进入“证书和密钥”。点击“+ 新客户端密钥”,填写描述,选择过期时间,然后点击“添加”。请立即复制密钥的值。
- 注意:这是您的新客户端密钥,离开此页面后将无法再次获取。
配置 API 权限
- 在左侧导航中,进入“API 权限”。
- 点击“+ 添加权限”。
- 添加以下权限
- 在 Microsoft Graph 下
- openid
- profile
- User.read
- 在 Yammer 下
- user_impersonation
- 在 Microsoft Graph 下
- 授予管理员同意:添加权限后,管理员必须点击“为[您的组织]授予管理员同意”。
创建机器人用户
创建用于发布认可的机器人用户:
- 以 Microsoft 365 管理员身份登录 Microsoft 365 管理中心。https://admin.microsoft.com/Adminportal/Home#/users
- 点击“添加用户”。
- 为用户命名。例如,您可以将其显示名称设置为“我的公司认可”。
- 设置用户名和密码。您也可以选择将密码通过电子邮件发送给自己。请确保保存用户名和密码,后续将需要使用!
- 为用户分配许可,确保该用户可以访问 Viva Engage。
- 可跳过可选设置,除非您想进行编辑。
- 核对信息无误后,点击“完成添加”。
- 请确保保存用户名和密码,后续将需要使用!
将机器人用户添加到社区
- 使用新创建的机器人用户登录 Viva Engage https://web.yammer.com/。建议使用浏览器的隐身窗口进行操作。
- 让该用户创建和/或加入您希望发布认可的任何社区。
管理员为机器人用户赋予在任何社区发布权限的可选方法:
- 以全局管理员身份登录 Viva Engage(Yammer)。
- 进入 Yammer 管理中心(设置 > 网络管理员)。
- 从菜单中选择“管理员”。
- 找到您的机器人用户。
- 授予其“已验证管理员”身份。
将 Viva Engage 应用程序连接到 Awardco
连接 Viva Engage 应用程序到 Awardco 的步骤:
- 访问 https://[you-subdomain].awardco.com/settings/integrations/viva-engage
- 点击“开始设置”
- 点击“下一步”
- 输入之前保存的客户端 ID
- 输入之前保存的客户端密钥
- 在打开的新页面中,以您希望发布认可的机器人身份登录
- 点击“继续”
- 选择机器人要发布认可的社区
设置认可发布的元数据
设置元数据规则,以便来自不同地点或部门的用户能够看到与他们认识的人相关的认可(例如:
- 进入社区设置。
- 选择一个元数据字段作为规则的基础。
- 点击“添加规则”。
- 选择一个或多个元数据值。
- 选择您希望为这些元数据值发布认可的 Viva Engage 社区。
- 点击“保存规则”。
- 根据需要继续添加和保存规则。
- 如果您不希望为没有列出元数据值的用户发布任何认可,可以关闭“默认社区”。
常见问题解答(FAQ)
- 如果我在 Awardco 中看不到任何社区怎么办?
- 将机器人用户添加到您希望发布认可的所有社区。
- 如果认可未在 Viva Engage 发布怎么办?
- 确保集成未处于“暂停集成”状态。
- 确保已设置默认社区或元数据规则适用于认可的接收者。
- 确认您查看的是正确的社区。
- 确保认可为公开状态。
- 我可以自定义 Viva Engage 中认可的显示效果吗?
- 由于 Viva Engage API 的限制,无法格式化认可文本或进行任何自定义。
- Viva Engage 中的评论和反应会显示在 Awardco 动态中吗?
- 不,目前不支持此功能。
- 我能否将 SharePoint 与 Viva Engage 连接以显示认可?
- 您可以按照我们的使用 Viva Engage 在 SharePoint 中显示认可支持文章中的步骤进行设置。
If you have any questions, please contact Awardco Admin Support.