VoxAid（預覽）

根據設定原因將 AI 語音通話接到聯絡人，並讀取每通電話的結果。 搭配 VoxAide for Dynamics 365 管理解決方案。 使用 VoxAide API 金鑰進行驗證（設定→整合→ Dynamics 365）。

此連接器適用於以下產品和區域：

服務 Class Regions
Copilot Studio 進階 除以下部分外，所有Power Automate區域：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除以下部分外，所有Power Apps區域
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除以下部分外，所有Power Automate區域：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
聯絡方式
名稱 VoxAide 支援
URL https://voxaide.co
Email support@voxaide.co
連接器中繼資料
發行者 主權資訊科技解決方案有限公司
網站 https://voxaide.co
隱私策略 https://voxaide.co/privacy
類別 傳達;銷售和客戶關係管理

VoxAide

VoxAide 會根據你選擇的理由，將 AI 語音通話接到你的聯絡人，問你設定的問題，並回傳每次通話的結果——摘要、是否提出問題、持續時間及狀態。 用它來建立 Power Automate 的流程，自動呼叫人員（打到、確認、提醒、參考查核），並將結果寫回系統。

發行者

VoxAid（主權資訊科技解決方案有限公司）

先決條件

  • VoxAide 帳號（註冊地址）。https://voxaide.co 通話會從你的 VoxAide 計劃或預付費餘額中扣款。
  • 你的 VoxAide 組織已啟用通話功能。
  • 支援高級/客製化連接器的 Power Automate、Power Apps 或 Logic Apps 方案。

如何取得認證

VoxAide 是用 API 金鑰進行認證的。

  1. 請登入 VoxAid。https://voxaide.co
  2. 請前往設定→整合。
  3. 在連接器區塊中，選擇產生金鑰並複製金鑰（以 開頭）。vox_live_ 它只出現過一次。
  4. 在 Power Automate 裡，建立 VoxAide 連線時，把金鑰貼到 API 金鑰欄位。

你可以隨時在同一個畫面中撤銷鑰匙。

支援的作業

運算 Description
撥打電話 現在就為某個聯絡人撥打 AI 語音通話，理由是特定原因。
名單呼叫 列出最近的通話，最新來電排第一; since 歡迎投票查詢最新資訊。
接電話 只需一通電話，結果就已經結束。
名單叫停原因 列出為您的組織設定的通話原因。
建立通話原因 創造一個新理由，並有名字和可提出的問題。
取得電話原因 透過識別碼找出單一理由。
更新通話原因 更新原因名稱、行程或問題。
測試連線 驗證 API 金鑰（連線測試使用的）。

典型流程是：打一通電話，並附上原因和聯絡人的電話號碼→投票，接一通電話（或列清單電話），直到status→/faileddeclinedcompleted/使用回傳summaryoutcome的電話，並issueRaised進入你的流程。

部署指示

連接檔分別為 apiDefinition.swagger.json、 和 apiProperties.jsonicon.png。 要在您自己的環境中使用 Power Platform Connectors CLI 建立連接器：

pip install paconn
paconn login
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png

已知問題和限制

  • 電話號碼必須採用 E.164 格式（例如 +14155550123）。
  • 撥打電話會消耗計劃津貼或預付費抵免;通話是在接入時計費，而非通話結束時計費。
  • 通話是非同步進行的： Put a Call 立即以 a callId 和 pending 狀態返回。 投票 請接到最終結果的電話。
  • 此activityId欄位用於對現有 CRM 活動（例如 Dynamics 365 電話活動）的進階回寫，大多數流程可忽略。

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有地區 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description Required
API 金鑰 安全字串 此 API 的 API 金鑰 沒錯

動作

列出通話

列出最近的通話紀錄，最新的排在前面。 請使用「sensu」來投票查詢更新。
取得電話原因

取得一個電話理由。
名單叫停原因

回傳組織的設定來電原因（自動化）。
建立通話原因

請先建立一個電話理由。
接電話

接電話。
撥打電話

現在就該 AI 語音通話給聯絡人，原因如下。 將 Dataverse 的 contactid 傳入 contact.externalId，讓結果在該聯絡人的時間軸上以新的電話通話活動形式回傳。 若要完成現有的電話通話活動（活動分發模式），請傳遞其 activityId。 使用 content.* 來驅動呼叫腳本內聯（由活動驅動），覆蓋理由中儲存的內容。
更新通話原因

