Crea tu primer agente

Requisitos previos

• Si te registraste para obtener una cuenta de socio antes del 7 de marzo de 2022, debes habilitar la API de Business Messages. Consulta Habilita la API de Business Communications y la API de Business Messages.

Crea tu agente

En esta guía, se explica cómo crear un agente con una aplicación de ejemplo. La muestra proporciona una forma rápida de explorar la funcionalidad de un agente y puede servir como punto de partida para el desarrollo de tu agente. Si deseas modificar una aplicación existente para incluir un agente, la muestra ofrece un buen modelo para la lógica de tu aplicación.

En esta guía de inicio rápido, harás lo siguiente:

• Regístrate como socio
• Crea una marca y un agente
• De forma opcional, explora las funciones en una conversación con el bot de ayuda de Business Messages
• Configura tu agente para enviar y recibir mensajes

Para crear un agente sin usar la muestra, consulta Crea tu agente.

Regístrate como socio

1. Abre la consola para desarrolladores de Business Communications.
2. En Business Messages, haz clic en Crear cuenta de socio.

3. Ingresa tu información de socio:

   Campo	Valor
   Tu nombre	Su nombre completo
   Nombre del socio	Nombre de tu organización
   Sitio web del socio	Sitio web de tu organización
   Región	La región en la que quieres alojar el servicio de Business Messages

4. Revisa y acepta las Condiciones del Servicio de Business Messages.

5. Haz clic en Crear.

Ahora te registraste como socio de Business Messages. Se creó un nuevo proyecto de Google Cloud para ti con las APIs de Business Messages y Business Communications habilitadas. No tienes acceso a este proyecto y no interferirá con ninguno de tus proyectos de Google Cloud existentes.

Ahora tienes acceso a las APIs de Business Messages y Business Communications.

Crea una cuenta de servicio

1. En la página principal de la consola para desarrolladores de Business Communications, haz clic en Partner account settings.
2. En el panel de navegación izquierdo, haz clic en Cuenta de servicio.

3. Haz clic en Crear clave y, luego, en Crear.

   Tu navegador descarga la clave de la cuenta de servicio. Guárdalos en un lugar seguro. Necesitarás esta clave más adelante para implementar una aplicación web y acceder a las APIs de Business Messages y Business Communications en el futuro.

Crea una marca y un agente

Un agente es una representación conversacional de una marca, la entidad conversacional con la que interactúan los usuarios. Creas una marca para representar a la empresa y creas un agente para que los consumidores puedan conectarse con ella mediante conversaciones.

1. Abre la Consola para desarrolladores de Business Communications y accede con tu Cuenta de Google de Business Messages.
2. Haz clic en Create Agent.
3. En Tipo de agente, selecciona Business Messages.
4. Ingresa los valores para Brand name y Agent name.
5. Realiza una de las siguientes acciones:
   • Para tener una conversación con tu agente en la que puedas explorar las funciones disponibles, selecciona Habilitar el bot de ayuda de Business Messages.
   • Para personalizar tu agente y prepararlo para el manejo de mensajes, anula la selección de Habilitar el bot de ayuda de Business Messages.
6. Haz clic en Create Agent.

Si habilitaste el bot de ayuda de Business Messages, puedes iniciar una conversación de inmediato. De lo contrario, continúa con la configuración de tu agente para el manejo de mensajes.

Explora las funciones con el bot de ayuda de Business Messages

El bot de ayuda de Business Messages te permite iniciar rápidamente una conversación con tu agente para que descubras lo que ofrece la plataforma. Habilitar el bot de ayuda es opcional, pero se recomienda cuando creas tu primer agente.

El bot de ayuda te permite hacer lo siguiente:

• Explora las funciones enriquecidas
• Aprende a implementar funciones
• Busca recursos para la configuración del agente

Cuando el bot de ayuda está habilitado, envía y recibe mensajes para tu agente, sin necesidad de un webhook. Debes inhabilitar el bot de ayuda antes de que puedas configurar un webhook o habilitar Dialogflow para administrar los mensajes de los usuarios.

Cómo iniciar una conversación con el bot de ayuda

Una vez que habilites el bot de ayuda de Business Messages, podrás iniciar una conversación. Se abrirá un diálogo inmediatamente después de que se cree el agente para ayudarte a comenzar.

