Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 Criador de habilidades.
  3. Posteriormente, especifique o URL do bot (conhecido como URL da mensagem no Criador de habilidades) na API do Google Hangouts. 
Info
titleObservação

Atualmente, o Canal do Google Hangouts não está disponível para clientes da China.

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 Criador de habilidades se comunique com os usuários por meio do Google Hangouts.

  1. Gere as APIs do Google Hangouts acessando a página https://console.developers.google.com/project/_/apiui/apis/library .
  2. Entre na Google Cloud Platform usando suas credenciais de logon. 
    Image RemovedImage Added
  3. Depois que você se conectar com êxito, a seguinte página de APIs do Google será exibida.
    Image RemovedImage Added
  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:
      Image RemovedImage Added
    2. Enter the unique Project NameGoogle generates and displays the unique Project ID, which cannot be changed once the project is created. The Project ID is the globally unique identifier for your project.

    3. The system automatically displays the Organization details based on the login details.

    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.
    Image RemovedImage Added
  6. Na barra Pesquisar, procure Google Hangouts.
    Image RemovedImage Added
  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.
    Image RemovedImage Added
  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.
    Image RemovedImage Added
  10. On the Credentials page, click API Key to open it on a separate page.

    Info
    titleObservaçã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.
      Image RemovedImage Added
    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. iOS apps 

        Info
        titleObservaçã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. Click Create to generate the API key.

      Info
      titleObservaçã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.
      Image RemovedImage Added
  11. Copy the API Key and retain it. You will use this later for the Luma Virtual Agent side of the configuration.

    Info
    titleObservaçã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. Copy the generated Project number (App ID) and retain it, it will be used later to authenticate the messages received from the bot.

      Info
      titleObservação

      Número do projeto (ID do aplicativo) é usado na Etapa 4 da seção abaixo Ativar canal do Google Hangouts no Criador de botO 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. Specify the Avatar URL.

      Info
      titleObservaçã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. In the Connection Settings section, select Bot URL and then specify the Message URL that is copied from the Skills Builder. 

    Info
    titleObservaçã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

...

  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.
    Image RemovedImage Added
  3. Clique no bloco Google Hangouts na lista de canais.
    A página de configuração do Google Hangouts é exibida, conforme mostrado a seguir.
    Image RemovedImage Added
  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. Copy the Message URL and retain it in an easily accessible location such as notepad or a text editor tool. This is used while configuring the Google Hangouts Project (Step 13 of Create Google Hangouts Project section). You can use the copy icon to simplify the operation. 

  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 (Image RemovedImage Added) 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.
      Image RemovedImage Added

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. 

Info
titleObservação

Lembre-se de que o Bot pode não estar visível por padrão. Talvez seja necessário procurar pelo bot na primeira instância de bate-papo. Assim que a conversa com o bot for iniciada, o bot estará visível na lista Bots .

Image RemovedImage Added

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