Los usuarios pueden iniciar una conversación con tu agente desde una URL. El lugar en el que coloques la URL depende de tu caso de uso. Puedes colocarla en un correo electrónico, un sitio web, una app o una ubicación física, en cualquier lugar donde puedas incorporar la URL como un botón, un vínculo o un código QR.
Navegar manualmente a la URL de un agente (por ejemplo, copiándola y pegándola) no funciona debido a las medidas de seguridad del navegador. Debes incorporar la URL en un botón, un vínculo o un código QR.
La experiencia del usuario
Cuando el usuario abre la URL de tu agente, hay tres resultados posibles: exitoso, alternativo o de error.
Listo
El usuario inicia una conversación de RBM exitosa. Para que la conversación comience correctamente, se deben cumplir todos los siguientes criterios:
- Mensajes de Google está instalado en su dispositivo (versión mínima
messages.android_20241029_00
). - Los chats RCS están habilitados en Mensajes.
- Tu agente de RBM se inicia en el operador del usuario.
Resguardo
Se redirecciona al usuario a un número de teléfono o código corto de resguardo. Esto ocurre si no se cumple ningún criterio de éxito y se proporcionó un número de resguardo en la URL.
Error
El usuario ve un mensaje de error y un vínculo al Centro de ayuda de Mensajes para explicar por qué es posible que el agente no esté disponible y para ayudar al usuario a solucionar el problema.
Esto ocurre si no se cumple ningún criterio de éxito y no se proporcionó un número de resguardo.
Crea la URL del agente
Puedes crear URLs en dos formatos, como se define en el apartado 3.6.3.4 de la sección GSMA RCC.07 v.14.0.
Por motivos de seguridad, estos formatos no admiten sugerencias preproporcionadas para el usuario dentro de la URL.
Formato 1: Usa solo el ID del servicio
sms:bot%40botplatform.example.com?body=tell%20me%20about%20checking%20accounts
sms:bot%40botplatform.example.com
: Es el ID de servicio único de tu agente.&body=tell%20me%20about%20checking%20accounts
: Es un mensaje precompletado opcional que el usuario verá cuando abra la conversación de RBM con tu agente.
Limitación: Este formato no puede incluir un número de teléfono alternativo. Si no se puede establecer una conversación de RBM, el usuario recibirá un mensaje de error.
Formato 2: Usa un número de teléfono y un ID de servicio
sms:+15012011657?service_id=bot%40botplatform.example.com&body=tell%20me%20about%20checking%20accounts
+15012011657
: Es el número de teléfono en formato E.164 o un código corto válido asociado con tu agente.service_id=bot%40botplatform.example.com
: Es el ID de servicio único de tu agente.body=tell%20me%20about%20checking%20accounts
: Es un mensaje prepropagado opcional que el usuario verá cuando abra la conversación de RBM con tu agente.
Mensaje completado previamente
Para proporcionar una experiencia del usuario más fluida, puedes completar previamente el campo de entrada de mensajes cuando se abre la conversación de la RBM. Esto permite que los usuarios presionen el botón de enviar para enviar rápidamente un mensaje relevante.
Para incluir un mensaje precompletado, usa el parámetro body
en la URL. El parámetro cuerpo debe estar codificado como URL. Por ejemplo, los espacios deben reemplazarse por %20
.
El mensaje debe alinearse con la intención del usuario y los objetivos de tu marca. Este es un ejemplo de una marca de bienestar: sms:bot%40botplatform.example.com?body=make%20an%20appointment.
Cuando el usuario presiona este vínculo, su app de mensajería abrirá el chat con el mensaje prellenado "Solicitar una cita".
Prácticas recomendadas
Cuando incorpores códigos QR en los materiales de tu marca, siempre crea un vínculo corto que redireccione a los usuarios a la URL del agente (por ejemplo, https://short.link/abc123). Estos son los beneficios de usar un vínculo corto:
- Preparación para el futuro: Si es necesario, puedes actualizar la URL del agente detrás del vínculo corto sin necesidad de volver a imprimir los materiales con un código QR nuevo.
- Resguardo sin interrupciones: Evita que los usuarios se confundan con la URL si se los redirecciona a una opción de resguardo.