Para interactuar con el bot de ayuda, sigue estos pasos desde este diálogo:

1. Accede a las URLs de prueba del agente. Existen varias formas de hacerlo:

   • Haz clic en el botón de Android o en el de iOS. Luego, escanea el código QR con el dispositivo móvil correspondiente y haz clic en Launch. Como alternativa, haz clic en Copiar URL de Android o Copiar URL de iOS para copiar la URL de prueba del agente.
   • Haz clic en Enviar para enviar las URLs a tu dirección de correo electrónico.

2. Abre la URL en tu dispositivo móvil. (Los dispositivos iOS requieren la app de Google Maps).

Inhabilitar el bot de ayuda

Antes de personalizar tu agente y prepararlo para su lanzamiento, debes inhabilitar el bot de ayuda de Business Messages.

Para inhabilitar el bot de ayuda, sigue estos pasos:

1. Abre la Consola para desarrolladores de Business Communications.
2. Selecciona el agente.
3. En el panel de navegación izquierdo, haz clic en Integraciones.
4. En Bot de ayuda, haz clic en Inhabilitar.

Cuando el bot de ayuda está inhabilitado, ya no envía ni recibe mensajes para tu agente. Ahora puedes configurar tu agente para que controle el flujo de mensajes.

Configura tu agente para el control de mensajes

En esta guía, implementarás un Echo Bot en Google Cloud Platform (GCP) con un webhook diseñado para procesar los mensajes de los usuarios.

Echo Bot es una aplicación de ejemplo que repite mensajes al usuario. Te permite experimentar con funciones enriquecidas, como acciones sugeridas y tarjetas enriquecidas, en una conversación con tu agente. También puedes usar Echo Bot como punto de partida para desarrollar tu agente.

Completarás los siguientes pasos:

• Implementa la muestra de Echo Bot en GCP
• Cómo configurar la URL de webhook para tu cuenta de socio de Business Messages
• Proporciona información básica sobre tu agente

Al final de esta guía, tu agente estará listo para enviar y recibir mensajes.

Implementa la aplicación web en GCP

Business Messages reenvía los mensajes de los usuarios a un webhook de tu infraestructura. En esta guía, implementarás el código fuente de muestra de Echo Bot en un webhook preconfigurado. Si ya tienes una infraestructura web que aprovechar para recibir mensajes, puedes crear un webhook nuevo en ese servicio web, pero deberás configurar la lógica tú mismo. Consulta Configura tu webhook a nivel de socio para obtener más detalles.

Crea un entorno en la nube

Necesitas un entorno de nube para implementar la muestra de Echo Bot.

Para crear un proyecto de GCP como entorno de nube, sigue estos pasos:

1. Abre el Selector de proyectos de la consola de Google Cloud.

   Si nunca creaste un proyecto de Google Cloud, deberás Aceptar las Condiciones y los Servicios.

2. Haz clic en Crear proyecto.

3. Ingresa un nombre y una ubicación para tu nuevo proyecto

   • El ID del proyecto se genera automáticamente y aparece debajo del nombre del proyecto.
   • En el campo Ubicación, haz clic en Explorar para mostrar las posibles ubicaciones de tu proyecto. Si no puedes encontrar tu organización de Google Workspace, significa que no accediste a una cuenta de Google Workspace. Puedes crear un proyecto sin una organización, pero algunas funciones están limitadas. Consulta Beneficios del recurso de organización para obtener más información.

4. Haz clic en Crear.

5. Haz clic en menuMenú.

6. Haga clic en Facturación.

7. Haz clic en Vincular una cuenta de facturación.

8. Crea una nueva cuenta de facturación o agrega una existente al proyecto. Consulta Funciones del programa gratuito de Google Cloud para comprender las opciones de pago.

Implementa la muestra de Echo Bot

1. Instala la CLI de gcloud Lo utilizarás para implementar el código de muestra en Google Cloud.

2. Descarga y extrae la muestra de Echo Bot (Node.js, Java, Python).

