Você pode configurar o bot para se comunicar com os usuários pelo Google Chats. Para fazer isso,

1. Primeiro, crie um Google Project e gere a chave do Google API. 
2. Insira a chave da API e o número do projeto (ID do aplicativo) do Google Chat na seção de configuração do Google Hangouts do Criador de bot da Luma.
3. Posteriormente, especifique o URL do bot (denominado URL da mensagem no Criador de bot da Luma), na API do Google Chat. 

Criar um projeto do Google Chat

As etapas a seguir explicam como gerar a chave da API necessária para permitir que o bot se comunique com os usuários por meio do Google Chats.

1. Gere as APIs para o Google Chat indo até a página https://console.developers.google.com/project/_/apiui/apis/library .
2. Entre na Google Cloud Platform usando suas credenciais de logon. 
   
3. Depois que você se conectar com êxito, a seguinte página de APIs do Google será exibida.
   
4. Se necessário, clique em Selecionar para escolher um dos projetos existentes ou  defina um novo projeto no menu Biblioteca.
   1. Clique em Criar para abrir a página Novo projeto e especifique os seguintes detalhes:
      

   2. Digite o nome exclusivo do projeto. O Google gera e exibe a  ID exclusiva do projeto, que não pode ser alterada após a criação do projeto. A ID do projeto é o identificador globalmente exclusivo do seu projeto.

   3. O sistema exibe automaticamente os detalhes da organização com base nos detalhes de logon.

   4. Se houver um único Local, os detalhes serão exibidos automaticamente. Caso múltiplos locais estejam disponíveis, no campo Local, clique em Procurar e selecione a organização ou pasta Pai.
   5. Clique em Criar para criar um projeto ou clique em Cancelar.
5. Depois que o novo projeto for criado, a página da biblioteca de APIs a seguir será aberta para o novo projeto.
   
6. Na barra Pesquisar, procure a API do Google Chat.
   
7. Clique na API do Google Chat para abri-la em uma guia separada.
8. Clique em Ativar para ativar a API do Google Chat.
   
9. A página API do bate-papo do Hangouts é exibida. Na guia Visão geral, clique em Criar credenciais para abrir em uma página separada.
   

10. Na página Credenciais, clique na chave da API no menu Criar credencial para abrir em uma página separada.

    Observação

    A chave da API pode ser usada neste projeto e com qualquer API que a aceite. Essas chaves de API são usadas para identificar o projeto de chamada (neste caso, o bot), que faz uma chamada para uma API (neste caso, o Google Chat). Elas também verificam se o Bot de chamada recebeu acesso para chamar a API e se ativou a API no respectivo projeto. As chaves de API são geradas no projeto que faz a chamada, e o uso delas pode ser restrito a um ambiente específico, como um intervalo de endereços IP, ou a um aplicativo específico do Android ou iOS. 

    
    
    

    1. A chave da API é criada automaticamente. Clique em Restringir chave para atualizar as restrições de chave.
       
    2. Como alternativa, na lista de chaves de API, clique em Editar para exibir e atualizar a chave. 
       
    3. Especifique o nomeda chave da API. Você pode usar o nome do bot como a chave da API para identificá-la com facilidade.
       
       
       
    4. Selecione as restrições de aplicativo necessárias. Especifique os sites, aplicativos ou endereços IP necessários que podem usar essa chave. Você pode definir os tipos de restrição a seguir para a chave.
       1. Nenhum
       2. Referenciadores de HTTP (sites)
       3. Endereços IP (servidores web, tarefa cron, etc.)
       4. Aplicativos Android

       5. Aplicativos iOS 

          Observação

          É recomendável usar a opção Nenhum para a restrição de aplicativo. Isso porque você pode acessar o bot, independentemente do URL do site ou do dispositivo em uso (Android ou iOS)

    5. Clique em Salvar para salvar as alterações.

       Observação

       As definições podem levar até 5 minutos para entrar em vigor.

