通过 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
- 选择左侧导航菜单底部的“管理员”按钮。
- 选择“平台”,然后选择“集成”,接着点击管理员门户中的“集成库”。
- 找到并选择“Microsoft 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.