Vonage （預覽版）
Vonage API 平台可讓您在應用程式內容中新增通訊，包括簡訊、語音和聊天。 在這裡註冊一個 Nexmo 帳戶 - https://www.vonage.com/
此連接器適用於以下產品和區域：
| 服務 | 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） |
| 連絡人 | |
|---|---|
| 名稱 | Vonage 支持 |
| URL | https://www.vonage.co.uk/support |
| support@vonage.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Vonage |
| 網站 | https://vonage.com |
| 隱私權原則 | https://www.vonage.com/legal/privacy-policy |
| 類別 | Communication |
Vonage API 平台可讓您在應用程式內容中新增通訊，包括簡訊、語音和聊天。
先決條件
您將需要以下內容才能繼續：
- Vonage 帳戶，註冊網址 https://dashboard.nexmo.com/sign-up
如何取得認證
要獲取憑據，您可以在以下網址註冊一個免費的 Vonage 帳戶 https://dashboard.nexmo.com/sign-up
已知問題與限制
此連接器目前不會公開所有 Vonage 產品和 API
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 傳送訊息至指定通道 |
發送訊息 |
| 提供有關號碼的基本號碼洞察資訊 |
提供有關號碼的基本號碼洞察資訊 |
| 提供有關號碼的標準號碼洞察資訊 |
提供有關號碼的標準號碼洞察資訊 |
| 要求驗證 |
使用「驗證」要求產生 PIN 碼，並將其傳送給使用者 |
| 驗證檢查 |
確認您從使用者收到的 PIN 碼符合「驗證」要求 |
傳送訊息至指定通道
發送訊息
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
請求的內容類型
|
Content-Type | True | string |
內容-類型 |
|
接受的日期類型
|
Accept | True | string |
接受 |
|
要傳送的訊息類型。 您必須在此欄位中提供文字
|
message_type | string |
要傳送的訊息類型。 您必須在此欄位中提供文字 |
|
|
要傳送的訊息文字;限制為 1000 個字符
|
text | string |
要傳送的訊息文字;限制為 1000 個字符 |
|
|
E.164 格式的郵件收件者的電話號碼
|
to | string |
E.164 格式的郵件收件者的電話號碼 |
|
|
E.164 格式的郵件收件者的電話號碼
|
from | string |
E.164 格式的郵件收件者的電話號碼 |
|
|
要傳送至的通道。 您必須在此欄位中提供簡訊
|
channel | string |
要傳送至的通道。 您必須在此欄位中提供簡訊 |
|
|
最多 40 個字元的用戶端參考
|
client_ref | string |
最多 40 個字元的用戶端參考 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
message_uuid
|
message_uuid | string |
message_uuid |
提供有關號碼的基本號碼洞察資訊
提供有關號碼的基本號碼洞察資訊
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
回應格式
|
format | True | string |
回應格式 |
|
您的 API 金鑰
|
api_key | True | string |
您的 API 金鑰 |
|
您的 API 密碼
|
api_secret | True | string |
您的 API 密碼 |
|
您需要以國內或國際格式深入了解的電話號碼
|
number | True | string |
您需要以國內或國際格式深入了解的電話號碼 |
|
ISO 3166-1 alpha-2 格式的雙字元國家代碼，例如。 英國或美國
|
country | True | string |
ISO 3166-1 alpha-2 格式的雙字元國家代碼，例如。 英國或美國 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
status | integer | |
|
status_message
|
status_message | string | |
|
請求ID
|
request_id | string | |
|
international_format_number
|
international_format_number | string | |
|
national_format_number
|
national_format_number | string | |
|
country_code
|
country_code | string | |
|
country_code_iso3
|
country_code_iso3 | string | |
|
country_name
|
country_name | string | |
|
country_prefix
|
country_prefix | string |
提供有關號碼的標準號碼洞察資訊
提供有關號碼的標準號碼洞察資訊
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
回應格式
|
format | True | string |
回應格式 |
|
您的 API 金鑰
|
api_key | True | string |
您的 API 金鑰 |
|
您的 API 密碼
|
api_secret | True | string |
您的 API 密碼 |
|
您需要以國內或國際格式深入了解的電話號碼
|
number | True | string |
您需要以國內或國際格式深入了解的電話號碼 |
|
ISO 3166-1 alpha-2 格式的雙字元國家代碼，例如。 英國或美國
|
country | True | string |
ISO 3166-1 alpha-2 格式的雙字元國家代碼，例如。 英國或美國 |
|
設定為 true 以在回應中接收電話號碼擁有者名稱
|
cnam | string |
設定為 true 以在回應中接收電話號碼擁有者名稱 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
status | integer | |
|
status_message
|
status_message | string | |
|
請求ID
|
request_id | string | |
|
international_format_number
|
international_format_number | string | |
|
national_format_number
|
national_format_number | string | |
|
country_code
|
country_code | string | |
|
country_code_iso3
|
country_code_iso3 | string | |
|
country_name
|
country_name | string | |
|
country_prefix
|
country_prefix | string | |
|
request_price
|
request_price | string | |
|
refund_price
|
refund_price | string | |
|
remaining_balance
|
remaining_balance | string | |
|
network_code
|
current_carrier.network_code | string | |
|
名稱
|
current_carrier.name | string | |
|
country
|
current_carrier.country | string | |
|
network_type
|
current_carrier.network_type | string | |
|
network_code
|
original_carrier.network_code | string | |
|
名稱
|
original_carrier.name | string | |
|
country
|
original_carrier.country | string | |
|
network_type
|
original_carrier.network_type | string | |
|
移植
|
ported | string | |
|
caller_type
|
caller_identity.caller_type | string | |
|
caller_name
|
caller_identity.caller_name | string | |
|
first_name
|
caller_identity.first_name | string | |
|
last_name
|
caller_identity.last_name | string | |
|
caller_name
|
caller_name | string | |
|
last_name
|
last_name | string | |
|
first_name
|
first_name | string | |
|
caller_type
|
caller_type | string |
要求驗證
使用「驗證」要求產生 PIN 碼，並將其傳送給使用者
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
回應格式
|
format | True | string |
回應格式 |
|
您可以在帳戶儀表板中找到您的 API 金鑰 https://dashboard.nexmo.com
|
api_key | True | string |
您可以在帳戶儀表板中找到您的 API 金鑰 https://dashboard.nexmo.com |
|
您可以在儀表板中找到您的 API 密碼 https://dashboard.nexmo.com
|
api_secret | True | string |
您可以在儀表板中找到您的 API 密碼 https://dashboard.nexmo.com |
|
要驗證的手機或固定電話號碼。 號碼必須為 E.164 格式
|
number | True | string |
要驗證的手機或固定電話號碼。 號碼必須為 E.164 格式 |
|
指定兩個字元的國家/地區代碼，然後驗證將格式化數字
|
country | string |
指定兩個字元的國家/地區代碼，然後驗證將格式化數字 |
|
|
18 個字元的英數字元字串，用來個人化要求 SMS 內文
|
brand | True | string |
18 個字元的英數字元字串，用來個人化要求 SMS 內文 |
|
代表寄件者身分的 11 個字元英數字元字串
|
sender_id | string |
代表寄件者身分的 11 個字元英數字元字串 |
|
|
驗證碼的長度
|
code_length | integer |
驗證碼的長度 |
|
|
控制用於「驗證」要求的語言
|
lg | string |
控制用於「驗證」要求的語言 |
|
|
產生的驗證碼有效期限（以秒為單位）
|
pin_expiry | integer |
產生的驗證碼有效期限（以秒為單位） |
|
|
嘗試傳遞驗證碼之間的等待時間（以秒為單位）
|
next_event_wait | integer |
嘗試傳遞驗證碼之間的等待時間（以秒為單位） |
|
|
預先定義的 SMS 和 TTS 動作序列，以將 PIN 碼傳達給您的使用者
|
workflow_id | integer |
預先定義的 SMS 和 TTS 動作序列，以將 PIN 碼傳達給您的使用者 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
status | string | |
|
請求ID
|
request_id | string |
驗證檢查
確認您從使用者收到的 PIN 碼符合「驗證」要求
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
回應格式
|
format | True | string |
回應格式 |
|
您的 API 金鑰
|
api_key | True | string |
您的 API 金鑰 |
|
您的 API 密碼
|
api_secret | True | string |
您的 API 密碼 |
|
這是您在回應驗證要求時收到的request_id
|
request_id | True | string |
這是您在回應驗證要求時收到的request_id |
|
使用者輸入的驗證碼
|
code | True | string |
使用者輸入的驗證碼 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
請求ID
|
request_id | string | |
|
event_id
|
event_id | string | |
|
狀態
|
status | string | |
|
價格
|
price | string | |
|
貨幣
|
currency | string | |
|
estimated_price_messages_sent
|
estimated_price_messages_sent | string |