Enlaces RCS

Los Deeplinks RCS son URL especiales que permiten a los usuarios iniciar conversaciones RCS con tu empresa directamente desde cualquier canal digital. Cuando un cliente hace clic en un deeplink RCS, su dispositivo abre la aplicación de mensajería RCS con tu empresa ya configurada como destinatario. Incluso puedes rellenar previamente un mensaje para ellos.

La API RCS Deeplink le ofrece un punto de entrada con un solo clic que lleva a los clientes desde cualquier punto de contacto digital directamente a una conversación RCS. Si incrusta estos enlaces profundos en correos electrónicos, sitios web, aplicaciones móviles o códigos QR, sus clientes obtendrán:

• Se acabaron los pasos manuales para llegar hasta usted
• Mejor compromiso
• Acción inmediata a partir de material promocional
• Compatibilidad con dispositivos habilitados para RCS y SMS fallback

Cómo generar Deeplinks

Antes de generar enlaces profundos RCS, asegúrese de que tiene:

• Un agente RCS activo registrado con Vonage
• ID de remitente de su agente RCS (ID de cuenta externa)
• Credenciales válidas de la API de Vonage (autenticación JWT)

Generar un enlace profundo

Envíe una solicitud POST al punto final de enlace profundo de la API de Channel Manager:

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

Cuerpo de la solicitud:

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

Respuesta:

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

Incrustar el Deeplink

Una vez que tengas la URL del enlace directo, puedes insertarla allí donde se encuentren tus clientes:

Enlace HTML

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

Código QR

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

Campaña por correo electrónico

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

Aplicación móvil

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

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

Esto es lo que experimenta tu cliente:

1. El cliente hace clic en su enlace profundo desde cualquier canal.
2. El sistema comprueba su dispositivo (¿es compatible con RCS?).
3. La aplicación RCS correcta se abre con su contenido pre-llenado.
4. El cliente revisa y modifica el mensaje si lo desea.
5. El cliente envía el mensaje a su agente RCS.
6. La conversación comienza en Messages API.

Límites técnicos

Longitud del mensaje

El mensaje predefinido tiene un límite máximo de 3.072 caracteres. No obstante, te recomendamos que no superes los 500 caracteres para ofrecer una mejor experiencia de usuario. Los mensajes más cortos resultan más fáciles de leer y editar para los clientes antes de enviarlos.

Codificación de caracteres

Admitimos la codificación UTF-8 para todos los mensajes. Cuando envíe su solicitud, no codifique el URL prefilled_message usted mismo. Nosotros nos encargamos automáticamente de toda la codificación cuando generamos el enlace para usted.

Cómo funciona la generación de enlaces

Cada vez que se llama a la API, se crea un enlace cifrado único. Aunque envíe solicitudes idénticas, obtendrá enlaces diferentes cada vez. Cada enlace contiene datos cifrados que incluyen la información de tu agente y el contenido del mensaje.

Limitación de velocidad

A la generación de enlaces profundos se aplican los límites de rate estándar de la API de Channel Manager. Si estás llevando a cabo campañas de gran volumen en las que utilizas los mismos parámetros repetidamente, plantéate almacenar los enlaces profundos en caché en lugar de generar otros nuevos cada vez que los utilices.

Para más información

• Referencia de la API de Channel Manager
• Guía del Agente RCS