Twilio
Twilio 使應用程序能夠發送和接收全球短信、彩信和 IP 消息。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://www.twilio.com/ |
| 隱私策略 | https://www.twilio.com/legal/privacy |
需求
Twilio 連接器需要下列資訊：
您的 Twilio 帳戶識別 碼和驗證權杖 （您可以在 Twilio 儀表板上找到），以授權從您的應用程式建立連線。 如果您使用 Twilio 試用帳戶，則只能將簡訊傳送至已驗證的電話號碼。
一個經過驗證的 Twilio 電話號碼可以發送短信，另一個可以接收短信的電話號碼。
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 可共用 |
預設
適用：所有地區
建立連線的參數。
這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Twilio 帳戶識別碼 | securestring | Twilio 帳戶識別碼 | 對 |
| Twilio 存取權杖 | securestring | Twilio 存取權杖 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 1200 | 60 秒 |
動作
| 列出訊息 [已棄用] |
傳回與您的帳戶相關聯的訊息清單。 |
| 列出訊息 V2 |
傳回與您的帳戶相關聯的訊息清單。 此動作支援分頁。 |
| 取得訊息 |
此作業會傳回所提供的訊息識別碼所指定的單一訊息。 |
| 發送短信 （SMS） |
此操作用於向手機號碼發送新消息。 |
列出訊息 [已棄用]
傳回與您的帳戶相關聯的訊息清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
至電話號碼
|
To | string |
僅顯示發送到此電話號碼的訊息。 |
|
|
從電話號碼
|
From | string |
僅顯示來自此電話號碼的訊息。 |
|
|
發送日期
|
DateSent | date |
僅顯示在此日期發送的訊息（以 GMT 格式），以 YYYY-MM-DD 格式提供。 範例：2009-07-06。 |
|
|
限制
|
PageSize | integer |
每個清單頁面中要傳回的資源數量。 預設值為 50。 |
|
|
頁面
|
Page | integer |
頁碼。 預設值為 0。 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageList
列出訊息 V2
傳回與您的帳戶相關聯的訊息清單。 此動作支援分頁。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
至電話號碼
|
To | string |
僅顯示發送到此電話號碼的訊息。 |
|
|
從電話號碼
|
From | string |
僅顯示來自此電話號碼的訊息。 |
|
|
發送日期
|
DateSent | date |
僅顯示在此日期發送的訊息（以 GMT 格式），以 YYYY-MM-DD 格式提供。 範例：2009-07-06。 |
|
|
限制
|
PageSize | integer |
每個清單頁面中要傳回的資源數量。 預設值為 50。 |
傳回
一或多則訊息的清單。
- 訊息清單 V2
- MessageListV2
取得訊息
此作業會傳回所提供的訊息識別碼所指定的單一訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訊息 SID
|
MessageId | True | string |
訊息的唯一 SID。 |
傳回
單一訊息的專有。
- Message
- Message
發送短信 （SMS）
此操作用於向手機號碼發送新消息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
從電話號碼
|
from | True | string |
針對您要傳送的訊息類型啟用的 Twilio 電話號碼 （E.164 格式） 或英數字元寄件者識別碼。 |
|
至電話號碼
|
to | True | string |
目的地電話號碼。 格式為“+”和國家/地區代碼，例如 +16175551212（E.164 格式）。 |
|
文字
|
body | True | string |
您要傳送的訊息文字，限制為 1600 個字元。 |
|
媒體網址
|
media_url | array of uri |
要傳送的媒體 URI 清單。 |
|
|
狀態回撥
|
StatusCallback | uri |
Twilio 會在每次訊息狀態變更時發佈到的 URL。 |
|
|
傳訊服務 Sid
|
messaging_service_sid | string |
傳訊服務的唯一識別碼。 |
|
|
應用程式 SID
|
application_sid | string |
Twilio 應用程式的 SID，已設定必要的訊息狀態回呼。 |
|
|
最高價格
|
max_price | string |
訊息的總價格上限。 |
|
|
有效期限
|
validity_period | string |
訊息可以保留在 Twilio 佇列中的秒數。 |
傳回
單一訊息的專有。
- Message
- Message
定義
Message
單一訊息的專有。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文字
|
body | string |
訊息內文。 |
|
發件人編號
|
from | phone |
傳送訊息的電話號碼。 |
|
到編號
|
to | phone |
訊息傳送至的電話號碼。 |
|
地位
|
status | string |
訊息的已傳送狀態。 |
|
SID
|
sid | string |
已傳送訊息的 SID。 |
|
帳戶 Sid
|
account_sid | string |
與已傳送訊息相關聯之帳戶的 SID。 |
|
API
|
api_version | string |
用來傳送訊息的 API 版本。 |
|
區段計數
|
num_segments | string |
訊息分割成的區段數。 |
|
媒體數量
|
num_media | string |
與已傳送訊息相關聯的媒體檔案數目。 |
|
創建 Date-Time
|
date_created | string |
yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式） |
|
已發送 Date-Time
|
date_sent | string |
yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式） |
|
更新 Date-Time
|
date_updated | string |
yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式） |
|
方向
|
direction | string |
與已傳送訊息相關聯的方向。 |
|
錯誤碼
|
error_code | integer |
與已傳送訊息相關聯的錯誤碼 （如果有的話）。 |
|
錯誤訊息
|
error_message | string |
與已傳送訊息相關聯的錯誤訊息 （如果有的話）。 |
|
價格
|
price | string |
已傳送訊息的成本。 |
|
單位
|
price_unit | string |
用來評估訊息成本的價格單位。 |
|
URI
|
uri | uri |
此資源的相對 URI。 |
|
子資源 URI
|
subresource_uris | object |
任何子資源的相對 URI。 |
|
傳訊服務 Sid
|
messaging_service_sid | string |
傳訊服務的唯一識別碼。 |
訊息清單
一或多則訊息的清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
頁面
|
page | integer |
回覆的頁碼。 |
|
限制
|
page_size | integer |
回應的頁面大小。 |
|
頁數
|
num_pages | integer |
回應中的總頁數。 |
|
開始
|
start | integer |
第一則訊息的索引。 |
|
結束
|
end | integer |
最後一則訊息的索引。 |
|
URI
|
uri | uri |
此清單的相對 URI。 |
|
第一頁 URI
|
first_page_uri | uri |
第一頁的相對 URI。 |
|
下一頁 URI
|
next_page_uri | uri |
下一頁的相對 URI。 |
|
訊息計數
|
total | integer |
訊息總數。 |
|
上一頁 URI
|
previous_page_uri | uri |
上一頁的相對 URI。 |
訊息清單V2
一或多則訊息的清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
@odata.next連結
|
@odata.nextLink | string |
下一頁的相對 URI。 |
|
value
|
value | array of Message |
一或多則訊息的清單。 |