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)
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 つ以上のメッセージの一覧。