Power Platform 连接器
ConvinceIQ 的 Power Automate 连接器
把 ConvinceIQ 接入团队已经在用的流、应用和代理。连接器可以读取练习通话、分数和排行榜，也能让主管和管理员在其他系统中发生事件时邀请成员、分配培训计划。适用于 Power Automate、Power Apps、Azure Logic Apps 和 Copilot Studio。
可以构建什么
- 丢单后的针对性练习。当 Dynamics 365 或其他 CRM 中的商机被标记为丢单时，按电子邮件地址在 ConvinceIQ 中找到负责的销售代表，并分配异议处理培训计划。
- 新人入职。当有人通过 HR 系统或 Microsoft Entra ID 加入销售团队时，邀请其加入 ConvinceIQ，待其加入后再分配入职培训计划。
- 每周成绩。每周一将最近 30 天的排行榜发布到 Microsoft Teams 频道。
- 报表。每晚将已结束的通话及其分数复制到 Excel、SharePoint 或 Power BI 数据集。
- 代理。将 ConvinceIQ 的操作作为工具添加到 Copilot Studio 代理中，让它能够回答“我的团队这周表现如何？”
开始之前
- 使用 Microsoft 工作或学校账户登录的 ConvinceIQ 账户。连接器不支持个人 Microsoft 账户或 Google 登录。
- 合适的角色。所有人都可以读取自己的通话、自己的成员资格和排行榜。查找成员、邀请成员和分配培训计划需要主管或管理员角色。主管可以查看和处理其所管理的成员；管理员的范围则是整个工作区。
- 合适的方案功能。分配培训计划需要包含培训计划功能的方案。邀请他人担任主管，需要包含角色权限功能的方案。
- Power Automate Premium 许可证。Microsoft 会将每个新认证的连接器作为高级（Premium）连接器发布。
连接
- 在流中添加操作，并搜索 ConvinceIQ。
- 使用您登录 ConvinceIQ 的 Microsoft 工作或学校账户登录。
- 在每个操作中选择您的 Workspace（工作区）。列表会显示您所属的工作区。
如果登录时出现需要管理员批准的提示，说明贵组织只允许 Microsoft Entra 管理员批准应用。请让该管理员为 ConvinceIQ 连接器授予管理员同意（只需一次），之后贵组织中的所有人都可以连接。
连接器以您的身份运行。它能看到和能做的，绝不会超出您在 ConvinceIQ 中的权限。
操作
Get my membership
您在某个工作区中的成员资格：角色、状态、主管和团队，以及该工作区已启用的方案功能。适合作为检查连接的第一个操作。
List practice sessions
练习通话和导入的通话，附带最新分数，按最近更新时间排列，最新的在前。
| 输入 | 说明 |
|---|---|
| Status | all（默认）、active 或 ended |
| Source | all（默认）、practice_session 或 uploaded_recording（导入的通话） |
| Limit | 1 至 100，默认 20 |
| Offset | 用于分页。当 has_more 为 true 时，使用上一页返回的 next_offset。 |
每条通话记录包括：由谁进行、买家场景、计入的培训计划步骤、通话如何结束，以及评分：整体评分、六个维度的分数（需求探索、价值主张、异议处理、结构、下一步、语气）、优势、改进项，以及建议的下一个练习目标。
Get a session
单条通话记录的完整内容：以上所有信息，再加上按顺序排列的销售与买家对话逐字稿、通话笔记、买家对这通电话的评估（立场、顾虑、打动对方之处），以及买家的决策标准及每项是否达成。
Get the leaderboard
工作区最近 30 天练习通话的排行榜，分为两份按平均分排名的名单：顶尖绩效者（Top performers），期间内至少有五次已评分的练习通话；以及明日之星（Rising stars），有一至四次。导入的通话不计入。
| 输入 | 说明 |
|---|---|
| Limit | 每份名单 1 至 20 人，默认 5 |
Find a member by email
按登录电子邮件地址找到对应的工作区成员。可用于把其他系统中的电子邮件转换成 Assign a training plan 所需的成员 ID。
需要：主管或管理员角色。
Invite a person
邀请某人以 user（用户）或 manager（主管）身份加入工作区，并向其发送邀请邮件。管理员无法通过连接器邀请，请在 ConvinceIQ 中邀请。
需要：主管或管理员角色。
Assign a training plan
将培训计划分配给特定成员（最多 50 人）、团队或整个工作区，并可选择设置到期日（UTC 时间）。已归档的计划无法分配。结果会显示创建了多少条分配、有多少人已经有该计划，以及有多少人无法分配。
需要：主管或管理员角色（分配给整个工作区需要管理员角色），以及包含培训计划功能的方案。
限制
- 每人每分钟 100 次请求。超出后，ConvinceIQ 会返回“Too many requests”，并告知需要等待的秒数。
- 暂不支持触发器。如需在有新结果时采取行动，请创建计划流并使用 List practice sessions。
- 逐字稿提供对话的先后顺序，不含时间。
- 语言。反馈文字会以您使用 ConvinceIQ 的语言返回，可在“个人资料”页面的“语言”中更改。Get a session 会即时翻译；List practice sessions 则在已有译文时才显示译文。
错误
所有错误的格式都相同：{ "error": "...", "message": "..." }。
| 状态码 | 通常表示 |
|---|---|
| 400 | 缺少必填输入（最常见的是 Workspace），或某个输入无效，例如不存在的成员 ID。 |
| 401 | 连接需要重新登录。 |
| 402 | 工作区已没有可用的销售代表席位，无法发出这份邀请。 |
| 403 | 您的角色或工作区的方案不允许此操作，或您不是此工作区的有效成员。 |
| 404 | 该通话、培训计划或团队不存在，或您无权查看。 |
| 409 | 该培训计划已归档，或已分配给该团队或工作区。 |
| 429 | 请求过多。请等待消息中指出的秒数。 |
| 500, 502, 504 | ConvinceIQ 出现错误。请稍后再试。 |
安全与隐私
连接器通过 Microsoft Entra ID 以您的身份登录，ConvinceIQ 会对每个请求应用您的角色和团队。无需存储或共享任何 API 密钥。
进一步了解 ConvinceIQ 的安全性以及我们的隐私政策。
常见问题
可以用 Google 登录来使用连接器吗？
不可以。请使用 Microsoft 工作或学校账户登录 ConvinceIQ，才能使用连接器。
销售代表可以使用吗？
可以，用于读取自己的通话和排行榜。查找成员、邀请成员和分配培训计划需要主管或管理员角色。
在哪里获得帮助？
请发送邮件至 info@convinceiq.com，或使用联系我们页面。
初次了解 ConvinceIQ
还没有 ConvinceIQ 工作区？
连接器需要配合现有的 ConvinceIQ 工作区使用。预约 Demo，看看练习、评分和辅导如何在您的团队中运作。