メッセージを送信するには、アプリケーションはTwilioのMessages APIリソース(英語)にHTTP POSTリクエストを行い、受信者、送信者、およびコンテンツの3つの情報を指定する必要があります。
-
受信者: The
To
パラメータには、このメッセージを受信するために必要な宛先の電話番号(E.164 形式を使用)を指定します。- トライアルアカウントでは、メッセージを送信する前にまず電話番号の確認が必要です。この制限は、アカウントに残高がある状態でアップグレードされると解除されます。トライアルアカウントの制限の詳細については、Twilio フリートライアルアカウントに関しての記事をご覧ください。
-
送信者: 送信元を示す以下のいずれか
-
From
パラメータ : メッセージを送信するための有効なTwilio電話番号(E.164 形式を使用)、ショートコード、または英数字の送信者ID(利用可能な場合) -
MessagingServiceSid
パラメータ : Messaging Service から送信するための有効な Messaging Service SID (MGxxxxx)
-
-
コンテンツ: このメッセージのメークアップを示す次のいずれか、または両方。
-
Body
パラメーター : 送信したいテキストメッセージ -
MediaUrl
パラメーター : 送信したいメディアのURL(MMSのみ)
-
注 : メディアファイルはTwilioのプロキシサーバーからアクセス可能である必要があります。デスクトップ上のローカルファイルは、これらの方法ではアクセスできない可能性が高いですが、メディア送信のためにTwilio Assetsにアップロードし実現できます。サポートされているファイルタイプの詳細については、こちらをご覧ください。
サンプルコード
cURL script のサンプル :
curl -XPOST https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages.json \
--data-urlencode "To=+13105555555" \
--data-urlencode "From=+12125551234" \
--data-urlencode "MediaUrl=https://demo.twilio.com/owl.png" \
--data-urlencode "Body=Hello from my Twilio line!" \
-u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'
この例では、送信者 (212) 555-1234 (+12125551234
) から受信者 (310) 555-5555 (+13105555555
) に送信されるメッセージに、画像 owl.png と次のメッセージを添付しています。
Hello from my Twilio line!
このスクリプトを動作させるには、以下の更新を行い、ターミナルウィンドウに貼り付けてください。
- 1行目 : Account SID をアップデート
- 2行目 : 有効な宛先電話番号にアップデート
- 3行目 : 有効な送信元電話番号にアップデート
- 4行目 : 有効な画像URLにアップデート
- 5行目 : 希望するメッセージテキスト
- 6行目 : Account SID と Auth Token(英語)をアップデート
追加のオプションパラメータをリクエストに追加することで、ステータス変更の更新を要求したり、価格制限を追加できます。利用可能な各オプションの詳細とヘルパーライブラリのコードサンプルは、Message Parameters (Twilio Docs)をご覧ください。