RCSテキストおよびメディア・メッセージ・タイプ

Vonage Messages APIでRCSを使用すると、標準的なSMSをはるかに超える顧客体験を向上させる、インパクトのあるリッチなメッセージを送信できます。このガイドでは、テキストとメディアを配信するRCSメッセージタイプに焦点を当て、それぞれを効果的に使用するタイミングと方法を理解するのに役立ちます。

Messages APIでは、以下のRCSテキストおよびメディア・メッセージ・タイプがサポートされている：

text
image
video
file

各メッセージ・タイプは同じ必須(to, from, channel, message_type)およびオプション(webhook_url, client_ref, ttl, failover)のパラメーターがある。

テキストメッセージ

テキストメッセージは、最も基本的で柔軟なRCSメッセージタイプです。メディアを必要としない、シンプルで情報量の多い、または時間的制約のあるメッセージに最適です。アップデートやサービスアラートの配信、視覚的なプロモーションを伴わないトランザクションメッセージの送信、注文の確認などに使用します。

テキストメッセージには制限があります：

について text パラメータは3072文字に制限されている。

{
   "message_type": "text",
   "text": "Hello from Vonage!",
   "to": "447700900000",
   "from": "Vonage",
   "channel": "rcs"
}

RCSメッセージに message_type の text も受け付ける。 suggestions 配列をトップレベルのパラメータとして指定します。この配列には、以下を定義する最大11個のサジェストオブジェクトを含めることができます。推奨される返答および/または行動.

画像メッセージ

イメージメッセージは、プロモーション用グラフィック、QRコード、スクリーンショットなどの高解像度ビジュアルを送信し、より魅力的なインタラクションをサポートします。新製品の告知、ビジュアルイベントへの招待、ビジュアルガイドによるコンテンツのサポートなどにご利用ください。

画像メッセージには制限があります：

画像のURLは一般に公開されているものでなければならない。
提供される画像は JPG または PNG.

{
   "message_type": "image",
   "image": {
      "url": "https://example.com/image.jpg"
   },
   "to": "447700900000",
   "from": "Vonage",
   "channel": "rcs"
}

ビデオメッセージ

ビデオメッセージでは、より複雑なアイデアを魅力的なフォーマットで伝える短いビデオクリップを送信できます。製品のデモやチュートリアル、イベントの告知、パーソナライズされたメッセージなどにビデオメッセージをご利用ください。

ビデオメッセージにはいくつかの制限がある：

提供されるビデオは .mp4, .webmあるいは .m4v フォーマット
動画を短くし、モバイルデバイスに最適化する

{
   "message_type": "video",
   "video": {
      "url": "https://example.com/video.webm"
   },
   "to": "447700900000",
   "from": "Vonage",
   "channel": "rcs"
}

ファイルメッセージ

ファイルメッセージでは、PDFなどのダウンロード可能なドキュメントを送信できるため、フォーム、請求書、参考資料などを簡単に共有できます。ファイルメッセージを使用して、eチケット、契約書、請求書、オンボーディングドキュメント、またはあらゆる法的フォームを送信できます。

ファイルメッセージには制限がある：

PDFのみ対応。
ファイルは、一般にアクセス可能なURLにホストされていなければなりません。
モバイルデータの使用量とパフォーマンスを考慮して、ファイルサイズを考慮する。

{
   "message_type": "file",
   "file": {
      "url": "https://example.com/file.pdf"
   },
   "to": "447700900000",
   "from": "Vonage",
   "channel": "rcs"
}

コード・スニペット

以下は、さまざまなタイプのメッセージ・リクエストを送信するためのコード・スニペットのリストです：