# 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).