3. Copia el archivo de credenciales JSON que descargaste en Crea una cuenta de servicio en la carpeta de recursos de la muestra y cambia el nombre de las credenciales a “bm-agent-service-account-credentials.json”. La ruta a este archivo de credenciales depende de la muestra que descargaste.

   Node.js

   ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
   

   Java

   ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json
   

   Python

   ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
   

4. En una terminal, navega hasta el directorio full_sample de la muestra.

5. Ejecuta los siguientes comandos en una terminal para implementar la muestra:

   Node.js

   gcloud config set project PROJECT_ID
   gcloud app create
   gcloud app deploy
   

   PROJECT_ID es el ID del proyecto que creaste en Crea un entorno de Cloud. El ID del proyecto aparece en el panel del proyecto en Google Cloud.

   Java

   gcloud config set project PROJECT_ID
   gcloud app create
   mvn appengine:deploy
   

   PROJECT_ID es el ID del proyecto que creaste en Crea un entorno de Cloud. El ID del proyecto aparece en el panel del proyecto en Google Cloud.

   Python

   gcloud config set project PROJECT_ID
   gcloud app create
   gcloud app deploy
   

   PROJECT_ID es el ID del proyecto que creaste en Crea un entorno de Cloud. El ID del proyecto aparece en el panel del proyecto en Google Cloud.

6. Toma nota de la URL de la aplicación implementada en el resultado del último comando. Esta es la base de la URL de tu webhook:

   Deployed service [default] to [https://PROJECT_ID.appspot.com]

Configura tu webhook

Ahora que el Echo Bot está implementado, debes especificar una URL de webhook (que tú operas) para comenzar a recibir mensajes.

1. Abre la Configuración de la cuenta en la consola para desarrolladores de Business Communications.
2. Asegúrate de que se haya seleccionado la cuenta de socio correcta.
3. En URL de webhook de Business Messages, haz clic en Configurar.

4. En URL de extremo de webhook, ingresa la URL de tu aplicación y “/devolución de llamada”.

   El extremo seguirá el formato: “https://PROJECT_ID.appspot.com/callback”.

   Este extremo está predefinido en la lógica de la aplicación de la muestra que implementaste en GCP.

5. En Play Console, haz clic en Verificar.

   Cuando Business Messages verifique tu webhook, se cerrará el diálogo.

Para configurar tu webhook con la API de Business Communications, consulta Ejemplo: Actualiza la URL de webhook.

Puedes usar el framework de prueba de Business Messages para probar si tu webhook responde correctamente a las cargas útiles de Business Messages.

Ingresa la información del agente

Proporciona información básica para completar la configuración de tu agente.

1. Abre la Consola para desarrolladores de Business Communications.
2. En el panel de navegación izquierdo, haz clic en Información del agente.

3. Actualiza los valores como quieras o usa las siguientes sugerencias:

   Campo	Valor
   Mensaje de bienvenida	Te damos la bienvenida a la conversación sobre Echo Bot.
   Política de Privacidad	https://policies.google.com/privacy

4. Haz clic en Guardar.

Iniciar la conversación

Para interactuar con el Echo Bot, sigue estos pasos:

1. Abre la Consola para desarrolladores de Business Communications.
2. En el panel de navegación izquierdo, haz clic en Información del agente.
3. En URL de prueba del agente, haz clic en el botón Android o iOS.

4. Escanea el código QR con el dispositivo móvil correspondiente o haz clic en Copy Android URL o Copy iOS URL para copiar la URL de prueba del agente.

   También puedes hacer clic en Enviar para enviar las URLs a tu dirección de correo electrónico.

5. Abre la URL en tu dispositivo móvil. (Los dispositivos iOS requieren la app de Google Maps).

El mensaje de bienvenida del agente te saluda. En este punto, puedes interactuar con Echo Bot. Repite los mensajes que te envías. Además, puedes invocar funciones enriquecidas con el envío de cadenas específicas: "carrusel", "tarjeta", "chips".

Próximos pasos

Ahora que creaste tu primer agente, obtén más información sobre Business Messages y qué más puedes hacer en la plataforma.

• Obtén más información sobre cómo funciona Business Messages.

• Consulta los requisitos y lineamientos de Business Messages.

• Modifica el Echo Bot y responde con tu lógica empresarial revisando cómo recibir mensajes.

• Verifica tu infraestructura.

• Inicia más agentes y ubicaciones.