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

1. En primer lugar, genere la clave de la API de Google. 
2. Ingrese la clave de la API de Business Hangouts y el número de proyecto de Hangouts (ID de aplicación) en la página de configuración de Google Hangouts del Skill Builder (Constructor de habilidades).
3. Luego, especifique la dirección URL del bot (que se denomina URL del mensaje en el Skill Builder (Constructor de habilidades)) en la API de Google Hangouts. 

Crear un proyecto de Google Hangouts

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

1. Generate the APIs for Google Hangouts by navigating to https://console.developers.google.com/project/_/apiui/apis/library page.
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. 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 con el nombre de proyecto especificado.
   
6. En la barra de búsqueda, busque Google Hangouts.
   
7. Haga clic en la  API de Hangouts Chat para abrirla en una página independiente.
8. Haga clic en Enable (Activar) para activar la API de Google Hangouts.
   
9. Aparecerá la página API de Hangouts Chat. A continuación, haga clic en 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 separada.

    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 Hangouts). 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. 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.
       
    2. 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 

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

    3. Haga clic en Create (Crear) para generar la clave de API.

       Nota

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

    4. Una vez que se ha creado la clave de la API, aparece la siguiente página con la clave de la API generada.
       

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.

    Nota

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

12. Desde Dashboard (Panel), vaya a Configuration (Configuración) para la API de Hangouts.

    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.

       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 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 Hangouts. Su finalidad es notificar a Google Hangouts que el portador de este token está autorizado para acceder a la API y realizar las acciones establecidas.

    2. Especifique el Nombre del bot exclusivo con el que interactúa.

    3. Especifique la URL del avatar.
       

       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.

    4. 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 del Generador de habilidades. 

    Nota

    La URL del bot se utiliza para transmitir datos entre el bot y Google Hangouts. 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 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 Hangouts, 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 Business Hangouts 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 Hangouts (paso 13 de la sección Crear proyecto de Google Hangouts). Puede utilizar el ícono de copia para simplificar la operación. 

6. Haga clic en Configure (Configurar) para configurar el canal de Google Hangouts. De forma predeterminada, el canal Google Hangouts se activa al hacer clic en Configure (Configurar).
7. La configuración de Google Hangouts se mostrará en la página Canales .
   1. Si es necesario, utilice el botón de alternancia ( [Configurar WeChat]) para que el canal esté desactivado. Puede desactivar Google Hangouts 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. 

Si ocurre algún problema con la configuración, comuníquese con el equipo de Soporte de Serviceaide.