Twilio
Twilio により、アプリはグローバル SMS、MMS、IP メッセージを送受信できるようになります。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | 標準 | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | 標準 | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| 連絡先 | |
|---|---|
| 件名 | Microsoft |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://www.twilio.com/ |
| プライバシー ポリシー | https://www.twilio.com/legal/privacy |
要件
Twilio コネクタには次の情報が必要です:
アプリからの接続の作成を承認するための Twilio アカウント ID と 認証トークン (Twilio ダッシュボードにあります)。 Twilio トライアル アカウントを使用している場合は、確認済みの電話番号にのみテキスト メッセージを送信できます。
テキスト メッセージを送信できる確認済みの 1 つの Twilio 電話番号と、テキスト メッセージを受信できる別の電話番号。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有可能 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| Twilio アカウント ID | securestring | Twilio アカウント ID | 真 |
| Twilio アクセス トークン | securestring | Twilio アクセス トークン | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1200 | 60 秒 |
アクション
| テスト メッセージを送信する (SMS) |
この操作は、新しいメッセージを携帯電話番号に送信するために使用されます。 |
| メッセージの一覧を表示する V2 |
アカウントに関連付けられているメッセージの一覧を返します。 このアクションはページネーションをサポートします。 |
| メッセージを一覧表示する [非推奨] |
アカウントに関連付けられているメッセージの一覧を返します。 |
| メッセージを取得する |
この操作は、指定されたメッセージ ID により指定される単一のメッセージを返します。 |
テスト メッセージを送信する (SMS)
この操作は、新しいメッセージを携帯電話番号に送信するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電話番号から
|
from | True | string |
送信するメッセージの種類に対して有効になっている Twilio 電話番号 (E.164 形式) または英数字の送信者 ID。 |
|
電話番号
|
to | True | string |
宛先の電話番号。 +16175551212 (E.164 形式) などの、「+」と国コードを使用した形式。 |
|
テキスト
|
body | True | string |
送信するメッセージのテキスト。1600 文字に制限されています。 |
|
メディア URL
|
media_url | array of uri |
送信するメディアの URI の一覧。 |
|
|
コールバックの状態
|
StatusCallback | uri |
メッセージの状態が変更されるたびに Twilio が POST する URL。 |
|
|
メッセージ サービス SID
|
messaging_service_sid | string |
メッセージ サービスを表す一意の ID。 |
|
|
アプリケーション SID
|
application_sid | string |
必要なメッセージがコールバックの状態で構成された Twilio アプリケーションの SID。 |
|
|
最高価格
|
max_price | string |
メッセージの合計最大価格制限。 |
|
|
有効期間
|
validity_period | string |
メッセージが Twilio キューに保持される秒数。 |
戻り値
単一のメッセージのプロパティ。
- メッセージ
- Message
メッセージの一覧を表示する V2
アカウントに関連付けられているメッセージの一覧を返します。 このアクションはページネーションをサポートします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電話番号
|
To | string |
この電話番号へのメッセージのみ表示します。 |
|
|
電話番号から
|
From | string |
この電話番号からのメッセージのみ表示します。 |
|
|
送信日
|
DateSent | date |
YYYY-MM-DD として指定される、この日付 (GMT 形式) に送信されたメッセージのみ表示します。 例: 2009-07-06。 |
|
|
制限
|
PageSize | integer |
各一覧ページで返すリソースの数。 既定値は 50 です。 |
戻り値
1 つ以上のメッセージの一覧。
- メッセージ一覧 V2
- MessageListV2
メッセージを一覧表示する [非推奨]
アカウントに関連付けられているメッセージの一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電話番号
|
To | string |
この電話番号へのメッセージのみ表示します。 |
|
|
電話番号から
|
From | string |
この電話番号からのメッセージのみ表示します。 |
|
|
送信日
|
DateSent | date |
YYYY-MM-DD として指定される、この日付 (GMT 形式) に送信されたメッセージのみ表示します。 例: 2009-07-06。 |
|
|
制限
|
PageSize | integer |
各一覧ページで返すリソースの数。 既定値は 50 です。 |
|
|
ページ
|
Page | integer |
ページ番号。 既定値は 0 です。 |
戻り値
1 つ以上のメッセージの一覧。
- メッセージの一覧
- MessageList
メッセージを取得する
この操作は、指定されたメッセージ ID により指定される単一のメッセージを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
メッセージ SID
|
MessageId | True | string |
メッセージの一位 SID。 |
戻り値
単一のメッセージのプロパティ。
- Message
- Message
定義
メッセージ
単一のメッセージのプロパティ。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
テキスト
|
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_created | string |
yyyy-MM-ddTHH:mm:ss.fffZ (UTC 形式) |
|
送信日時
|
date_sent | string |
yyyy-MM-ddTHH:mm:ss.fffZ (UTC 形式) |
|
更新日時
|
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 |
メッセージ サービスを表す一意の ID。 |
MessageList
1 つ以上のメッセージの一覧。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ
|
messages | array of Message | |
|
ページ
|
page | integer |
応答のページ番号。 |
|
制限
|
page_size | integer |
応答のページ サイズ。 |
|
ページ数
|
num_pages | integer |
応答のページ合計数。 |
|
スタート画面
|
start | integer |
最初のメッセージのインデックス。 |
|
End キー
|
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。 |
MessageListV2
1 つ以上のメッセージの一覧。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
次のページの相対 URI。 |
|
価値
|
value | array of Message |
1 つ以上のメッセージの一覧。 |