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
Esta función sólo está disponible en algunos mercados. Para saber si está disponible en su país, póngase en contacto con su gestor de Account.
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 de API de Vonage válidas (autenticación JWT)
Generar un enlace profundo
Envíe una solicitud
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."
}
| Parámetro | Tipo | Requerido | Descripción | Restricciones |
|---|---|---|---|---|
sender_id | cadena | Sí | Un identificador de remitente único en la plataforma de Vonage. | No puede estar en blanco, incluir espacios en blanco ni modificarse después de la creación. |
country | cadena | Sí | Código de país de dos letras de su cliente | Código ISO 3166-1 alfa-2 válido |
fallback_number | cadena | No | Número de teléfono para SMS fallback | Formato E.164 (p. ej, +14155552671) |
prefilled_message | cadena | No | Texto del mensaje que desea rellenar previamente | "Máximo 3.072 caracteres; no lo codifiques con URL" |
Respuesta:
{
"deep_link": "https://tools.vonage.com/rcs/v1/deeplink/egUQB..."
}
Incrustar el Deeplink
Una vez que tenga la URL del enlace profundo, puede incrustarla dondequiera que estén sus 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 su cliente:
- El cliente hace clic en su enlace profundo desde cualquier canal.
- El sistema comprueba su dispositivo (¿es compatible con RCS?).
- La aplicación RCS correcta se abre con su contenido pre-llenado.
- El cliente revisa y edita el mensaje si lo desea.
- El cliente envía el mensaje a su agente RCS.
- La conversación comienza en Messages API.
Límites técnicos
Longitud del mensaje
El mensaje precargado tiene un límite máximo de 3.072 caracteres. Sin embargo, le recomendamos que lo mantenga por debajo de 500 caracteres para una mejor experiencia de usuario. Los mensajes más cortos son 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
Los límites de tarifa estándar de la API de Channel Manager se aplican a la generación de enlaces profundos. Si realiza campañas de gran volumen en las que utiliza los mismos parámetros repetidamente, considere la posibilidad de almacenar en caché los enlaces profundos en lugar de generar nuevos para cada uso.