Liens profonds du RCS

Les liens profonds RCS sont des URL spéciales qui permettent aux utilisateurs de démarrer des conversations RCS avec votre entreprise directement depuis n'importe quel canal numérique. Lorsqu'un client clique sur un lien profond RCS, son appareil ouvre l'application de messagerie RCS avec votre entreprise déjà définie comme destinataire. Vous pouvez même pré-remplir un message pour eux.

L'API RCS Deeplink vous offre un point d'entrée en un clic qui emmène les clients de n'importe quel point de contact numérique directement dans une conversation RCS. Vous intégrez ces liens profonds dans des emails, des sites web, des applications mobiles ou des QR codes, et vos clients obtiennent :

  • Plus de démarches manuelles pour vous joindre
  • Un meilleur engagement
  • Action immédiate du matériel promotionnel
  • Prise en charge des appareils compatibles avec RCS et des SMS de secours

Cette fonction n'est disponible que sur certains marchés. Pour savoir si elle est disponible sur votre marché, veuillez contacter votre 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

Comment générer des liens profonds

Avant de générer des liens profonds RCS, assurez-vous que vous avez :

  • Un agent RCS actif enregistré auprès de Vonage
  • L'ID de l'expéditeur de votre agent RCS (ID du compte externe)
  • Informations d'identification valides pour l'API de Vonage (authentification JWT)

Générer un lien profond

Envoyez une requête

POST
au point de terminaison de l'API du gestionnaire de canaux :

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

Corps de la demande :

{
    "sender_id": "some-example-external-account-id",
    "country": "US",
    "fallback_number": "+14155552671",
    "prefilled_message": "Send me more information on this promotion."
}
Paramètres Type Exigée Description Contraintes
sender_id chaîne de caractères Oui Un identifiant unique de l'expéditeur sur la plateforme Vonage. Il ne peut pas être vide, inclure des espaces blancs ou être modifié après la création.
country chaîne de caractères Oui Code pays à deux lettres de votre client Code ISO 3166-1 alpha-2 valide
fallback_number chaîne de caractères Non Numéro de téléphone pour le repli par SMS Format E.164 (par ex, +14155552671)
prefilled_message chaîne de caractères Non Texte du message à pré-remplir "Max 3 072 caractères ; ne pas coder l'URL".

Réponse :

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

Intégrer le lien profond

Une fois que vous avez l'URL du lien profond, vous pouvez l'intégrer partout où se trouvent vos clients :

Lien HTML

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

Code QR

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

Campagne par courrier électronique

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

Application mobile

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

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

Voici ce que vit votre client :

  1. Le client clique sur votre lien profond à partir de n'importe quel canal.
  2. Le système vérifie l'appareil (supporte-t-il le RCS ?).
  3. La bonne application RCS s'ouvre avec votre contenu pré-rempli.
  4. Le client revoit et modifie le message s'il le souhaite.
  5. Le client envoie le message à votre agent RCS.
  6. La conversation commence dans Messages API.

Limites techniques

Disponibilité du RCS

La disponibilité de RCS varie en fonction de la zone géographique et de l'opérateur. Vérifier la dernière couverture du RCS pour connaître les disponibilités actuelles.

Longueur du message

Le message pré-rempli a une limite maximale de 3 072 caractères. Toutefois, nous vous recommandons de ne pas dépasser 500 caractères pour une meilleure expérience utilisateur. Les messages plus courts sont plus faciles à lire et à modifier par les clients avant d'être envoyés.

Codage des caractères

Nous prenons en charge le codage UTF-8 pour tous les messages. Lorsque vous envoyez votre demande, n'encodez pas l'URL de l'élément prefilled_message vous-même. Nous nous chargeons automatiquement de l'encodage lorsque nous générons le lien pour vous.

Comment fonctionne la génération de liens

Chaque fois que vous appelez l'API, celle-ci crée un lien profond crypté unique. Même si vous envoyez des demandes identiques, vous obtenez des liens différents à chaque fois. Chaque lien contient des données cryptées qui comprennent les informations relatives à votre agent et le contenu du message.

Limitation du taux

Les limites de taux standard de l'API du gestionnaire de canaux s'appliquent à la génération de liens profonds. Si vous menez des campagnes à fort volume dans lesquelles vous utilisez les mêmes paramètres de façon répétée, envisagez de mettre en cache les liens profonds au lieu d'en générer de nouveaux à chaque utilisation.

Plus d'informations