メッセージの送信

TwilioのREST APIを使用し、SMSメッセージをTwilioの電話番号から世界中の携帯電話に送信できます。

このガイドでは、Twilio Programmable Messaging APIの使用法について説明します。

• Twilioの電話番号からのSMSメッセージの送信
• メッセージステータスの追跡
• メッセージへのメディアの挿入(米国とカナダのみ)
• AIを活用したSMSボットによる返信

Twilio APIによるSMS送信

新しい発信メッセージをTwilioの電話番号から外部の番号に送信する場合は、自分のアカウントのMessageリソースに対してHTTP POSTを実行します。

/2010-04-01/Accounts/{AccountSid}/Messages

cURLを用いてAPIへ直接ポストを実行するか、あるいは6言語(C#、Java、Node.js、PHP、Python、Ruby)のヘルパーライブラリーを利用してメッセージを送信できます。

APIを介して新規メッセージを作成する場合、To、From、Bodyをパラメーターに含めます。

To

このパラメーターでは、SMSメッセージの宛先電話番号を指定します。 この番号には「+」と国コードを付加します(例: +16175551212などのE.164形式)。

From

Fromには、Twilioの電話番号やショートコード、そのメッセージを送信するMessaging Serviceを指定します。ご自身が所有するTwilioの電話番号に「+」と国コードに付加したもの(+16175551212などのE.164形式)である必要があります。

Twilioの電話番号を初めて入手する場合は、コンソールにアクセスし、SMS機能を利用可能な番号を見つけます。ショートコードを使用する場合は、同様にコンソールから申し込むことができます。

ヒント: メッセージングサービスからのメッセージの送信

SMSメッセージを送信する際に、Messaging Service SIDをFromパラメーター値として入力することもできます。Messaging Service SIDを使用する場合、Twilioはお客様のサービスプールの電話番号のいずれかを使用し、メッセージを自動的に送信します。

メッセージングサービスは電話番号のコンテナに例えられ、ルーティングインテリジェンスやコンテンツ機能などの一般的なユースケースにバンドルされています。詳細については、Messaging ServiceからのSMSメッセージ送信に関するガイドをご確認ください。

Body

Bodyパラメーターには、送信するメッセージの全文が含まれ、1,600文字までという制限があります。

Twilioは、Fromパラメーターに有効なTwilioの電話番号が含まれていることを検証した後、コールをキューに追加するか、エラーを返します。

メッセージステータスのモニタリング

APIコールにStatusCallback URLを含めることにより、メッセージに関する情報をどこにPOSTすべきかをTwilioに知らせることができます。

Twilioは、StatusCallback URLに対してPOSTリクエストを実行します。

Twilioは、メッセージステータスが以下のいずれかに変更されるたびに、このURLにPOSTします。

• queued(キューに追加)
• failed(失敗)
• sent(送信済み)
• delivered(配信済み)
• undelivered(未達)

お客様のコールバックURLにTwilioが送信するパラメーターには、標準リクエストパラメーターと、いくつかの一意なメッセージングパラメーターのサブセットが含まれます。MessageリソースのAPIリファレンスの一覧を参照してください。

以下は、配信済みメッセージのStatusCallback URLに送信されたリクエストパラメーターの一例です。

{
    "SmsSid": "SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "SmsStatus": "delivered",
    "MessageStatus": "delivered",
    "To": "+15558675310",
    "MessageSid": "SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "AccountSid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "From": "+15017122661",
    "ApiVersion": "2010-04-01"
}

メッセージへのメディアの挿入

MMSメッセージの送信はSMSの送信によく似ていますが、新しいパラメーターであるMediaUrlが含まれています。このパラメーターは、メッセージに挿入するメディアのURLを指定します。

Twilioは、.gif、.png、.jpegコンテンツをサポートしており、受信者のデバイスに合わせて画像をフォーマットします。お客様のMediaUrlのContent-TypeヘッダーがそのURLのメディアと一致しない場合、Twilioはそのリクエストを拒否します。

他のMIMEタイプもAPIは受け入れますが、デバイスの性能に合わせて変更することはありません。

メッセージメディアのサイズの上限は、5MBです。

1つのメッセージの本文内で複数の画像を送信するには、POSTリクエストに複数のMediaUrl値を設定する必要があります(1メッセージ当たり10まで)。

英数字の送信者IDの使用

英数字の送信者IDは、ブランドの単方向メッセージに使用されます。「From」値にE.164形式のTwilioの電話番号を使用する代わりに、独自のビジネスブランドなどのカスタム文字列を使用できます。英数字の送信者IDは、SMSをこの機能をサポートしている国に送信する場合は、追加料金なしで使用できます。

回数制限についての注意事項

1人のTwilioの送信者(番号または英数字の送信者ID)が一度に複数のメッセージを送信する場合、Twilioはそのメッセージを配信用のキューに追加します。使用している送信者に応じて、メッセージの回数制限は異なります。米国やカナダのロングコード番号からのメッセージについては、制限は1秒当たり1つのメッセージセグメント(MPS)となります。米国やカナダ以外のロングコード番号、あるいは英数字の送信者IDからメッセージを送信する場合、上限値は10MPSとなります。

指定した回数を超えるメッセージのAPIリクエストは、キューに追加されてTwilioの送信者の送信レートで処理されます。

アプリケーションが1人の送信者から4時間以上相当のアウトバウンドトラフィックをキューに追加しようとすると(1つのロングコード電話番号で14,400を超えるメッセージセグメントをカナダに送信するキューへの配置など)、超過メッセージはエラー30001(キューのオーバーフロー)により失敗します。

1件/秒以上のメッセージレートで大量のメッセージを送信する予定がある場合は、ショートコードの申請をご検討ください。

ショートコードは、ロングコード番号よりも多くの回数メッセージを送信することができるため、お客様により適したオプションです。

次のステップ

• Twilio SMS用APIリファレンスドキュメントを読む
• C#、Java、Node.js、PHP、Python、Ruby用のSMS会話作成ガイドを参照し、メッセージを会話に変換する
• C#、Java、Node.js、PHP、Python、Rubyにより送信するメッセージの配信ステータスを追跡する方法を把握する
• Twilioへのメッセージフィードバックの送信によりメッセージ配信を最適化する