Você pode configurar o bot para se comunicar com os usuários por meio do Google Hangouts. Para fazer isso,
- Primeiramente, gere a chave de API do Google.
- 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 habilidadesSkill Builder.
- Posteriormente, especifique o URL do bot (conhecido como URL da mensagem no Criador de habilidadesSkill Builder) na API do Google Hangouts.
Info | ||
---|---|---|
| ||
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 Skill Builder se comunique com os usuários por meio do Google Hangouts.
- Gere as APIs do para Google Hangouts acessando navegando até a página https://console.developers.google.com/project/_/apiui/apis/library .
- Entre na Google Cloud Platform usando suas credenciais de logon.
- Depois que você se conectar com êxito, a seguinte página de APIs do Google será exibida.
- Se necessário, clique em Selecionar para escolher um dos projetos existentes ou defina um novo projeto no menu Biblioteca.
- Clique em Criar para abrir a página Novo projeto e especifique os seguintes detalhes:
Enter the unique Project Name Digite o nome exclusivo do projeto. Google 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.The system automatically displays the Organization details based on the login detailsO 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.
O sistema exibe automaticamente os detalhes da organização com base nos detalhes de logon.
- 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.
- Clique em Criar para criar um projeto ou clique em Cancelar.
- Clique em Criar para abrir a página Novo projeto e especifique os seguintes detalhes:
- Depois que o novo projeto for criado, a página Biblioteca de APIs será aberta com o nome do projeto especificado.
- Na barra Pesquisar, procure Google Hangouts.
- Clique em API do bate-papo do Hangouts para abri-la em uma página separada.
- Clique em Ativar para ativar a API do Google Hangouts.
- A página API do bate-papo do Hangouts é exibida. Em seguida, clique em Criar credenciais para abri-la em uma página separada.
On the Credentials page, click API Key to open it on a separate page Na página Credenciais, clique em Chave da API no menu Criar credencial para abri-la em uma página separada.
Info title 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.
- Especifique o nomeda chave da API. Você pode usar o nome do bot como a chave da API para identificá-la com facilidade.
- 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.
- Nenhum
- Referenciadores de HTTP (sites)
- Endereços IP (servidores web, tarefa cron, etc.)
- Aplicativos Android
Aplicativos iOS apps
Info title 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).
Click Create to generate the API keyClique em Criar para gerar a chave da API.
Info title Observação As definições podem levar até 5 minutos para entrar em vigor.
- Quando a chave da API é criada, a página a seguir é exibida com a chave da API gerada.
- Especifique o nomeda chave da API. Você pode usar o nome do bot como a chave da API para identificá-la com facilidade.
Copie a chave da API e salve-a. Você a usará posteriormente para o lado da configuração da Agente virtual Luma.
Info title Observação A chave da API é usada na Etapa 4 da seção abaixo Ativar o canal do Google Hangouts no Criador de bot
- No Painel, vá para Configuração da API do Hangout.that is copied from the Skills
Copy the generated Project number (App ID) and retain it, it will be used later to authenticate the messages received from the 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.
Info title 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.
- Especifique o Nome do bot exclusivo com o qual você interage.
Specify the Avatar URLEspecifique o URL do avatar.
Info title 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.
- Especifique a Descrição com, no máximo, 40 caracteres e marque as duas caixas de seleção em Funcionalidade.
Na seção Definições de conexão, selecione URL do bot e especifique o URL da mensagem que é copiado do Skill Builder.
Info title 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
...
- Clique no menu Bots do painel de navegação à esquerda e clique em Configuração.
A página Configuração do bot é exibida. - Na página Configuração , clique na guia Canais , como mostrado abaixo.
- Clique no bloco Google Hangouts na lista de canais.
A página de configuração do Google Hangouts é exibida, conforme mostrado a seguir. - 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.
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 operationCopie 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.
- Clique em Configurar para configurar o canal do Google Hangouts. Por padrão, o canal do Google Hangouts é ativado quando você clica em Configurar.
- O Google Hangouts configurado é mostrado na página Canais .
- 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.
- 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.
Info | ||
---|---|---|
| ||
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 . |
Caso ocorra algum problema com a configuração, entre em contato com a equipe de Suporte da Serviceaide.