Compila tu primer agente

Agente Es una entidad programática que envía mensajes a los usuarios en nombre de una marca. El agente incluye cualquier interfaz con la que interactúan los usuarios y cualquier código o infraestructura necesarios para potenciar la interacción. Los agentes pueden proporcionar una experiencia simple de un solo sentido, como enviar una notificación, o bien pueden ser conversacionales y reaccionar a las respuestas de los usuarios en un intercambio de ida y vuelta.

Los usuarios interactúan con los agentes a través de una app de mensajería compatible con RCS, como Mensajes de Google, en sus dispositivos. En esta guía de inicio rápido, crearás un agente de RBM básico que pueda enviar un mensaje simple a un dispositivo de prueba y recibir una respuesta.

Requisitos previos

Antes de comenzar a usar tu agente, necesitarás los siguientes elementos:

• El nombre de la marca que representará tu agente
• Tu agente
  • Nombre
  • Región en la que operará el agente
  • Categoría de facturación
  • Caso práctico
• Un dispositivo Android con un número de teléfono activo
• Una máquina de desarrollo que pueda ejecutar código de muestra

Cómo configurar tu dispositivo de prueba

Para comunicarse con un agente de RBM que aún no se lanzó, un dispositivo de prueba debe estar habilitado para RCS, pero no todos los dispositivos Android pueden recibir mensajes RCS de forma predeterminada. Puedes verificar el estado de los RCS de tu dispositivo y, si es necesario, habilitarlos configurando tu dispositivo con versiones previas al lanzamiento de las apps de Mensajes y Servicios del operador.

Verifica el estado de los RCS de tu dispositivo

1. En la app de Mensajes, presiona el botón y, luego, Configuración.

2. Presiona Funciones de chat y busca el valor Estado.

   Si el Estado es Conectado, significa que los RCS están activos en tu dispositivo.

Próximos pasos

Si los RCS están activos en tu dispositivo, puedes configurar tu agente. Si los RCS están inactivos en tu dispositivo, debes habilitarlos antes de probar tu agente de RBM.

Configura tu agente

Los agentes de RBM usan la API de RBM para enviar mensajes, eventos y otras solicitudes a los usuarios. Cuando creas un agente, habilitas el acceso a la API de RBM y defines la información básica de tu agente.

Identifica la región del agente

Los agentes de RBM pueden existir en una de tres regiones: Norteamérica, Europa y Asia-Pacífico. La API de RBM admite tres extremos regionales para ayudar a las empresas a cumplir con los requisitos regionales y empresariales.

Cuando crees tu agente, elige la región según las reglamentaciones, los requisitos y la proximidad a los usuarios finales aplicables. Esta región determina desde dónde opera el agente y dónde se almacenan sus datos.

Si tú o tus usuarios previstos no se encuentran en esas regiones, elige la región que esté más cerca de ti para minimizar la latencia. Por ejemplo:

• Si te encuentras en Latinoamérica, elige la región de Norteamérica.
• Si estás en África, elige la región de Europa.
• Si estás en Australia, elige la región de Asia-Pacífico.

No decidas la región de tu agente en función de los operadores objetivo. Todas las regiones tienen acceso igualitario a los operadores de todo el mundo.

Nota: No puedes cambiar la región de tu agente después de crearlo.

Determina la categoría de facturación del agente

Cuando creas un agente de RBM, debes especificar su categoría de facturación según la forma en que el agente interactuará con los usuarios. Elige la categoría que mejor represente el comportamiento previsto de tu agente:

• Conversacional: Para agentes que participan en conversaciones de varios turnos con los usuarios.
• Mensaje básico o único: Para los agentes que envían mensajes sin esperar respuestas frecuentes.

Nota: Las dos categorías de facturación no conversacionales, Mensaje básico y Mensaje único, funcionan exactamente de la misma manera. Esta es una peculiaridad histórica que estamos trabajando para simplificar. Por ahora, no dudes en usar cualquiera de las categorías para tus mensajes no conversacionales, ya sean de texto sin formato o tarjetas enriquecidas. Se te facturará la tarifa estándar no conversacional. Para obtener más información, consulta Categorías de facturación de agentes.

Solo puedes cambiar la categoría de facturación de tu agente antes de lanzarlo. Envía un correo electrónico a [e-mail] si necesitas cambiar la categoría de facturación después del lanzamiento.

Para obtener más información sobre el modelo de facturación de RBM, consulta las Preguntas frecuentes sobre la facturación de RBM.

Identifica el caso de uso del agente