更新通話原因。
測試連接

驗證 API 金鑰並回傳其對應的組織。

列出通話

作業識別碼：
ListCalls

列出最近的通話紀錄，最新的排在前面。 請使用「sensu」來投票查詢更新。

參數

名稱 機碼 必要 類型 Description
自從
 since string

ISO-8601 時間戳記;只有在這段時間或之後才有通話。
現況
 status string

依狀態篩選（待處理、in_progress、已完成、失敗、拒絕）。
原因標識符
 reasonId string

原因標識符
限制
 limit integer

限制

傳回

名稱 路徑 類型 Description
通話
 calls array of Call

取得電話原因

作業識別碼：
GetReason

取得一個電話理由。

參數

名稱 機碼 必要 類型 Description
Id
 id True string

Id

傳回

名稱 路徑 類型 Description
reason
 reason Reason

名單叫停原因

作業識別碼：
ListReasons

回傳組織的設定來電原因（自動化）。

傳回

名稱 路徑 類型 Description
原因
 reasons array of Reason

建立通話原因

作業識別碼：
CreateReason

請先建立一個電話理由。

參數

名稱 機碼 必要 類型 Description
名字
 name True string
描述
 description string
dayOfWeek
 dayOfWeek integer
問題
 questions True array of string
smsOnNoAnswer
 smsOnNoAnswer boolean
短信消息
 smsMessage string
狀態
 status string

活躍 |停頓

傳回

名稱 路徑 類型 Description
id
 id string

接電話

作業識別碼：
GetCall

接電話。

參數

名稱 機碼 必要 類型 Description
Id
 id True string

Id

傳回

名稱 路徑 類型 Description
呼叫
 call Call

撥打電話

作業識別碼：
PlaceCall

現在就該 AI 語音通話給聯絡人，原因如下。 將 Dataverse 的 contactid 傳入 contact.externalId，讓結果在該聯絡人的時間軸上以新的電話通話活動形式回傳。 若要完成現有的電話通話活動（活動分發模式），請傳遞其 activityId。 使用 content.* 來驅動呼叫腳本內聯（由活動驅動），覆蓋理由中儲存的內容。

參數

名稱 機碼 必要 類型 Description
reasonId
 reasonId True string
名字
 name string
phone
 phone True string

E.164 電話號碼。
電子郵件
 email string
externalId
 externalId string

Dataverse contactid GUID — 綁定為新電話活動的相關（建立路徑）。
活動ID
 activityId string

現有的 Dataverse 電話通話（activityid）GUID 以完成結果。 省略建立新的電話通話活動。
purpose
 purpose string
問候
 greeting string
再見
 goodbye string
問題
 questions array of string

傳回

身體
PlaceCallResponse

更新通話原因

作業識別碼：
UpdateReason

更新通話原因。

參數

名稱 機碼 必要 類型 Description
Id
 id True string

Id
名字
 name True string
描述
 description string
dayOfWeek
 dayOfWeek integer
問題
 questions True array of string
smsOnNoAnswer
 smsOnNoAnswer boolean
短信消息
 smsMessage string
狀態
 status string

活躍 |停頓

測試連接

作業識別碼：
TestConnection

驗證 API 金鑰並回傳其對應的組織。

傳回

身體
Ping

定義

Ping

名稱 路徑 類型 Description
好
 ok boolean
orgId
 orgId string
組織
 org string

Reason

名稱 路徑 類型 Description
id
 id string
名字
 name string
描述
 description string

AI 向聯絡人傳達的簡單語言目的。
狀態
 status string

活躍 |停頓
dayOfWeek
 dayOfWeek integer

每週排班日（1=週一......5=星期五）。
問題
 questions array of string
smsOnNoAnswer
 smsOnNoAnswer boolean
短信消息
 smsMessage string
聯絡計數
 contactCount integer

地點呼叫回應

名稱 路徑 類型 Description
callId
 callId string
狀態
 status string

Call

名稱 路徑 類型 Description
callId
 callId string
reasonId
 reasonId string
狀態
 status string

待定 |聯絡 |in_progress |已完成 |失敗 |拒絕
結果
 outcome string

已完成 |no_answer |拒絕 |in_progress
名字
 contact.name string
phone
 contact.phone string
externalId
 contact.externalId string
摘要
 summary string
議題提出
 issueRaised boolean
附註
 notes string
持續時間
 durationSec integer
完成於
 completedAt string
createdAt
 createdAt string