Espaços Chat do Google

  # Integração do Google Chat para Botpress

Esta integração permite-lhe ligar o seu chatbot Botpress aos espaços do Google Chat , permitindo uma comunicação perfeita entre o seu bot e os utilizadores do Google Chat .

## Caraterísticas

- Enviar e receber mensagens em espaços do Google Chat 
- Tratamento automático de mensagens e respostas
- Suporte para vários espaços do Google Chat 
- Autenticação segura usando a Conta de serviço do Google

## Pré-requisitos

1. Uma conta do Google Cloud Platform (GCP)
2. Um espaço do Google Chat onde você deseja implantar seu bot
3. Instância Botpress com a integração do Google Chat instalada

## Instruções de configuração

### 1. Ativar a API do Google Chat 

1. Aceda à [Consola do Google Cloud] (https://console.cloud.google.com)
2. Navegue até "APIs e serviços" > "Biblioteca"
3. Procure "API do Google Chat "
4. Clique na API do Google Chat 
5. Clique em "Enable" (Ativar) para ativar a API para o seu projeto

### 2. Criar uma conta de serviço do Google

1. Aceda à [Consola do Google Cloud] (https://console.cloud.google.com)
2. Crie um novo projeto ou selecione um já existente
3. Navegue até "IAM & Admin" > "Contas de serviço"
4. Clique em "Create Service Account" (Criar conta de serviço)
5. Preencha os detalhes da conta de serviço e clique em "Create" (Criar)
6. Criar uma nova chave para a conta de serviço:
   - Clique na conta de serviço
   - Ir para o separador "Chaves
   - Clique em "Adicionar chave" > "Criar nova chave"
   - Escolha o formato JSON
   - Descarregar o ficheiro da chave

### 3. Configurar as definições da aplicação Google Chat 

1. Aceda à [Consola do Google Cloud] (https://console.cloud.google.com)
2. Navegue até "APIs & Services" > "Google Chat API"
3. Clique em "Configuration" (Configuração)
4. Configure a sua aplicação com as seguintes definições:
   - **Nome da aplicação**: Escolha um nome para o seu bot
   - **Descrição**: Adicione uma descrição da funcionalidade do seu bot
   - **Avatar URL**: Adicione um URL para a imagem do avatar do seu bot
   - Caraterísticas**:
     - Ativar caraterísticas interactivas
     - Ativar a receção de mensagens 1-1
     - Permitir entrar em espaços e conversas de grupo
   - URL do ponto final HTTP**: Defina isto como o URLwebhook  Botpress  encontrado na Configuração de integração do Google Chat .

### 4. Configurar a integração no Botpress

1. Na sua instância Botpress , vá para a secção Integrações
2. Encontre e selecione a integração do Google Chat 
3. Configura as seguintes definições:
   - **Service Account JSON**: Cole todo o conteúdo do ficheiro de chave da conta de serviço transferido
   - **Default Space**: Introduza o ID do seu espaço predefinido do Google Chat (opcional)

### 5. Adicionar o Bot ao seu espaço do Google Chat 

1. Abra o seu espaço do Google Chat 
2. Clique no nome do espaço para abrir os detalhes do espaço
3. Aceda a "Aplicações e integrações"
4. Clique em "Add apps" (Adicionar aplicações)
5. Procure o seu bot utilizando o e-mail da conta de serviço
6. Adicione o bot ao seu espaço

## Utilização

### Envio de mensagens

O bot pode enviar mensagens para qualquer espaço do Google Chat ao qual tenha sido adicionado. As mensagens podem ser enviadas:
- Em resposta a mensagens do utilizador
- Proactivamente através do editor de fluxo Botpress 
- Através de chamadas API do seu código personalizado

### Recebendo mensagens

O bot recebe e processa automaticamente as mensagens enviadas no espaço do Google Chat . Ele irá:
- Analisar as mensagens recebidas
- Processá-las através dos seus fluxos Botpress 
- Enviar as respostas adequadas de volta para o espaço

### Formato da mensagem

A integração suporta mensagens de texto nos espaços do Google Chat . As mensagens podem incluir:
- Texto simples
- Formatação básica
- Ligações
- Menções

## Considerações de segurança

- Mantenha a chave da sua conta de serviço segura e nunca a partilhe publicamente
- Alterne regularmente as chaves da conta de serviço
- Use o princípio do menor privilégio ao atribuir funções à sua conta de serviço
- Monitorize a atividade do seu bot e configure o registo apropriado

## Resolução de problemas

### Problemas comuns

1. **O bot não está a responder**
   - Verificar se a conta de serviço tem as permissões corretas
   - Verificar se o bot está corretamente adicionado ao espaço
   - Verificar se a integração está corretamente configurada no Botpress

2. **Erros de autenticação**
   - Verificar se o JSON da conta de serviço está corretamente formatado
   - Verificar se a chave da conta de serviço é válida e não expirou
   - Certifique-se de que a conta de serviço tem os âmbitos de API necessários activados

3. **Problemas de entrega de mensagens**
   - Verificar se o ID do espaço está correto
   - Verificar se o bot tem permissão para publicar no espaço
   - Certificar-se de que o formato da mensagem é válido

## Referência da API

Para obter mais detalhes sobre a API do Google Chat , consulte a [documentação oficial](https://developers.google.com/chat/api/reference/rest).