RCS Deeplinks

RCS Deeplinks sind spezielle URLs, die es Nutzern ermöglichen, RCS-Konversationen mit Ihrem Unternehmen direkt von jedem digitalen Kanal aus zu starten. Wenn ein Kunde auf einen RCS-Deplink klickt, öffnet sein Gerät die RCS-Messaging-App, in der Ihr Unternehmen bereits als Empfänger festgelegt ist. Sie können sogar eine Nachricht für sie vorausfüllen.

Die RCS Deeplink-API bietet Ihnen einen Ein-Klick-Einstiegspunkt, der Kunden von jedem digitalen Touchpoint direkt in eine RCS-Konversation führt. Sie betten diese Deeplinks in E-Mails, Websites, mobile Apps oder QR-Codes ein, und Ihre Kunden erhalten:

  • Keine manuellen Schritte mehr, um Sie zu erreichen
  • Besseres Engagement
  • Sofortige Maßnahmen aus Werbematerialien
  • Unterstützung sowohl für RCS-fähige Geräte als auch für SMS-Fallback

Diese Funktion wird nur in ausgewählten Märkten unterstützt. Um festzustellen, ob diese Funktion in Ihrem Markt verfügbar ist, wenden Sie sich bitte an Ihren Account Manager.

Yes

No

You Create a Deeplink

You Embed It Anywhere

Customer Clicks

Messaging App Opens

Device Supports RCS?

RCS Conversation Starts

SMS Conversation Starts

Message Pre-filled & Ready

Customer Reviews & Sends

Bevor Sie RCS Deeplinks erzeugen, stellen Sie sicher, dass Sie diese haben:

  • Ein aktiver RCS-Agent, der bei Vonage registriert ist
  • Absender-ID Ihres RCS-Agenten (externe Account-ID)
  • Gültige Vonage-API-Anmeldedaten (JWT-Authentifizierung)

Senden Sie eine

POST
-Anforderung an den Deeplink-Endpunkt der Channel Manager-API:

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

Anfrage Körper:

{
    "sender_id": "some-example-external-account-id",
    "country": "US",
    "fallback_number": "+14155552671",
    "prefilled_message": "Send me more information on this promotion."
}
Parameter Typ Erforderlich Beschreibung Zwänge
sender_id String Ja Eine eindeutige Absenderkennung auf der Vonage-Plattform. Sie darf nicht leer sein, keine Leerzeichen enthalten und nach der Erstellung nicht geändert werden.
country String Ja Zweibuchstabiger Ländercode für Ihren Kunden Gültiger ISO 3166-1 Alpha-2-Code
fallback_number String Nein Rufnummer für SMS-Rückruf E.164-Format (z.B., +14155552671)
prefilled_message String Nein Nachrichtentext, der vorausgefüllt werden soll "Maximal 3.072 Zeichen; keine URL-Kodierung"

Antwort:

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

Sobald Sie die Deeplink-URL haben, können Sie sie überall dort einbetten, wo Ihre Kunden sind:

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

QR-Code

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

E-Mail-Kampagne

<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>

Mobile App

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

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

Das ist es, was Ihr Kunde erlebt:

  1. Der Kunde klickt von einem beliebigen Kanal auf Ihren Deeplink.
  2. Das System überprüft das Gerät (Unterstützt es RCS?).
  3. Die richtige RCS-Anwendung öffnet sich mit den von Ihnen vorausgefüllten Inhalten.
  4. Der Kunde überprüft und bearbeitet die Nachricht, wenn er möchte.
  5. Der Kunde sendet die Nachricht an Ihren RCS-Agenten.
  6. Die Konversation beginnt in der Messages API.

Technische Grenzwerte

Länge der Nachricht

Die vorausgefüllte Nachricht hat eine maximale Länge von 3.072 Zeichen. Wir empfehlen Ihnen jedoch, die Nachricht auf weniger als 500 Zeichen zu beschränken, um die Benutzerfreundlichkeit zu erhöhen. Kürzere Nachrichten sind für Kunden leichter zu lesen und zu bearbeiten, bevor sie gesendet werden.

Zeichencodierung

Wir unterstützen die UTF-8-Kodierung für alle Nachrichten. Wenn Sie Ihre Anfrage senden, verschlüsseln Sie die URL nicht mit prefilled_message selbst. Wir übernehmen die gesamte Kodierung automatisch, wenn wir den Link für Sie erstellen.

Jedes Mal, wenn Sie die API aufrufen, wird ein eindeutiger verschlüsselter Deeplink erstellt. Selbst wenn Sie identische Anfragen senden, erhalten Sie jedes Mal andere Links. Jeder Link enthält verschlüsselte Daten, die Ihre Agenteninformationen und den Inhalt der Nachricht enthalten.

Ratenbegrenzung

Für die Deeplink-Generierung gelten die Standard-API-Ratenbeschränkungen von Channel Manager. Wenn Sie Kampagnen mit hohem Volumen durchführen, bei denen Sie dieselben Parameter wiederholt verwenden, sollten Sie erwägen, die Deeplinks zwischenzuspeichern, anstatt für jede Verwendung neue zu generieren.

Weitere Informationen