Você pode configurar o bot para se comunicar com os usuários por meio do Google Hangouts. Para fazer isso,

1. Primeiramente, gere a chave de API do Google. 
2. Insira a chave da API do Business Hangouts e o número do projeto (ID do aplicativo) do Hangouts na página de configuração do Google Hangouts do Skill Builder.
3. Posteriormente, especifique o URL do bot (conhecido como URL da mensagem no Skill Builder) na API do Google Hangouts. 

Criar um projeto do Google Hangouts

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

1. Gere as APIs para Google Hangouts navegando 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 Biblioteca de APIs será aberta com o nome do projeto especificado.
   
6. Na barra Pesquisar, procure Google Hangouts.
   
7. Clique em API do bate-papo do Hangouts para abri-la em uma página separada.
8. Clique em Ativar para ativar a API do Google Hangouts.
   
9. A página API do bate-papo do Hangouts é exibida. Em seguida, clique em Criar credenciais para abri-la em uma página separada.
   

10. Na página Credenciais, clique em Chave da API no menu Criar credencial para abri-la 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 Hangouts). 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. Especifique o nomeda chave da API. Você pode usar o nome do bot como a chave da API para identificá-la com facilidade.
       
    2. 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).

    3. Clique em Criar para gerar a chave da API.

       Observação

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

    4. Quando a chave da API é criada, a página a seguir é exibida com a chave da API gerada.
       

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, vá para Configuração da API do Hangout.

    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 Hangouts. Sua finalidade é informar o Google Hangouts que o portador deste token foi autorizado a acessar a API e a executar as ações definidas.

    2. Especifique o Nome do bot exclusivo com o qual você interage.

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

    4. 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 URL do bot e especifique o URL da mensagem que é copiado do Skill Builder. 

    Observação

    O URL do bot é usado para passar dados entre o Bot e o Google Hangouts. 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 Hangouts, 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 Business Hangouts e o Número do projeto (ID do aplicativo) copiado na Etapa 11 e Etapa 12 da seção abaixo Criar projeto do Google Hangouts.

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 Hangouts (Etapa 13 da seção Criar projeto do Google Hangouts). Você pode usar o ícone de cópia para simplificar a operação. 

6. Clique em Configurar para configurar o canal do Google Hangouts. Por padrão, o canal do Google Hangouts é ativado quando você clica em Configurar.
7. O Google Hangouts 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 Hangouts 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.