TwiML™ メッセージ: <Message>
<Message>
動詞はメッセージを電話番号またはWireless SIMに送信します。
動詞の属性
<Message>
動詞は次の属性をサポートします。これらを使って動作を変更します。
属性名 | 許容値 | 初期値 |
---|---|---|
to | 電話番号、Wireless SIM Sid | 後述のセクションを参照 |
from | 1〜11文字の文字列(A-Z, a-z, 0-9)の電話番号か、Wireless SIMです。 | 後述のセクションを参照 |
action | 相対または絶対 URL | none |
method | GET, POST | POST |
to
正しい電話番号が'to'属性に必要です。Twilioは記入された番号にメッセージを送ります。'to'属性が入力されない場合、Twilioは送信者にメッセージを送り返します。
電話番号には「+」と国番号が必要です。例 : +16175551212
(E.164 フォーマット) to 番号に「+」がない場合、Twilio は from 番号と同じ国番号を使います。 Twilio は from 番号の国の、国内番号フォーマットも扱います (例 : アメリカ国内の (415) 555-1212、イギリス国内の 07400123456)。 From 番号と異なる国に SMS メッセージを送信する場合は、 必ず 「+」と国番号を挿入してください。
If you have a trial account, the to
phone number must be verified with Twilio. But you don't need to specify the to
attribute to just send a message reply to the current sender.
Wireless SIMに送信を行う
Wireless SIMへの送信の詳細については、Wireless Programmable SMSドキュメント内の「デバイスへのメッセージ送信」を参照してください。
from
'from'属性は、有効な電話番号 もしくは 英字と数字 送信者ID を 引数に取ります。この電話番号は、ご自身でご購入頂いた電話番号 もしくは Twilioに移管された番号に限ります。
英字と数字の送信者IDは この機能がサポートされた国のみで、メッセージを送信することができます。英字と数字送信者IDは 11文字に制限されています。大文字、小文字のASCII文字、0から9までの数字、スペースが使えます。: [A-Za-z0-9 ]送信者IDは 会社などの所属を示す必要があります。
着信したメッセージに対して返信メッセージを送る場合、 'from' にはメッセージを受信したTwilio番号がデフォルトで入ります。 'from' を指定した場合、あなたのアカウントに設定された電話番号が指定されなければなりません。もしそうでない場合は<Message>
は送信されません。
action
'action' 属性には URL が必要です。StatusCallback
パラメーター同様、REST API経由でのメッセージ送信時には、このURLは受信メッセージへの返信として送信されたメッセージのステータスをともなったHTTPリクエストを受信します。
The possible statuses for a message are queued
, failed
, sent
, delivered
, or undelivered
. Twilio will send the MessageSid
along with the other standard request parameters as well as MessageStatus
and ErrorCode
. Non-relative URLs must contain a valid hostname (underscores are not permitted).
リクエストの生成に使用されるHTTPメソッドは、methodプロパティーで設定します。
リクエストパラメーター
Twilioは、MessageStatusパラメータを、 一般的なTwiMLリクエストに 対するパラメータと合わせて 'action' URL. へ渡します。
method
'method' プロパティーは、'GET' または 'POST' を値として取ります。 これによって、GETあるいはPOSTどちらを使って action
URLをリクエストするかTwilioに指示します。この属性は、HTMLフォームの 'method' 属性をモデルにしています。 既定値はPOSTです。
リクエストパラメーター
Twilioは、MessageStatusパラメータを、一般的なTwiMLリクエストに対するパラメータと合わせてstatusCallback' へ渡します。
MessageStatus パラメーター
MessageStatus
は、action
URL または statusCallback
URL に渡されます。このパラメータには、そのメッセージに対する詳細な情報が含まれます。 (送信の成否や、宛先番号の不適切、本文がないなど)
パラメーター | 概要 |
---|---|
MessageStatus | そのメッセージに対する現在のステータス。queued 、sending 、sent 、failed のいずれかです。 |
名詞
TwiML 動詞の名詞とは、動詞の中にネストされた、それ自身が動詞ではないものを指します。動詞が動作を行う対象です。 <Message>
の名詞は、次の通りです。
名詞 | 概要 |
---|---|
plain text | 送信したいメッセージのテキスト本文です。1600文字未満である必要があります。 |
<Body> | 送信したいメッセージのテキスト本文です。1600文字未満である必要があります。一より多くのBody要素が一つのMessageに含まれる場合、一つのBodyにまとめられます。 |
<Media> | メッセージで送られるURLのイメージを示すネストされたXMLエレメント複数のイメージを一つのMedia要素に入れて送りたい場合一つのメッセージで送信できるMediaの最大数は10です。 |
参考
Want to send a message without waiting for an inbound message? See our outbound message documentation.
例 2: Mediaを使ってメッセージを送信する(MMS)
メッセージに絵を入れたい場合、Media名詞でURLを指定する必要があります。Body名詞で本文を入れることができます。Media名詞を使用した場合、本文はオプションです。
例3: MessageStatus レポーティング
このユースケースでは、「action」URLおよび「method」属性を指定しました。 メッセージが配信のために待ち行列に入れられると、Twilioは「action」URLにリクエストを行い、「MessageStatus」パラメーターを渡します。 メッセージが待ち行列に入れられて送信待ちである場合、「MessageStatus」の値は「sending」とないrます。 無効な属性が指定されると、「MessageStatus」は「invalid」となります。
あなたのアプリケーションで 'MessageStatus' の値を取得し、どのような TwiMLを返すか決定するロジックを組むことができます。
「action」URLが<Message>
に対して与えられると、アプリケーションのフローは「action」リクエストへのレスポンスによって受け取ったTwiMLを使用して続行されます。 ドキュメントの残りの部分の動詞には到達できなくなり、無視されます。
ネスティングルール
You can't nest any verbs within <Message>
and you can't nest <Message>
in any other verbs. The only elements that can be nested within a <Message>
are the nouns <Body>
and <Media>
.
<Message>
動詞の中にネストされた名詞 はこのようになります:
ヘルプが必要ですか?
誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。