Cada agente de RBM debe tener un caso de uso predefinido. Esto ayuda a categorizar tu agente y aplicar las reglas de negocio correctas para brindar una buena experiencia del usuario. La RBM admite cuatro casos de uso:

• OTP: Son contraseñas de un solo uso necesarias para autenticar una cuenta de forma segura o confirmar una transacción.
• Transaccionales: Notificaciones, actualizaciones o alertas que comparten información directamente relevante para los servicios o productos existentes de un cliente, como alertas de actividades sospechosas en la cuenta, confirmaciones de compras y notificaciones de envío.
• Promocionales: Mensajes de ventas, marketing y promoción para clientes nuevos o existentes, con el objetivo de aumentar el reconocimiento, la participación y las ventas.
• Múltiples usos: Son conversaciones que combinan mensajes promocionales y transaccionales, como enviar una notificación de la cuenta seguida de una oferta de descuento o actualizar a un producto o servicio nuevo.

Cada caso de uso tiene reglas diferentes sobre lo que puedes enviar. Para obtener más información sobre cada caso de uso y encontrar el más adecuado para tu agente, consulta Elige el caso de uso adecuado para tu agente.

Una vez que envíes tu agente para el lanzamiento, no podrás cambiar el caso de uso. Consulta los casos de uso y las reglas comerciales de tu país antes de enviar tu agente.

Crea el agente

Sigue estas instrucciones para crear tu agente en la Consola de desarrolladores de Business Communications.

Nota: Para crear un agente con la API de RBM Management, consulta la documentación de Administra agentes.

Para crear un agente, haz lo siguiente:

1. Ve a la Consola de desarrolladores de Business Communications y accede con la Cuenta de Google de tu socio de RBM.
2. En la página principal, haz clic en + Crear agente.
3. En la ventana New RCS Business Messaging agent, especifica la siguiente información:
   • Marca que representa tu agente
   • Nombre del agente
   • Región de hosting
   • Categoría de facturación
   • Caso práctico
4. Haz clic en Create Agent.

Una vez que tu agente esté disponible, podrás agregar información de la empresa y de desarrollo de la marca. Consulta Crea tu agente.

Invita a tu dispositivo de prueba

Ahora que tienes un agente y tu dispositivo de prueba está habilitado para RCS, puedes invitarlo a probarlo.

1. En el panel de navegación de la izquierda, haz clic en Dispositivos.
2. En Agregar dispositivos de prueba, ingresa el número de teléfono de tu dispositivo y haz clic en Agregar.
3. En tu dispositivo de prueba, acepta la solicitud del verificador para tu agente.

Si no recibes una invitación en tu dispositivo de prueba, verifica que los RCS estén habilitados en él.

Envía un mensaje

Con un dispositivo de prueba registrado, tu agente ahora puede enviar mensajes.

Necesitas una clave de cuenta de servicio para autenticar de forma segura las llamadas a la API. Si aún no creaste una clave de cuenta de servicio para tu cuenta de socio, ahora es el momento de hacerlo.

En una terminal de la máquina de desarrollo, ejecuta el siguiente comando:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  }
}'

• Reemplaza REGION por asia, europe o us, según la región de tu agente.
• Reemplaza PHONE_NUMBER por el número de teléfono de tu dispositivo de prueba. Incluye el código de país, el código de área y una + al principio, pero no incluyas separadores. Por ejemplo, [phone].
• Reemplaza AGENT ID por el ID de tu agente, que se encuentra en la página Información del agente de la consola para desarrolladores de Business Communications.
• Reemplaza PATH_TO_SERVICE_ACCOUNT_KEY por la ruta de acceso a la clave que creaste antes.

Deberías recibir un mensaje "Hello, world!" de tu agente en el dispositivo de prueba. Si no recibes un mensaje en tu dispositivo de prueba, verifica que hayas ingresado correctamente el número de teléfono y la ruta de acceso a la clave de tu cuenta de servicio en el comando.

Para enviar diferentes tipos de mensajes, como respuestas sugeridas y tarjetas enriquecidas, consulta Cómo enviar mensajes.

Próximos pasos

Ahora que tu agente puede enviar mensajes a un dispositivo de prueba, es hora de compilar algo que se adapte a las necesidades de tu empresa. Obtén un agente de muestra en tu lenguaje preferido y sigue las instrucciones del archivo README de la muestra.

Una vez que hayas configurado el agente de muestra, revisa las prácticas recomendadas de RBM y obtén información sobre cómo los agentes envían y reciben mensajes.