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
Email 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 キーを使用して認証します。

  1. https://voxaide.coで VoxAide にサインインします。
  2. [設定] → [統合] に移動します。
  3. [コネクタ] セクションで[ キーの生成 ] を選択し、キーをコピーします ( vox_live_で始まります)。 1 回表示されます。
  4. Power Automateで、VoxAide 接続を作成するときに、API キー フィールドにキーを貼り付けます。

同じ画面からいつでもキーを取り消すことができます。

サポートされている操作

Operation Description
通話を行う 特定の理由で、今すぐ連絡先に AI 音声通話を発信します。
呼び出しを一覧表示する 最新の呼び出しを最初に一覧表示します。更新プログラムの since を使用してポーリングします。
通話を取得する 終了したら、1 回の呼び出しとその結果を取得します。
通話の理由を一覧表示する 組織に対して構成された通話の理由を一覧表示します。
通話の理由を作成する 名前と質問を含む新しい理由を作成します。
通話の理由を取得する 識別子によって単一の理由を取得します。
通話の理由を更新する 理由の名前、スケジュール、または質問を更新します。
接続のテスト API キー (接続テストで使用) を確認します。

一般的なフロー: statusがフローで返されたsummaryoutcomeissueRaisedを使用completed/failed/declined →まで、理由と連絡先の電話番号を含む通話を発信→、通話の取得 (または通話の一覧表示) を行います。

デプロイの手順

コネクタ ファイルは、 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)。
  • 通話を行うと、プランの許容量または従量課金制クレジットが消費されます。呼び出しは、通話が完了したときではなく、呼び出しが行われたときに課金されます。
  • 呼び出しは非同期的に行われます。callIdpending状態ですぐに呼び出しが返されます。 Poll 最終的な結果の呼び出しを取得 します。
  • activityIdフィールドは、既存の CRM アクティビティ (Dynamics 365電話アクティビティなど) への高度な書き戻し用であり、ほとんどのフローでは無視できます。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有不可

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前 タイプ Description Required
API キー Securestring この API の API キー True

アクション

テスト接続

API キーを検証し、マップする組織を返します。

呼び出しを一覧表示する

最新の呼び出しを最初に一覧表示します。 更新プログラムをポーリングするには、'since' を使用します。

通話の理由を一覧表示する

組織の構成済みの通話の理由 (自動化) を返します。

通話の理由を作成する

呼び出しの理由を作成します。

通話の理由を取得する

通話の理由を取得します。

通話の理由を更新する

通話の理由を更新します。

通話を取得する

呼び出しを取得します。

電話の発信

特定の理由で、今すぐ AI 音声通話を連絡先に発信します。 Dataverse contactid を contact.externalId として渡すと、その連絡先のタイムラインで新しい電話アクティビティとして結果が書き戻されます。 代わりに既存の通話アクティビティを完了するには (キャンペーン配布モード)、その activityId を渡します。 content.* を使用して呼び出しスクリプトをインライン (キャンペーン主導) にし、理由の保存されたコンテンツをオーバーライドします。

テスト接続

API キーを検証し、マップする組織を返します。

返品

Body
Ping

呼び出しを一覧表示する

最新の呼び出しを最初に一覧表示します。 更新プログラムをポーリングするには、'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 電話番号。

メール
email string
externalId
externalId string

Dataverse contactid GUID — 新しい通話アクティビティの [関連] (パスの作成) としてバインドされます。

activityId
activityId string

結果と共に完了するための既存の Dataverse phonecall (activityid) GUID。 省略すると、新しい電話アクティビティが作成されます。

目的
purpose string
挨拶
greeting string
さようなら
goodbye string
質問
questions array of string

返品

定義

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