VoxAide (预览版)
出于配置的原因,将 AI 语音呼叫置于联系人,并读取每个呼叫的结果。 与用于Dynamics 365托管解决方案的 VoxAide 配对。 使用 VoxAide API 密钥进行身份验证(设置→集成→ Dynamics 365)。
此连接器在以下产品和区域中可用:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域: - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 : - Azure 政府区域 - Azure中国区域 - 美国国防部(DoD) |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域: - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域: - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 联系人 | |
|---|---|
| Name | VoxAide 支持 |
| URL | https://voxaide.co |
| support@voxaide.co |
| 连接器元数据 | |
|---|---|
| Publisher | 主权 IT 解决方案有限公司 |
| 网站 | https://voxaide.co |
| 隐私策略 | https://voxaide.co/privacy |
| Categories | 通信;销售和 CRM |
VoxAide
VoxAide 会出于你选择的原因,向联系人发出 AI 语音呼叫,询问你设置的问题,并返回每个呼叫的结果 - 摘要、是否提出问题、持续时间和状态。 使用它可以生成Power Automate流,这些流会自动调用人员(签入、确认、提醒、引用检查),并将结果写回到系统。
Publisher
VoxAide (主权 IT 解决方案有限公司)
Prerequisites
- VoxAide 帐户(注册)。https://voxaide.co 对 VoxAide 计划或即用即付余额进行通话抽签。
- 在 VoxAide 组织中启用的呼叫功能。
- 支持高级/自定义连接器的Power Automate、Power Apps或逻辑应用计划。
如何获取凭据
VoxAide 使用 API 密钥进行身份验证。
- 登录 VoxAide at https://voxaide.co.
- 转到 “设置”→集成。
- 在“连接器”部分下,选择 “生成密钥 ”并复制密钥(以该密钥开头
vox_live_)。 它显示一次。 - 在Power Automate中创建 VoxAide 连接时,将密钥粘贴到 API 密钥字段中。
可以随时从同一屏幕撤销密钥。
支持的操作
| 运算 | Description |
|---|---|
| 拨打电话 | 出于给定原因,立即将 AI 语音呼叫置于联系人。 |
| 列出呼叫 | 列出最近调用,首先列出最新呼叫;使用 since 更新轮询。 |
| 获取呼叫 | 一旦结束,即可获取单个调用及其结果。 |
| 列出调用原因 | 列出为组织配置的呼叫原因。 |
| 创建呼叫原因 | 使用名称和要提问的问题创建新原因。 |
| 获取呼叫原因 | 按标识符获取单个原因。 |
| 更新呼叫原因 | 更新原因的名称、计划或问题。 |
| 测试连接 | 验证 API 密钥(连接测试使用)。 |
典型流:在→使用返回summaryoutcome的呼叫之前,请拨打原因和联系人的电话号码→轮询“获取呼叫”(或“列出呼叫”status/failed/completeddeclined),然后在issueRaised流中。
部署说明
连接器文件和 apiDefinition.swagger.jsonapiProperties.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)。 - 拨打电话会消耗计划津贴或即用即付额度;呼叫在放置时计费,而不是在呼叫完成时计费。
- 调用以异步方式进行: 立即发出调用 并返回
callId状态pending。 轮询获取最终结果的 调用 。 - 该
activityId字段用于对现有 CRM 活动(例如Dynamics 365电话呼叫活动)进行高级写回,对于大多数流,可以忽略该活动。
正在创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | Required |
|---|---|---|---|
| API 密钥 | 安全字符串 | 此 API 的 API 密钥 | True |
操作
| 列出呼叫 |
首先列出最近的调用。 使用“自”轮询更新。 |
| 列出调用原因 |
返回组织的已配置调用原因(自动化)。 |
| 创建呼叫原因 |
创建呼叫原因。 |
| 发出呼叫 |
出于给定原因,现在将 AI 语音呼叫置于联系人。 将 Dataverse contactid 作为 contact.externalId 传递,以便将结果写回到该联系人的时间线上的新电话呼叫活动。 若要改为完成现有的电话呼叫活动(市场活动分配模式),请传递其 activityId。 使用 content.* 驱动调用脚本内联(市场活动驱动),替代原因存储的内容。 |
| 更新呼叫原因 |
更新呼叫原因。 |
| 测试连接 |
验证 API 密钥并返回它映射到的组织。 |
| 获取呼叫 |
获取呼叫。 |
| 获取呼叫原因 |
获取呼叫原因。 |
列出呼叫
首先列出最近的调用。 使用“自”轮询更新。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
由于
|
since | string |
ISO-8601 时间戳;仅在此时间/之后创建的调用。 |
|
|
地位
|
status | string |
按状态(挂起、in_progress、已完成、失败、已拒绝)进行筛选。 |
|
|
ReasonId
|
reasonId | string |
ReasonId |
|
|
限度
|
limit | integer |
限度 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
电话
|
calls | array of Call |
列出调用原因
返回组织的已配置调用原因(自动化)。
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
原因
|
reasons | array of Reason |
创建呼叫原因
创建呼叫原因。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
名字
|
name | True | string | |
|
描述
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
问题
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
状态
|
status | string |
活动 |已暂停 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
id
|
id | string |
发出呼叫
出于给定原因,现在将 AI 语音呼叫置于联系人。 将 Dataverse contactid 作为 contact.externalId 传递,以便将结果写回到该联系人的时间线上的新电话呼叫活动。 若要改为完成现有的电话呼叫活动(市场活动分配模式),请传递其 activityId。 使用 content.* 驱动调用脚本内联(市场活动驱动),替代原因存储的内容。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
reasonId
|
reasonId | True | string | |
|
名字
|
name | string | ||
|
phone
|
phone | True | string |
E.164 电话号码。 |
|
电子邮件
|
string | |||
|
externalId
|
externalId | string |
Dataverse contactid GUID — 绑定为新的电话呼叫活动的“关于”(创建路径)。 |
|
|
activityId
|
activityId | string |
使用结果完成的现有 Dataverse phonecall (activityid) GUID。 省略以创建新的电话呼叫活动。 |
|
|
purpose
|
purpose | string | ||
|
问候
|
greeting | string | ||
|
再见
|
goodbye | string | ||
|
问题
|
questions | array of string |
返回
- Body
- PlaceCallResponse
更新呼叫原因
更新呼叫原因。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
|
名字
|
name | True | string | |
|
描述
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
问题
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
状态
|
status | string |
活动 |暂停 |
测试连接
获取呼叫
获取呼叫。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
调用
|
call | Call |
获取呼叫原因
获取呼叫原因。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
原因
|
reason | Reason |
定义
Ping
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
还行
|
ok | boolean | |
|
orgId
|
orgId | string | |
|
组织
|
org | string |
原因
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
id
|
id | string | |
|
名字
|
name | string | |
|
描述
|
description | string |
AI 中继到联系人的纯语言用途。 |
|
状态
|
status | string |
活动 |暂停 |
|
dayOfWeek
|
dayOfWeek | integer |
每周计划日 (1=Mon...5=Fri)。 |
|
问题
|
questions | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | |
|
smsMessage
|
smsMessage | string | |
|
contactCount
|
contactCount | integer |
PlaceCallResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
callId
|
callId | string | |
|
状态
|
status | string |
Call
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
callId
|
callId | string | |
|
reasonId
|
reasonId | string | |
|
状态
|
status | string |
pending |contacting |in_progress |completed |failed |拒绝 |
|
结果
|
outcome | string |
completed |no_answer |已拒绝 |in_progress |
|
名字
|
contact.name | string | |
|
phone
|
contact.phone | string | |
|
externalId
|
contact.externalId | string | |
|
摘要
|
summary | string | |
|
issueRaised
|
issueRaised | boolean | |
|
笔记
|
notes | string | |
|
durationSec
|
durationSec | integer | |
|
completedAt
|
completedAt | string | |
|
createdAt
|
createdAt | string |