Cómo iniciar una conversación desde una URL

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

Mensaje completado previamente

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.