11. Copie a chave da API e salve-a. Você a usará posteriormente para o lado da configuração da Agente virtual Luma.
    

    Observação

    A chave da API é usada na Etapa 4 da seção abaixo Ativar o canal do Google Hangouts no Criador de bot

12. No painel, abra o projeto.

    1. Copie o número do projeto (ID do aplicativo) gerado e salve-o, pois ele será usado posteriormente para autenticar as mensagens recebidas do bot.

       Observação

       O Número do projeto (ID do aplicativo) é usado na Etapa 4 da seção abaixo Ativar canal do Google Hangouts no Criador de bot. O Número do projeto (ID do aplicativo) é usado para identificar o usuário ou a pessoa que está usando o Google Chat. Sua finalidade é informar o Google Chat que o portador deste token foi autorizado a acessar a API e a executar as ações definidas.

    2. Em API e serviços, selecione a API do Google Chat.
       
       
    3. Clique em Configurações e adicione as informações do aplicativo.
    4. Especifique o Nome do bot exclusivo com o qual você interage.

    5. Especifique o URL do avatar.
       

       Observação

       O URL do avatar é um URL de imagem usado para identificar o bot. Use uma imagem que se alinhe à sua marca e cultura. Esse é o avatar que você verá no bate-papo com o bot.

    6. Especifique a Descrição com, no máximo, 40 caracteres e marque as duas caixas de seleção em Funcionalidade.

       

13. Na seção Definições de conexão, selecione o URL do bot e especifique o URL da mensagem copiado do Criador de bot. 

    Observação

    O URL do bot é usado para transmitir dados entre seu bot e o Google Chat. Para saber sobre o URL da mensagem, consulte Etapa 5 da seção abaixo Ativar canal do Google Hangouts no Criador de bot. 

Ativar o canal do Google Hangouts no Criador de bot

Para ativar o lado da Agente virtual Luma da integração do Google Chat, proceda da seguinte forma no Criador de bot: 

1. Clique no menu Bots do painel de navegação à esquerda e clique em Configuração.
   A página Configuração do bot é exibida.
2. Na página Configuração , clique na guia Canais , como mostrado abaixo.
   
3. Clique no bloco Google Hangouts na lista de canais.
   A página de configuração do Google Hangouts é exibida, conforme mostrado a seguir.
   
4. Cole a chave da API do Google Chat e o Número do projeto (ID do aplicativo) copiado nas etapas 11 e 12 da seção Criar projeto do Google Chat abaixo.

5. Copie o URL da mensagem e salve-o em um local de fácil acesso, como o bloco de notas ou uma ferramenta de edição de texto. Ele é usado ao configurar o projeto do Google Chat (etapa 13 da seção Criar projeto do Google Chat). Você pode usar o ícone de cópia para simplificar a operação. 

6. Clique em Configurar para configurar o canal do Google Chat. Por padrão, o canal do Google Chat é ativado quando você clica em Configurar.
7. O Google Chat configurado é mostrado na página Canais .
   1. Se necessário, use o botão de alternância () para tornar o canal inativo. Você pode desativar o Google Chat se não desejar utilizá-lo. 
   2. Se necessário, clique no bloco Google Hangouts para editar os detalhes.
      

Bate-papo usando a Luma

Depois que o serviço estiver em execução, você poderá enviar mensagens ao usuário do Bot e receber respostas da Agente virtual Luma. Para bater papo com o usuário do Bot, vá para https://chat.google.com/ e faça logon em sua Google Cloud Platform. Se houver vários bots, selecione o Bot necessário para iniciar o bate-papo, conforme mostrado a seguir. 

A ID de email usada na plataforma Google é automaticamente transmitida à Luma para autenticar automaticamente os usuários. Isso melhora significativamente a experiência do usuário, já que a Luma reconhece o usuário, mostra o histórico do bate-papo e permite o disparo de habilidades específicas do usuário. 

Caso ocorra algum problema com a configuração, entre em contato com a equipe de Suporte da Serviceaide.