Se puede configurar el bot para que se comunique con los usuarios a través de Google Chat. Para ello:

1. Primero, cree un proyecto de Google y genere la clave de la API de Google. 
2. Introduzca Ingrese la clave de la API y el  número de proyecto de Google Chat (ID de aplicación) en la página de configuración de Google Hangouts de Bot Builder (Consola de Administración de Luma) de Luma.
3. Luego, especifique la dirección URL del bot (que se denomina Message URL [URL del mensaje] en Bot Builder [Consola de Administración de Luma]) en la API de Google Chat. 

Crear un proyecto de Google Chat

Los pasos siguientes le ayudarán a generar la clave de la API que necesita para permitir que el bot se comunique con sus usuarios a través de Google Chat.

1. Para generar las API para Google Chat, vaya a la página https://console.developers.google.com/project/_/apiui/apis/library .
2. Inicie sesión en la plataforma de Google Cloud con sus credenciales de inicio de sesión. 
   
3. Una vez que ha iniciado la sesión correctamente, se abrirá la siguiente página de las API de Google.
   
4. Si es necesario, haga clic en Seleccionar para elegir alguno de los proyectos existentes, o bien, definir un nuevo proyecto en el menú Biblioteca.
   1. Haga clic en Create (Crear) para abrir la página New Project (Proyecto nuevo) y especifique los siguientes detalles:
      

   2. Introduzca Ingrese el Nombre de proyecto único. Google genera y muestra el ID de proyecto único, que no se puede cambiar una vez que se crea el proyecto. El ID de proyecto es el identificador único global para el proyecto.

   3. El sistema muestra automáticamente los detalles de la organización en función de los datos de inicio de sesión.

   4. Si hay una única ubicación, se mostrarán los detalles automáticamente. Si hay varias ubicaciones disponibles, en el campo Location (Ubicación), haga clic en Browse (Examinar) y seleccione la organización o la carpeta principal.
   5. Haga clic en Create (Crear) para crear un nuevo proyecto o haga clic en Cancel (Cancelar).
5. Una vez creado el nuevo proyecto, se abrirá la página siguiente de la biblioteca de la API para el proyecto nuevo.
   
6. En la barra de búsqueda, busque la API de Google Chat.
   
7. Haga clic en la  API de Google Chat para abrirla en una pestaña independiente.
8. Haga clic en Enable (Activar) para activar la API de Google Chat.
   
9. Aparecerá la página API de Hangouts Chat. En la pestaña Overview (Descripción general), haga clic en Create Credentials (Crear credenciales) para abrirla en una página independiente.
   

10. En la página Credentials (Credenciales), haga clic en API Key (Clave de API) en el menú Create Credential (Crear credenciales) para abrirla en una página independiente.

    Info
    title Nota
    Se puede utilizar la clave de la API en este proyecto y de cualquier API compatible. Las claves de la API se utilizan para identificar el proyecto de llamada (en este caso, el bot) que realiza una llamada a una API (en este caso, Google Chat). También comprueba si el bot de llamadas dispone de acceso para llamar a la API y si tiene activada la API en el proyecto. Las claves de la API se generan en el proyecto que efectúa la llamada y su uso puede restringirse a un entorno específico como un intervalo de direcciones IP o una aplicación Android o iOS específica.

    
    
    

    1. La clave de API se crea automáticamente. Haga clic en Restrict Key (Restringir clave) para actualizar las restricciones de la clave.
       
    2. Como alternativa, en la lista de claves de API, haga clic en Edit (Editar) para ver y actualizar la clave. 
       
    3. Especificar el nombre de la clave de la API. Se puede utilizar el nombre del bot para el nombre de la clave de la API para identificarla fácilmente.
       
       
       
    4. Seleccione las Restricciones de aplicaciones necesarias. Especifique los sitios web, aplicaciones o direcciones IP necesarios que pueden utilizar esta clave. Se pueden establecer los siguientes tipos de restricciones para la clave.
       1. Ninguno
       2. Referentes HTTP (sitios web)
       3. Direcciones IP (servidores web, trabajos cron, etc.)
       4. Aplicaciones de Android

       5. aplicaciones iOS 

          Info
          title Nota
          Se recomienda utilizar la opción Ninguna para la restricción de las aplicaciones. Esto se debe a que se puede acceder al bot sin tener en cuenta la dirección URL del sitio web o el dispositivo que se utiliza (Android o iOS)

          
          

    5. Haga clic en Save (Guardar) para guardar los cambios.

       Info
       title Nota
       Es posible que la configuración tarde hasta 5 minutos 5 minutos en aplicarse.

       
       

