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，看看練習、評分與指導如何在您的團隊中運作。