RCSディープリンクス

RCSディープリンクは、ユーザーがあらゆるデジタルチャネルから直接貴社のビジネスとRCS会話を開始できる特別なURLです。顧客がRCSディープリンクをクリックすると、そのデバイスでRCSメッセージングアプリが開き、すでに貴社が受信者として設定されています。メッセージを事前に入力することもできます。

RCS Deeplink APIは、あらゆるデジタルタッチポイントから顧客を直接RCS Conversationに導くワンクリックのエントリーポイントを提供します。電子メール、ウェブサイト、モバイルアプリ、またはQRコードにこれらのディープリンクを埋め込むと、顧客は以下を得られます：

• お客様との連絡を手作業で行う必要がない
• エンゲージメントの向上
• 販促物からの即時アクション
• RCS対応デバイスとSMSフォールバックの両方をサポート

ディープリンクの生成方法

RCSディープリンクを生成する前に、以下を確認してください：

• Vonageに登録されたアクティブなRCSエージェント
• RCSエージェントの送信者ID（外部アカウントID）
• 有効なVonage API認証情報（JWT認証）

ディープリンクの生成

チャネルマネージャAPIディープリンクエンドポイントに

https://api.nexmo.com/v1/channel-manager/rcs/deeplink/generate

リクエスト・ボディ

{
    "sender_id": "some-example-external-account-id",
    "country": "US",
    "fallback_number": "+14155552671",
    "prefilled_message": "Send me more information on this promotion."
}

反応だ：

{
    "deep_link": "https://tools.vonage.com/rcs/v1/deeplink/egUQB..."
}

ディープリンクを埋め込む

ディープリンクのURLを手に入れたら、顧客がどこにいても埋め込むことができる：

HTMLリンク

<a href="{RETURNED_DEEPLINK_URL}">
  Chat with us about our Spring Sale!
</a>

QRコード

// Use the complete URL from the API response
const deeplinkUrl = response.deep_link;
const qrCode = generateQRCode(deeplinkUrl);

メールキャンペーン

<button style="background: #007bff; color: white; padding: 12px 24px;">
  <a href="{RETURNED_DEEPLINK_URL}" 
     style="color: white; text-decoration: none;">
    Start a Conversation
  </a>
</button>

モバイルアプリ

// React Native example
const deeplinkUrl = response.deep_link;

<TouchableOpacity onPress={() => Linking.openURL(deeplinkUrl)}>
  <Text>Contact Support</Text>
</TouchableOpacity>

ここに、あなたの顧客が経験することがある：

1. 顧客はどのチャネルからでもあなたのディープリンクをクリックします。
2. システムがデバイスをチェックする（RCSをサポートしているか？）
3. 正しいRCSアプリケーションが、あらかじめ入力した内容で開きます。
4. 顧客はメッセージを確認し、必要であれば編集する。
5. お客様はRCSエージェントにメッセージを送信します。
6. Messages APIで会話が始まる。

技術的限界

メッセージの長さ

メッセージの最大文字数は3,072文字です。しかし、より良いユーザーエクスペリエンスのために、500文字以下にすることをお勧めします。より短いメッセージは、お客様が送信前に読みやすく、編集しやすくなります。

文字エンコーディング

すべてのメッセージでUTF-8エンコードをサポートしています。リクエストを送信する際、URLエンコードせずに prefilled_message 自分でエンコードしてください。リンクを生成する際、エンコーディングはすべて当社が自動的に行います。

リンク生成の仕組み

APIを呼び出すたびに、一意の暗号化されたディープリンクが作成される。同じリクエストを送信しても、毎回異なるリンクを取得します。各リンクには、あなたのエージェント情報とメッセージコンテンツを含む暗号化されたデータが含まれています。

レート制限

ディープリンク生成には、標準的なチャネルマネージャAPIのレート制限が適用されます。同じパラメータを繰り返し使用するような大量のキャンペーンを実行している場合は、使用するたびに新しいパラメータを生成するのではなく、ディープリンクをキャッシュすることを検討してください。

詳細情報

• チャネルマネージャAPIリファレンス
• RCSエージェントビルダーガイド