11. Copie la clave de la API y consérvela. La utilizará más adelante para la parte de la configuración de Luma Virtual Agent.
    

    Info
    title Nota
    La clave de la API se utiliza en el Paso 4 de la sección Habilitar canal de Google Hangouts en el Generador de bots Bot Builder (Consola de Administración de Luma) más abajo.

    
    

12. En el panel, abra el proyecto.

    1. Copie el número de proyecto (ID de la aplicación) generado y consérvelo, se utilizará más adelante para autenticar los mensajes recibidos del bot.

       Info
       title Nota
       El Número de proyecto (ID de la aplicación) se utiliza en el Paso 4 de la sección Habilitar canal de Google Hangouts en el Generador de bots Bot Builder (Consola de Administración de Luma) más abajo. El número de proyecto (ID de la aplicación) se utiliza para identificar al usuario o a la persona que usa Google Chat. Su finalidad es notificar a Google Chat que el portador de este token está autorizado para acceder a la API y realizar las acciones establecidas.

       
       

    2. En API & Services (API y servicios), seleccione la API de Hangouts Chat.
       
       
    3. Haga clic en Configurations (Configuraciones) y agregue la información de la aplicación.
    4. Especifique el Nombre del bot exclusivo con el que interactúa.

    5. Especifique la URL del avatar.
       

       Info
       title Nota
       La dirección URL del avatar es una URL de imagen que se utiliza para identificar el bot. Utilice una imagen que esté en línea con su marca y su cultura. Este es el avatar que verán los usuarios cuando estén conversando con el bot.

       
       

    6. Especifique la Description (Descripción) en un máximo de 40 caracteres y seleccione las dos casillas de verificación en Functionality (Funcionalidad).

       

13. En la sección Connection Settings (Configuración de la conexión), seleccione Bot URL (URL del bot) y, a continuación, especifique la Message URL (URL del mensaje) que se copia de Bot Builder (Consola de Administración de Luma). 

    Info
    title Nota
    La URL del bot se utiliza para transmitir datos entre el bot y Google Chat. Para obtener más información sobre la URL del mensaje, remítase al Paso 5 de la sección Habilitar canal de Google Hangouts en el Generador de bots Bot Builder (Consola de Administración de Luma) más abajo.

    
    

Activar canal de Google Hangouts en

...

Bot Builder (Consola de Administración de Luma)

Para activar la parte de Luma Virtual Agent de la integración de Google Chat, haga lo siguiente en Bot Builder (Consola de Administración de Luma): 

1. Haga clic en el menú Bots en el panel de navegación izquierdo y, a continuación, haga clic en Configuration (Configuración).
   Aparece la página Configuration  (Configuración) de bots.
2. En la página Configuration (Configuración), haga clic en la pestaña Channels (Canales) como se muestra a continuación.
   
3. Haga clic en el ícono de Google Hangouts en la lista de canales.
   Aparecerá la página de configuración de Google Hangouts como se muestra a continuación.
   
4. Pegue  la clave de la API de Google Chat y el Número de proyecto (ID de la aplicación) que copió en el Paso 11 y en el Paso 12 de la sección Crear proyecto de Google Hangouts indicada anteriormente.

5. Copie la URL del mensaje y consérvela en una ubicación de fácil acceso, como un bloc de notas o una herramienta de edición de texto. Se utiliza al configurar el proyecto de Google Chat (paso 13 de la sección Crear proyecto de Google Chat). Puede utilizar el ícono de copia para simplificar la operación. 

6. Haga clic en Configure (Configurar) para configurar el canal de Google Chat. De forma predeterminada, el canal Google Chat se activa al hacer clic en Configure (Configurar).
7. La configuración de Google Chat se mostrará en la página Channels  (Canales).
   1. Si es necesario, utilice el botón de alternancia ( [Configurar WeChat]) para que el canal esté desactivado. Puede desactivar Google Chat si no desea utilizarlo. 
   2. Si es necesario, haga clic en el ícono de Google Hangouts para editar los detalles.
      

Chatear con Luma

Una vez que el servicio esté en funcionamiento, puede enviar mensajes a su usuario bot y recibir las respuestas de Luma Virtual Agent. Para chatear con el usuario bot, vaya a https://chat.google.com/ e inicie sesión en la plataforma de Google Cloud. Si hay varios bots, seleccione el bot necesario para empezar a chatear tal como se muestra a continuación. 

El ID de correo electrónico que se utiliza en la plataforma de Google pasa automáticamente a Luma para autenticar de forma automática a los usuarios. Esto mejora enormemente la experiencia del usuario, puesto que Luma reconoce al usuario, muestra el historial de chat y permite activar habilidades específicas del usuario. 

...