Twilio
Twilio を使用すると、アプリはグローバル SMS、MMS、IP メッセージを送受信できます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Standard | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Standard | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL |
Microsoft LogicApps のサポート Microsoft Power Automate のサポート Microsoft Power Apps のサポート |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://www.twilio.com/ |
| プライバシー ポリシー | https://www.twilio.com/legal/privacy |
Requirements
Twilio コネクタには、次の情報が必要です。
Twilio アカウント ID と 認証トークン。これは Twilio ダッシュボードで確認でき、アプリからの接続の作成を承認します。 Twilio 試用版アカウントを使用している場合は、検証済みの電話番号にのみテキスト メッセージを送信できます。
テキスト メッセージを送信できる検証済みの Twilio 電話番号と、テキスト メッセージを受信できるもう 1 つの電話番号。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有可能 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Twilio アカウント ID | securestring | Twilio アカウント ID | 正しい |
| Twilio アクセス トークン | securestring | Twilio アクセス トークン | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1200 | 60 秒 |
アクション
| テキスト メッセージの送信 (SMS) |
この操作は、携帯電話番号に新しいメッセージを送信するために使用されます。 |
| メッセージの一覧表示 [非推奨] |
アカウントに関連付けられているメッセージの一覧を返します。 |
| メッセージの一覧表示 V2 |
アカウントに関連付けられているメッセージの一覧を返します。 このアクションでは、改ページ位置の変更がサポートされます。 |
| メッセージを取得する |
この操作は、指定されたメッセージ ID で指定された 1 つのメッセージを返します。 |
テキスト メッセージの送信 (SMS)
この操作は、携帯電話番号に新しいメッセージを送信するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電話番号から
|
from | True | string |
送信するメッセージの種類に対して有効になっている Twilio の電話番号 (E.164 形式) または英数字の送信者 ID。 |
|
電話番号へ
|
to | True | string |
宛先の電話番号。 '+' と国コードを使用した形式 (例: +16175551212 (164 形式)。 |
|
テキスト
|
body | True | string |
送信するメッセージのテキスト。1600 文字に制限されます。 |
|
メディア URL
|
media_url | array of uri |
送信するメディアの URI の一覧。 |
|
|
状態コールバック
|
StatusCallback | uri |
メッセージの状態が変更されるたびに Twilio が投稿する URL。 |
|
|
メッセージング サービス Sid
|
messaging_service_sid | string |
メッセージング サービスの一意の ID。 |
|
|
アプリケーション SID
|
application_sid | string |
必要なメッセージ状態コールバックで構成されている Twilio アプリケーションの SID。 |
|
|
最大価格
|
max_price | string |
メッセージの合計最大価格制限。 |
|
|
有効期間
|
validity_period | string |
メッセージが Twilio キューに残ることができる秒数。 |
戻り値
1 つのメッセージのプロパティ。
- メッセージ
- Message
メッセージの一覧表示 [非推奨]
アカウントに関連付けられているメッセージの一覧を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電話番号へ
|
To | string |
この電話番号へのメッセージのみを表示します。 |
|
|
電話番号から
|
From | string |
この電話番号からのメッセージのみを表示します。 |
|
|
送信日
|
DateSent | date |
YYYY-MM-DD として指定された、この日付 (GMT 形式) で送信されたメッセージのみを表示します。 例: 2009-07-06。 |
|
|
極限
|
PageSize | integer |
各リスト ページで返されるリソースの数。 既定値は 50 です。 |
|
|
ページ
|
Page | integer |
ページ番号。 既定値は 0 です。 |
戻り値
1 つ以上のメッセージの一覧。
- メッセージ 一覧
- MessageList
メッセージの一覧表示 V2
アカウントに関連付けられているメッセージの一覧を返します。 このアクションでは、改ページ位置の変更がサポートされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電話番号へ
|
To | string |
この電話番号へのメッセージのみを表示します。 |
|
|
電話番号から
|
From | string |
この電話番号からのメッセージのみを表示します。 |
|
|
送信日
|
DateSent | date |
YYYY-MM-DD として指定された、この日付 (GMT 形式) で送信されたメッセージのみを表示します。 例: 2009-07-06。 |
|
|
極限
|
PageSize | integer |
各リスト ページで返されるリソースの数。 既定値は 50 です。 |
戻り値
1 つ以上のメッセージの一覧。
- メッセージ 一覧 V2
- MessageListV2
メッセージを取得する
この操作は、指定されたメッセージ ID で指定された 1 つのメッセージを返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
メッセージ SID
|
MessageId | True | string |
メッセージの一意の SID。 |
戻り値
1 つのメッセージのプロパティ。
- メッセージ
- Message
定義
メッセージ
1 つのメッセージのプロパティ。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
テキスト
|
body | string |
メッセージの本文。 |
|
From Number
|
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 |
メッセージング サービスの一意の ID。 |
MessageList
1 つ以上のメッセージの一覧。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
messages
|
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
|
value | array of Message |
1 つ以上のメッセージの一覧。 |