Power Platform 連接器
ConvinceIQ 的 Power Automate 連接器
把 ConvinceIQ 帶進團隊已在使用的流程、應用程式與代理程式。連接器可讀取練習通話、分數與排行榜，也能讓主管在其他系統發生事件時邀請成員、指派訓練計畫。適用於 Power Automate、Power Apps、Azure Logic Apps 與 Copilot Studio。
可以打造什麼
- 失單後的針對性練習。當 Dynamics 365 或其他 CRM 中的商機失單時，以電子郵件在 ConvinceIQ 找到負責的業務代表，並指派異議處理的訓練計畫。
- 新人到職。當有人透過 HR 系統或 Microsoft Entra ID 加入業務團隊時，邀請對方加入 ConvinceIQ，並指派到職訓練計畫。
- 每週成果。每週一將排行榜張貼到 Microsoft Teams 頻道。
- 報表。每晚將已結束的通話及其分數複製到 Excel、SharePoint 或 Power BI 資料集。
- 代理程式。將 ConvinceIQ 的動作提供給 Copilot Studio 代理程式，讓它能回答「我的團隊這週表現如何？」
開始之前
- 以 Microsoft 公司或學校帳戶登入的 ConvinceIQ 帳戶。連接器不支援個人 Microsoft 帳戶或 Google 登入。
- 合適的角色。所有人都能讀取自己的通話、自己的成員資格與排行榜。尋找成員、邀請成員與指派訓練計畫需要主管或管理員角色。主管可查看並處理其所管理的成員；管理員的範圍則是整個工作區。
- 合適的方案功能。指派訓練計畫需要包含訓練計畫功能的方案。以主管身分邀請他人，需要包含角色權限管理的方案。
- Power Automate Premium 授權。ConvinceIQ 是進階（Premium）連接器，與所有連接 Microsoft 以外服務的連接器相同。
連線
- 在流程中新增動作，並搜尋 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），有一至四次。上傳的通話不列入計算。
Find a member by email
依登入電子郵件地址找到對應的工作區成員。可用來把其他系統中的電子郵件，轉換成 Assign a training plan 所需的成員 ID。
需要：主管或管理員角色。
Invite a person
以 user（使用者）或 manager（主管）身分邀請某人加入工作區，並寄送邀請電子郵件。管理員無法透過連接器邀請，請在 ConvinceIQ 中邀請。
需要：主管或管理員角色。
Assign a training plan
將啟用中的訓練計畫指派給特定成員、團隊或整個工作區，並可選擇設定到期日。結果會顯示建立了幾筆指派、有幾人已經有這個計畫，以及有幾人無法指派。
需要：主管或管理員角色，以及包含訓練計畫功能的方案。
限制
- 每人每分鐘 100 次請求。超過後，ConvinceIQ 會回應「Too many requests」，並告知需要等待的秒數。
- 目前尚無觸發程序。若要在有新結果時採取行動，請建立排程流程並使用 List practice sessions。
- 逐字稿提供對話的先後順序，不含時間。
- 語言。回饋文字會以您在 ConvinceIQ 中設定的結果語言傳回。
錯誤
所有錯誤的格式都相同：{ "error": "...", "message": "..." }。
| 狀態碼 | 通常代表 |
|---|---|
| 400 | 缺少必要的輸入（最常見的是 Workspace），或某個輸入無效。 |
| 401 | 連線需要重新登入。 |
| 403 | 您的角色或工作區的方案不允許此動作。 |
| 404 | 該通話、成員或訓練計畫不存在，或您沒有權限查看。 |
| 409 | 該訓練計畫已封存。請先在 ConvinceIQ 中將它設為啟用，再進行指派。 |
| 429 | 請求過多。請等待訊息中指出的秒數。 |
安全與隱私
連接器透過 Microsoft Entra ID 以您的身分登入，ConvinceIQ 會對每一個請求套用您的角色與團隊。不需要儲存或分享任何 API 金鑰。
進一步了解ConvinceIQ 的安全性與我們的隱私權政策。
常見問題
可以用 Google 登入來使用連接器嗎？
不行。請使用 Microsoft 公司或學校帳戶登入 ConvinceIQ，才能使用連接器。
業務代表可以使用嗎？
可以，用來讀取自己的通話與排行榜。邀請成員與指派訓練計畫則需要主管或管理員角色。
要到哪裡取得協助？
請寄信至 info@convinceiq.com，或使用聯絡我們頁面。
初次認識 ConvinceIQ
還沒有 ConvinceIQ 工作區？
連接器需搭配現有的 ConvinceIQ 工作區使用。預約 Demo，看看練習、評分與指導如何在您的團隊中運作。