VoxAide(미리 보기)
구성된 이유로 AI 음성 통화를 연락처에 배치하고 각 통화의 결과를 읽습니다. Dynamics 365 관리 솔루션용 VoxAide와 쌍을 이루어 줍니다. VoxAide API 키로 인증합니다(설정 → 통합 → Dynamics 365).
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 표준 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 파워 오토메이트 | Premium | 다음을 제외한 모든 Power Automate 지역: - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Contact | |
|---|---|
| 이름 | VoxAide 지원 |
| URL | https://voxaide.co |
| 전자 메일 | support@voxaide.co |
| 커넥터 메타데이터 | |
|---|---|
| Publisher | 소버린 IT 솔루션 제한 |
| 웹 사이트 | https://voxaide.co |
| 개인 정보 보호 정책 | https://voxaide.co/privacy |
| 카테고리 | 통신; 판매 및 CRM |
VoxAide
VoxAide는 사용자가 선택한 이유로 대화 상대에게 AI 음성 통화를 배치하고, 설정한 질문을 하고, 각 통화의 결과(요약, 문제가 발생했는지 여부, 기간 및 상태)를 반환합니다. 이를 사용하여 사용자를 자동으로 호출하는 Power Automate 흐름을 빌드하고(체크 인, 확인, 미리 알림, 참조 검사) 결과를 시스템에 다시 씁니다.
Publisher
VoxAide(소버린 IT 솔루션 주식회사)
Prerequisites
- VoxAide 계정(등록 시 https://voxaide.co). 통화는 VoxAide 플랜 또는 종량제 잔액을 기준으로 합니다.
- VoxAide 조직에서 사용하도록 설정된 호출 기능입니다.
- 프리미엄/사용자 지정 커넥터를 지원하는 Power Automate, Power Apps 또는 Logic Apps 계획입니다.
자격 증명을 가져오는 방법
VoxAide는 API 키를 사용하여 인증합니다.
- 에서 VoxAide에 로그인합니다 https://voxaide.co.
- 설정 → 통합으로 이동합니다.
- 커넥터 섹션에서 키 생성 을 선택하고 키(키 시작)를 복사합니다
vox_live_. 한 번 표시됩니다. - Power Automate VoxAide 연결을 만들 때 키를 API 키 필드에 붙여넣습니다.
언제든지 동일한 화면에서 키를 해지할 수 있습니다.
지원되는 작업
| Operation | 설명 |
|---|---|
| 전화 걸기 | 특정 이유로 연락처에 AI 음성 통화를 지금 배치합니다. |
| 호출 나열 | 최근 호출을 나열하고, 가장 먼저 최신 호출을 나열합니다. since 업데이트를 사용하여 폴링합니다. |
| 전화 받기 | 단일 호출 및 해당 결과가 완료되면 가져옵니다. |
| 통화 이유 나열 | 조직에 대해 구성된 통화 이유를 나열합니다. |
| 통화 이유 만들기 | 이름과 질문과 함께 새로운 이유를 만듭니다. |
| 통화 이유 가져오기 | 식별자를 사용하여 단일 이유를 가져옵니다. |
| 통화 이유 업데이트 | 이유의 이름, 일정 또는 질문을 업데이트합니다. |
| 연결 테스트 | 연결 테스트에서 사용되는 API 키를 확인합니다. |
일반적인 흐름: → 반환 outcomeissueRaisedsummary된 통화 및 흐름에서 사용할 때까지/declinedstatus/completedfailed이유와 연락처의 전화 번호로 전화를 → 전화 걸기(또는 통화 나열)를 폴링합니다.
배포 지침
커넥터 파일은 다음과 apiProperties.jsonicon.png같습니다apiDefinition.swagger.json. 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). - 전화를 걸면 플랜 허용량 또는 종량제 크레딧이 사용됩니다. 호출은 완료될 때가 아니라 호출이 배치될 때 청구됩니다.
- 호출은 비동기적으로 배치됩니다. 호출을 배치하면 즉시 a
callId와pending상태가 반환됩니다. 폴링 최종 결과에 대한 호출을 가져옵니다 . - 이
activityId필드는 기존 CRM 작업(예: Dynamics 365 전화 통화 활동)에 대한 고급 쓰기 저장용이며 대부분의 흐름에서 무시될 수 있습니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | Type | 설명 | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 API의 API 키 | True |
actions
| 연결 테스트 |
API 키를 확인하고 매핑되는 조직을 반환합니다. |
| 전화 걸기 |
지정된 이유로 이제 AI 음성 통화를 연락처에 배치합니다. Dataverse contactid를 contact.externalId로 전달하여 결과가 해당 연락처의 타임라인에서 새 전화 통화 활동으로 다시 기록되도록 합니다. 대신 기존 전화 통화 작업(캠페인 배포 모드)을 완료하려면 해당 activityId를 전달합니다. content.*를 사용하여 호출 스크립트 인라인(캠페인 기반)을 구동하여 이유의 저장된 콘텐츠를 재정의합니다. |
| 전화 받기 |
전화를 받습니다. |
| 통화 이유 가져오기 |
통화 이유를 가져옵니다. |
| 통화 이유 나열 |
조직에 대해 구성된 호출 이유(자동화)를 반환합니다. |
| 통화 이유 만들기 |
통화 이유를 만듭니다. |
| 통화 이유 업데이트 |
통화 이유를 업데이트합니다. |
| 호출 나열 |
최근 호출을 가장 먼저 나열합니다. 'since'을 사용하여 업데이트를 폴링합니다. |
연결 테스트
전화 걸기
지정된 이유로 이제 AI 음성 통화를 연락처에 배치합니다. Dataverse contactid를 contact.externalId로 전달하여 결과가 해당 연락처의 타임라인에서 새 전화 통화 활동으로 다시 기록되도록 합니다. 대신 기존 전화 통화 작업(캠페인 배포 모드)을 완료하려면 해당 activityId를 전달합니다. content.*를 사용하여 호출 스크립트 인라인(캠페인 기반)을 구동하여 이유의 저장된 콘텐츠를 재정의합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
reasonId
|
reasonId | True | string | |
|
name
|
name | string | ||
|
phone
|
phone | True | string |
E.164 전화 번호입니다. |
|
email
|
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 |
반품
전화 받기
전화를 받습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
아이디
|
id | True | string |
아이디 |
반품
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
전화
|
call | Call |
통화 이유 가져오기
통화 이유를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
아이디
|
id | True | string |
아이디 |
반품
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
reason
|
reason | Reason |
통화 이유 나열
조직에 대해 구성된 호출 이유(자동화)를 반환합니다.
반품
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
이유
|
reasons | array of Reason |
통화 이유 만들기
통화 이유를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
name
|
name | True | string | |
|
description
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
질문
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
상태
|
status | string |
활성 | 일시 중지 |
반품
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
id
|
id | string |
통화 이유 업데이트
통화 이유를 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
아이디
|
id | True | string |
아이디 |
|
name
|
name | True | string | |
|
description
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
질문
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
상태
|
status | string |
활성 | 일시 중지됨 |
호출 나열
최근 호출을 가장 먼저 나열합니다. 'since'을 사용하여 업데이트를 폴링합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이후
|
since | string |
ISO-8601 타임스탬프; 이 호출만 생성됩니다. |
|
|
상태
|
status | string |
상태(보류 중, in_progress, 완료됨, 실패, 거부됨)로 필터링합니다. |
|
|
ReasonId
|
reasonId | string |
ReasonId |
|
|
한계
|
limit | integer |
한계 |
반품
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
호출
|
calls | array of Call |
정의
핑
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
그래
|
ok | boolean | |
|
orgId
|
orgId | string | |
|
Org
|
org | string |
Reason
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
id
|
id | string | |
|
name
|
name | string | |
|
description
|
description | string |
AI가 연락처에 릴레이하는 일반 언어 용도입니다. |
|
상태
|
status | string |
활성 | 일시 중지 |
|
dayOfWeek
|
dayOfWeek | integer |
매주 일정 일 (1 = 월 ... 5=금). |
|
질문
|
questions | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | |
|
smsMessage
|
smsMessage | string | |
|
contactCount
|
contactCount | integer |
PlaceCallResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
상태
|
status | string |
Call
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
callId
|
callId | string | |
|
reasonId
|
reasonId | string | |
|
상태
|
status | string |
보류 중 | 연락처 | in_progress | 완료됨 | 실패 | 거부됨 |
|
결과
|
outcome | string |
완료됨 | no_answer | 거부됨 | in_progress |
|
name
|
contact.name | string | |
|
phone
|
contact.phone | string | |
|
externalId
|
contact.externalId | string | |
|
summary
|
summary | string | |
|
issueRaised
|
issueRaised | boolean | |
|
메모
|
notes | string | |
|
durationSec
|
durationSec | integer | |
|
completedAt
|
completedAt | string | |
|
createdAt
|
createdAt | string |