Plivo （預覽版）

Plivo 支持全球各種規模的企業發送和接收短信和語音通話。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
URL	https://support.plivo.com/support/home

連接器中繼資料
Publisher	普利沃公司
網站	https://www.plivo.com/
隱私策略	https://www.plivo.com/legal/privacy/

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
驗證識別碼	字串	此 API 的使用者名稱。	對
驗證權杖	securestring	此 API 的密碼。	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

列出所有訊息	此操作會傳回與您的 Plivo 帳戶關聯的所有訊息清單。
取得訊息	此作業可用來擷取訊息的詳細資料，但指定訊息 ID。
發送短信	此操作用於發送簡訊。
進行通話	此作業用於撥打電話。

列出所有訊息

作業識別碼：: ListMessages

此操作會傳回與您的 Plivo 帳戶關聯的所有訊息清單。

傳回

名稱	路徑	類型	Description
API ID	api_id	string	API 請求的唯一 ID。
限制	meta.limit	integer	單一頁面中的訊息數目上限。
Next	meta.next	string	下一頁訊息的 URI （如果存在）。
Offset	meta.offset	integer	此頁面之前的訊息數。
上一個	meta.previous	string	URI 的 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	URI 以取得此單一訊息的詳細資料。
發往	objects.to_number	string	訊息傳送至的號碼。
總金額	objects.total_amount	string	訊息的費用金額。
費率	objects.total_rate	string	每單位訊息的費率。
單位	objects.units	integer	訊息分割成的單位數。

取得訊息

作業識別碼：: GetMessage

此作業可用來擷取訊息的詳細資料，但指定訊息 ID。

參數

名稱	機碼	必要	類型	Description
訊息 UUID	message_uuid	True	string	需要擷取詳細資料之訊息的UUID。

傳回

名稱	路徑	類型	Description
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	URI 以取得此單一訊息的詳細資料。
發往	to_number	string	訊息傳送至的號碼。
總金額	total_amount	string	訊息的費用金額。
費率	total_rate	string	每單位訊息的費率。
單位	units	integer	訊息分割成的單位數。

發送短信

作業識別碼：: SendSMS

此操作用於發送簡訊。

參數

名稱	機碼	必要	類型	Description
寄件者	src	True	string	要從中傳送訊息的 Plivo 號碼。
發往	dst	True	string	要傳送訊息的電話號碼。
Message	text	True	string	要傳送的訊息文字。

傳回

名稱	路徑	類型	Description
API ID	api_id	string	API 請求的唯一 ID。
回應	message	string	已傳送訊息的回應。
訊息 UUID	message_uuid	array of string	訊息的唯一 ID。

進行通話

作業識別碼：: MakeCall

此作業用於撥打電話。

參數

名稱	機碼	必要	類型	Description
寄件者	from	True	string	用於撥打電話的 Plivo 號碼。
發往	to	True	string	要撥打的電話號碼。
答案網址	answer_url	True	string	呼叫時要呼叫的URL。
答題方法	answer_method		string	HTTP 方法（GET/POST），應該用來呼叫回應 URL。

傳回

名稱	路徑	類型	Description
API ID	api_id	string	API 請求的唯一 ID。
回應	message	string	撥打電話時獲得的回應。
呼叫 UUID	request_uuid	string	通話的唯一 ID。