MMSメッセージングを理解する
MMS(Multimedia Messaging Service)では、画像、ビデオ、オーディオなどのマルチメディア・コンテンツや、SMSメッセージ1通で送信できるよりも長いテキスト・コンテンツを送信できます。メッセージは、受信者がデータ通信や無線LANに接続していなくても、モバイルネットワーク経由で配信されます。
MMSメッセージングには、マーケティング、政治キャンペーン、プロモーション、通知など、さまざまな用途が考えられる。
空室状況
Vonage Messages APIは現在、米国およびカナダでのMMSメッセージ送信をサポートしています。USショートコード、10DLC番号、SMS対応フリーダイヤルは現在MMS送信に対応しています。USショートコードの場合、MMSメッセージは米国内のAT&T、T-Mobile(旧Sprint)、Verizonネットワークに送信できます。メッセージのスループット、配信能力、SMSメッセージ量は、使用する番号の種類によって異なる場合があります。
10DLC
米国で10桁のロングコードを使ってMMSメッセージを送信するには、10DLCブランドとキャンペーンで番号を登録する必要があります。参照 本文書 をクリックして、10DLC番号の設定についての詳細をご覧ください(注:この文書はSMS APIを参照していますが、10 DLCガイドラインセクションの内容はMessages APIにも適用されます)。
メッセージング機能
Messages API MMSチャネルは、アウトバウンド・メッセージング(ビジネスから顧客へ送信されるメッセージ)とインバウンド・メッセージング(アウトバウンド・メッセージに応答して顧客からビジネスへ送信されるメッセージ)の両方をサポートしています。この両方のカテゴリーの中に、いくつかの異なるタイプのメッセージが存在します。
送信メッセージの種類
アウトバウンドメッセージには7つのタイプがある:
textimageaudiovideovcardfilecontent
を除くすべてのメッセージタイプ text にはメディアやファイルの添付が可能です。その場合 image, audio, video, vcardそして file タイプには、特定のタイプのアタッチメントを1つ含めることができます。 content メッセージ・タイプは、任意のタイプの複数の添付ファイルを含むことができる。すべての添付ファイルは、一般にアクセス可能なURLを介してAPIペイロードで指定する必要があります。
インバウンド・メッセージの種類
インバウンドメッセージには6つのタイプがある:
textimageaudiovideovcardfile
テキスト以外のすべてのメッセージ・タイプは、1つ以上のメディアやファイルの添付を含むことができます。主な添付ファイルはメッセージ・タイプで指定されたタイプになります。追加の添付ファイルはどのタイプでもかまいません。添付ファイルは、受信メッセージのウェブフック・ペイロードで指定された URL を介してアクセスされます。
ステータスウェブフック
アウトバウンドメッセージとインバウンドメッセージに加えて、MMSチャネルはWebhookを介してステータスメッセージを提供します。これらのメッセージは、アウトバウンドメッセージの配信ステータスが変更されるとトリガーされます。送信メッセージで利用可能なステータスは以下のとおりです:
submitteddeliveredrejectedundeliverable
アウトバウンドメッセージ、インバウンドメッセージ、ステータスウェブフックの詳細は Messages API 仕様.
技術仕様
さまざまなアウトバウンドおよびインバウンドRCSメッセージ・タイプ、ならびにステータス・メッセージの認証、JSONペイロード・プロパティ、レスポンス、エラーの完全な詳細については、以下を参照のこと。 Messages API 仕様.
その他、注意すべき技術的な詳細がいくつかある。
対応メディアタイプ
画像、ビデオ、ファイルなどのメディアを含むことができるメッセージ・タイプでは、以下のメディア・タイプがサポートされています:
| メディア・タイプ | MIMEタイプ | ファイル拡張子 |
|---|---|---|
| 画像 | image/png | .png |
| 画像 | 画像/JPEG | .jpg/.jpeg |
| 画像 | イメージ/gif | .gif |
| 画像 | イメージ/bmp | .bmp |
| オーディオ | オーディオ | .amr |
| オーディオ | オーディオ/ミディ | .midi/.mid |
| オーディオ | オーディオ/wav | .wav |
| オーディオ | オーディオ/ac3 | .ac3 |
| オーディオ | オーディオ/mp3 | .mp3 |
| ビデオ | ビデオ/3pg | .3pg |
| ビデオ | ビデオ/mp4 | .mp4 |
| ビデオ | ビデオ/AVI | .avi |
| ビデオ | ビデオ/燃費 | .mpg |
| vカード | テキスト/Vカード | .vcard/.vcf |
| vカード | テキスト/x-vcard | .vcard/.vcf |
メッセージとメディアのサイズ
メッセージやメディアには、いくつかのサイズ制限やガイドラインがあります。
- テキストの文字数制限:
- テキスト・メッセージ・タイプのテキスト・フィールドに1600文字
- その他のMMSメッセージタイプのキャプションフィールドに300文字
- 推奨ファイルサイズ
- 200KBまで:配信の最適化。配信の遅延や圧縮を回避。
- 600KBまで:最も広いサポート。リジェクトや不達を回避。
- 1MB:IMIショートコードのみ。処理と配信の大幅な遅延、および/または圧縮と元のファイルの品質の低下につながる可能性があります。
TTL
TTLとはTime-To-Liveのことで、メッセージが正常に配信されるまでの時間である。もしそれが delivered TTL時間内に正常に送信された場合、そのメッセージは期限切れとみなされ、次のように処理される。 rejected TTLがサポートされている場合。
TTLは、秒単位の数値として ttl パラメータを使用する。MMSの場合、最小 ttl 値は 300 秒(5分)、最大は 259200 (または3日間)。
TTL値を超えた場合、メッセージには以下のステータスが与えられる。 rejected.A メッセージ・ステータス のエラー詳細が含まれます。 エラーコード 1360.