Compila tu primer agente

Agente 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 unidireccional simple, como enviar una notificación, o 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 habilitada para RCS, como Mensajes de Google, en sus dispositivos. En esta guía de inicio rápido, crearás un agente básico de RCS para Empresas 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
• • 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

Configura tu dispositivo de prueba

Para comunicarse con un agente de RCS for Business que no se lanzó, un dispositivo de prueba debe tener habilitado el 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.

Cómo verificar el estado de los RCS en 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 de Estado.

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

Próximos pasos

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

Configura tu agente

Los agentes de RCS para empresas 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 del agente.

Identifica la región del agente

Los agentes de RCS para empresas pueden existir en una de las tres regiones: América del Norte, 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 comerciales.

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

Si tú o los usuarios previstos no se encuentran en esas regiones, elige la región más cercana para minimizar la latencia. Por ejemplo:

• Si te encuentras en Latinoamérica, elige la región de Norteamérica.
• Si te encuentras en África, elige la región de Europa.
• Si te encuentras 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 el mismo acceso 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 RCS para empresas, debes especificar su categoría de facturación según la forma en que interactuará con los usuarios. Elige la categoría que mejor se adapte al 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 el momento, puedes usar cualquiera de las dos 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 estándar de RCS o Business, consulta las preguntas frecuentes sobre facturación.

Identifica el caso de uso del agente

Cada agente de RCS Business debe tener un caso de uso predefinido. Esto ayuda a categorizar tu agente y aplicar las reglas comerciales adecuadas para una buena experiencia del usuario. RCS para empresas admite cuatro casos de uso:

• OTP: Son contraseñas de un solo uso que se requieren para autenticar de forma segura una cuenta o confirmar una transacción.
• Transaccionales: Son 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 compra y notificaciones de envío.
• Promocionales: Son mensajes de ventas, marketing y promocionales para clientes nuevos o existentes, con el objetivo de aumentar el reconocimiento, la participación y las ventas.
• De uso múltiple: Son conversaciones que combinan mensajes transaccionales y promocionales, como el envío de una notificación de la cuenta seguida de una oferta de descuento o la actualización a un nuevo producto o servicio.

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

Una vez que envíes tu agente para su 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 para desarrolladores de Business Communications.

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

Para crear un agente, haz lo siguiente:

1. Ve a Business Communications Developer Console y accede con tu Cuenta de Google de socio de RCS for Business.
2. En la página principal, haz clic en + Crear agente.
3. En la ventana New RCS Business Messaging, 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 es compatible con RCS, puedes invitar a tu dispositivo a probar tu agente.

1. En el menú 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 RCS esté habilitado 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 tu 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!"
  },
  "messageTrafficType": "PROMOTION"
}'

• 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 un + inicial, 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 de "Hello, world!" de tu agente en el dispositivo de prueba. Si no recibes un mensaje en tu dispositivo de prueba, verifica que hayas ingresado y formateado 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 Envía mensajes.

Próximos pasos

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

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