Plivo (プレビュー)

Plivo を使用すると、あらゆる規模の企業に対して SMS と音声通話をグローバルに送受信できます。

このコネクタは、次の製品とリージョンで使用できます。

サービス	クラス	リージョン
コピロットスタジオ	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)

お問い合わせ
URL	https://support.plivo.com/support/home

コネクタメタデータ
Publisher	Plivo Inc
Website	https://www.plivo.com/
プライバシーポリシー	https://www.plivo.com/legal/privacy/

接続を作成する

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


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

デフォルト

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

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

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

名前	タイプ	Description	必須
認証 ID	文字列	この API のユーザー名。	正しい
認証トークン	securestring	この API のパスワード。	正しい

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	100	60 秒

アクション

SMS の送信	この操作は、テキストメッセージを送信するために使用されます。
すべてのメッセージを一覧表示する	この操作により、Plivo アカウントに関連付けられているすべてのメッセージの一覧が返されます。
メッセージを取得する	この操作は、メッセージ ID を指定して、メッセージの詳細をフェッチするために使用されます。
呼び出しを行う	この操作は、呼び出しを行うために使用されます。

SMS の送信

操作 ID:: SendSMS

この操作は、テキストメッセージを送信するために使用されます。

パラメーター

名前	キー	必須	型	説明
より	src	True	string	メッセージの送信先となる Plivo 番号。
移行先	dst	True	string	メッセージの送信先となる電話番号。
メッセージ	text	True	string	送信するメッセージのテキスト。

戻り値

名前	パス	型	説明
API ID	api_id	string	API 要求の一意の ID。
[応答]	message	string	送信されたメッセージの応答。
メッセージ UUID	message_uuid	array of string	メッセージの一意の ID。

すべてのメッセージを一覧表示する

操作 ID:: ListMessages

この操作により、Plivo アカウントに関連付けられているすべてのメッセージの一覧が返されます。

戻り値

名前	パス	型	説明
API ID	api_id	string	API 要求の一意の ID。
極限	meta.limit	integer	1 ページ内のメッセージの最大数。
Next	meta.next	string	メッセージの次のページ (存在する場合) の URI。
オフセット	meta.offset	integer	このページの前のメッセージの数。
前へ	meta.previous	string	前のページの URI。
総計	meta.total_count	integer	メッセージの合計数。
メッセージ一覧	objects	array of object	すべてのメッセージの詳細。
エラーコード	objects.error_code	string	メッセージが配信されない場合の配信エラーコード。
より	objects.from_number	string	メッセージの送信先の番号。
メッセージの方向	objects.message_direction	string	メッセージの方向 (受信/送信)。
メッセージ配信の状態	objects.message_state	string	メッセージの状態 (キューに登録/送信/配信/失敗)。
タイムスタンプ	objects.message_time	string	メッセージが送受信されたタイムスタンプ (yyyy-MM-dd HH:mm:ss UTC)。
メッセージの種類	objects.message_type	string	メッセージの種類。
メッセージ UUID	objects.message_uuid	string	メッセージの一意の ID。
メッセージ URI	objects.resource_uri	string	この 1 つのメッセージの詳細を取得する URI。
移行先	objects.to_number	string	メッセージが送信された番号。
総額	objects.total_amount	string	メッセージに対して課金される金額。
料金	objects.total_rate	string	メッセージの単位あたりのレート。
単位	objects.units	integer	メッセージが分割された単位数。

メッセージを取得する

操作 ID:: GetMessage

この操作は、メッセージ ID を指定して、メッセージの詳細をフェッチするために使用されます。

パラメーター

名前	キー	必須	型	説明
メッセージ UUID	message_uuid	True	string	詳細をフェッチする必要があるメッセージの UUID。

戻り値

名前	パス	型	説明
API ID	api_id	string	API 要求の一意の ID。
エラーコード	error_code	string	メッセージが配信されない場合の配信エラーコード。
より	from_number	string	メッセージの送信先の番号。
メッセージの方向	message_direction	string	メッセージの方向 (受信/送信)。
メッセージ配信の状態	message_state	string	メッセージの状態 (キューに登録/送信/配信/失敗)。
タイムスタンプ	message_time	string	メッセージが送受信されたタイムスタンプ (yyyy-MM-dd HH:mm:ss UTC)。
メッセージの種類	message_type	string	メッセージの種類。
メッセージ UUID	message_uuid	string	メッセージの一意の ID。
メッセージ URI	resource_uri	string	この 1 つのメッセージの詳細を取得する URI。
移行先	to_number	string	メッセージが送信された番号。
総額	total_amount	string	メッセージに対して課金される金額。
料金	total_rate	string	メッセージの単位あたりのレート。
単位	units	integer	メッセージが分割された単位数。

呼び出しを行う

操作 ID:: MakeCall

この操作は、呼び出しを行うために使用されます。

パラメーター

名前	キー	必須	型	説明
より	from	True	string	呼び出しに使用される Plivo 番号。
移行先	to	True	string	通話する電話番号。
応答 URL	answer_url	True	string	呼び出しが行われるときに呼び出される URL。
Answer メソッド	answer_method		string	応答 URL の呼び出しに使用する HTTP メソッド (GET/POST)。

戻り値

名前	パス	型	説明
API ID	api_id	string	API 要求の一意の ID。
[応答]	message	string	呼び出しが行われたときに取得された応答。
UUID の呼び出し	request_uuid	string	呼び出しの一意の ID。