Versions Compared

Key

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

Configurar canal no GCP

...

Tip

Requisitos do canal:

  1. Empresa deve possuir uma conta no Google Workspace.

  2. Necessário configurar um bot para funcionamento deste canal, conforme roteiro abaixo.

  3. O bot pode ficar apenas disponível para o domínio da empresa ou público.

  4. Somente usuários com conta comercial possuem permissão para acessar bots no Google Chat.

Para ativar o canal do Google Chat, com uma conta do Google Workspace, inicialmente é necessário utilizar o e-mail de login para criar uma conta no Google Cloud Platform (GCP).

Inicialmente, acesse sua conta GCP e clique em Console:

...

Em seguida, clique Após isso, deve-se acessar a conta no GCP, clicar em Console, depois, no ícone de abertura de menu no canto superior esquerdo para abrir as demais funções e direcionamentos . Abra e, por fim, abrir a opção o IAM e administrador e clique em Contas de serviço:

...

Vá em Criar contas de serviço:

...

Insira administrador”, seguida de “Contas de Serviço”. Nessa aba, insira um nome e uma descrição para identificar seu o projeto. O campo ID da conta de serviço será preenchido automaticamente. Para concluir, clique em Criar “Criar e ContinuarContinuar”. Veja:

...

No segundo tópico 2, selecione o papel proprietárioProprietário. Para encontrá-lo, filtre por proprietário e o selecionefaça a seleção. Após selecioná-lo, clique isto, deve-se clicar em Concluir para finalizar. Veja o passo a passo enumerado abaixo:

...

Ao finalizar o processo anterior, localize Agora, deve-se localizar o projeto recentemente criado, vá . Isso é realizado entrando no sub-menu ações lateral Ações e clique em Gerenciar chaves:

...

Em seguida, adicione uma chave em Adicionar chave e, posteriormente, Criar nova chave:

...

clicando em “Gerenciar chaves” - “Adicionar chave” - “Criar nova chave”. Escolha a opção JSON para criar uma chave privada :

...

A chave JSON fica que ficará disponível nos donwloads downloads da máquina que está utilizando para criação do projeto. Clique em Fechar para Para continuar as configurações e localize , deve-se clicar em Fechar. Agora, é importante localizar a chave em seu explorador de arquivos. .

...

Veja:

...

Após criar e armazenar a a criação e armazenamento da chave JSON do projeto, localize é preciso localizar a API do Google Chat na barra de pesquisa superior:

...

Clique , selecioná-la e clicar em Permitir para habilitar a API ou Gerenciar, caso ela já esteja ativa no neste projeto: .

...

Em Configuração, preencha deve-se preencher os campos com as informações correspondentes:

...

Nome do bot: identificação do bot para certas explicadas a seguir: Em “Nome do Bot”, uma identificação para ele para futura interação, menção e localização por seus clientes

Para publicar seu bot posteriormente, visualize as diretrizes que o Google utiliza para revisar seu app pelo link: https://developers.google.com/workspace/marketplace/about-app-review#areas_of_review

URL do avatar: solicitado pelo Google, é necessário . Em “URL do avatar” é preciso inserir uma URL HTTPS direcionando-a para uma imagem gráfica que seja quadrada (ex.: PNG ou /JPEG), de no mínimo 128x128, que será visualizada como avatar de seu botDescrição: descreve . Este campo é solicitado pelo Google e seu preenchimento será visualizado como avatar do bot. Em Descrição, se deve descrever a finalidade de utilização de seu deste bot e em Funcionalidade: , as duas caixas de seleção das funcionalidades devem estar habilitas

...

devem ser habilitadas. Por fim, em “Configurações de conexão”, é necessário selecionar a opção “Bot URL”. Veja:

...

Info

Para publicar seu bot posteriormente, visualize as diretrizes que o Google utiliza para revisar seu aplicativo por este link. É importante destacar que, nesse primeiro momento, o bot será disponibilizado estará disponível apenas para os usuários com o domínio da sua própria empresa. Caso deseje que seja público, veja é preciso ver as instruções ao final do artigo.

Prosseguindo, em Configurações de conexão, selecione a opção bot URL e realize os seguintes passos:

...

No Conecta, acesse Canais e selecione o canal Google Chat:

...

Preencha os campos com as informações correspondentes:

...

dessa página ou por aqui.

Ativação do canal na plataforma

Para ativar o Google Chat, vá até o menu Canais e, no ícone de adição superior, o escolha entre as opções. Preencha os campos conforme solicitado e atente-se a caixa de informações que contém observações sobre a visualização do Webhook. O campo de fluxo deve ser associado ao autoatendimento em que o contato é submetido ao iniciar a conversa com a empresa. Já o campo “Conta de Serviço” deve ser preenchido com chave JSON baixada nas configurações realizadas no GCPClique em Salvar para finalizar a configuração e criar o canal. . Veja:

...

Visualização de webhook e publicação de bot

Para visualizar o Webhook do canal, clique na coluna de ações lateral - Editar e copie é necessário clicar em Editar pela coluna lateral de Ações e copiar o link no campo Webhook. Este link será deve ser inserido no GCP . Após inserido o webhook, selecione e, após a inserção, é preciso selecionar a opção de permissão conforme a sua preferência e clique clicar em Salvarpara finalizar :

...

Após finalizado, seu bot está e deixar o bot disponível para os usuários com domínio de sua da empresa, inicialmente.

Publicar bot

Visualize Já para publicar o bot, é preciso visualizar as diretrizes e informações pelo link https://developers.google.com/chat/how-tos/apps-publish para publicar seu bot de modo público.

O link irá direcionar à seguinte tela:

...

por este link para publicação em modo público.

Info

Antes de iniciar o processo de publicação confira se o canal está funcionando normalmente. É necessário que as configurações sejam realizadas no mesmo projeto utilizado nos passos anteriores. 

A análise da solicitação para ativar a API e publicação tem um prazo de até 5 dias. O suporte do Google entrará em contato por meio do e-mail informado no processo.

...

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width400px
urlhttps://www.youtube.com/watch?v=Vt1iSa9oH1c
height300px

...

Voltar para Manual de Configuração do Conecta

Voltar para Tela Administrativa

Voltar para Canais