VoxAide (プレビュー)
構成された理由で AI 音声通話を連絡先に発信し、各通話の結果を読み取ります。 マネージド ソリューション用の VoxAide Dynamics 365ペア。 VoxAide API キーを使用して認証します (設定→統合→ Dynamics 365)。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | Regions |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate(パワーオートメート) | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| 連絡先 | |
|---|---|
| 名前 | VoxAide のサポート |
| URL | https://voxaide.co |
| support@voxaide.co |
| コネクタ メタデータ | |
|---|---|
| パブリッシャー | ソブリン IT ソリューション制限付き |
| Web サイト | https://voxaide.co |
| プライバシー ポリシー | https://voxaide.co/privacy |
| カテゴリ | 通信;売上と CRM |
VoxAide
VoxAide は、選択した理由で AI 音声通話を連絡先に送信し、設定した質問を行い、各通話の結果 (概要、問題が発生したかどうか、期間と状態) を返します。 これを使用して、ユーザーを自動的に呼び出すPower Automateフロー (チェックイン、確認、アラーム、参照チェック) を作成し、結果をシステムに書き戻します。
パブリッシャー
VoxAide (ソブリン IT ソリューション株式会社)
前提条件
- VoxAide アカウント ( https://voxaide.co でサインアップ)。 通話は、VoxAide プランまたは従量課金制の残高に基づいて描画されます。
- VoxAide 組織で有効になっている通話機能。
- Premium/カスタム コネクタをサポートするPower Automate、Power Apps、または Logic Apps プラン。
資格情報を取得する方法
VoxAide は API キーを使用して認証します。
- https://voxaide.coで VoxAide にサインインします。
- [設定] → [統合] に移動します。
- [コネクタ] セクションで[ キーの生成 ] を選択し、キーをコピーします (
vox_live_で始まります)。 1 回表示されます。 - Power Automateで、VoxAide 接続を作成するときに、API キー フィールドにキーを貼り付けます。
同じ画面からいつでもキーを取り消すことができます。
サポートされている操作
| Operation | Description |
|---|---|
| 通話を行う | 特定の理由で、今すぐ連絡先に AI 音声通話を発信します。 |
| 呼び出しを一覧表示する | 最新の呼び出しを最初に一覧表示します。更新プログラムの since を使用してポーリングします。 |
| 通話を取得する | 終了したら、1 回の呼び出しとその結果を取得します。 |
| 通話の理由を一覧表示する | 組織に対して構成された通話の理由を一覧表示します。 |
| 通話の理由を作成する | 名前と質問を含む新しい理由を作成します。 |
| 通話の理由を取得する | 識別子によって単一の理由を取得します。 |
| 通話の理由を更新する | 理由の名前、スケジュール、または質問を更新します。 |
| 接続のテスト | API キー (接続テストで使用) を確認します。 |
一般的なフロー: statusがフローで返されたsummary、outcome、issueRaisedを使用completed/failed/declined →まで、理由と連絡先の電話番号を含む通話を発信→、通話の取得 (または通話の一覧表示) を行います。
デプロイの手順
コネクタ ファイルは、 apiDefinition.swagger.json、 apiProperties.json 、 icon.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状態ですぐに呼び出しが返されます。 Poll 最終的な結果の呼び出しを取得 します。 -
activityIdフィールドは、既存の CRM アクティビティ (Dynamics 365電話アクティビティなど) への高度な書き戻し用であり、ほとんどのフローでは無視できます。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | Required |
|---|---|---|---|
| API キー | Securestring | この API の API キー | True |
アクション
| テスト接続 |
API キーを検証し、マップする組織を返します。 |
| 呼び出しを一覧表示する |
最新の呼び出しを最初に一覧表示します。 更新プログラムをポーリングするには、'since' を使用します。 |
| 通話の理由を一覧表示する |
組織の構成済みの通話の理由 (自動化) を返します。 |
| 通話の理由を作成する |
呼び出しの理由を作成します。 |
| 通話の理由を取得する |
通話の理由を取得します。 |
| 通話の理由を更新する |
通話の理由を更新します。 |
| 通話を取得する |
呼び出しを取得します。 |
| 電話の発信 |
特定の理由で、今すぐ AI 音声通話を連絡先に発信します。 Dataverse contactid を contact.externalId として渡すと、その連絡先のタイムラインで新しい電話アクティビティとして結果が書き戻されます。 代わりに既存の通話アクティビティを完了するには (キャンペーン配布モード)、その activityId を渡します。 content.* を使用して呼び出しスクリプトをインライン (キャンペーン主導) にし、理由の保存されたコンテンツをオーバーライドします。 |
テスト接続
呼び出しを一覧表示する
最新の呼び出しを最初に一覧表示します。 更新プログラムをポーリングするには、'since' を使用します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
次の日時以降
|
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
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
質問
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
状態
|
status | string |
active |一時 停止 |
返品
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
識別子
|
id | string |
通話の理由を取得する
通話の理由を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
返品
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
理由
|
reason | Reason |
通話の理由を更新する
通話の理由を更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
|
名前
|
name | True | string | |
|
description
|
description | string | ||
|
dayOfWeek
|
dayOfWeek | integer | ||
|
質問
|
questions | True | array of string | |
|
smsOnNoAnswer
|
smsOnNoAnswer | boolean | ||
|
smsMessage
|
smsMessage | string | ||
|
状態
|
status | string |
active |一時 停止 |
通話を取得する
呼び出しを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID |
返品
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
呼び出し
|
call | Call |
電話の発信
特定の理由で、今すぐ 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 | string | ||
|
挨拶
|
greeting | string | ||
|
さようなら
|
goodbye | string | ||
|
質問
|
questions | array of string |
返品
- Body
- PlaceCallResponse
定義
Ping
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
わかりました
|
ok | boolean | |
|
orgId
|
orgId | string | |
|
組織
|
org | string |
理由
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
識別子
|
id | string | |
|
名前
|
name | string | |
|
description
|
description | string |
AI が連絡先にリレーするプレーン言語の目的。 |
|
状態
|
status | string |
active |一時 停止 |
|
dayOfWeek
|
dayOfWeek | integer |
週単位のスケジュール日 (1 = 月 ...5 =金)。 |
|
質問
|
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 |
保留中 |お問い合わせ |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 |