# 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
- Uma conta do Google Cloud Platform (GCP)
- Um espaço do Google Chat onde você deseja implantar seu bot
- Instância Botpress com a integração do Google Chat instalada
Instruções de configuração
1. Ativar a API do Google Chat
- Aceda à Consola do Google Cloud
- Navegue até "APIs e serviços" > "Biblioteca"
- Procure "API do Google Chat "
- Clique na API do Google Chat
- Clique em "Enable" (Ativar) para ativar a API para o seu projeto
2. Criar uma conta de serviço do Google
- Aceda à Consola do Google Cloud
- Crie um novo projeto ou selecione um já existente
- Navegue até "IAM & Admin" > "Contas de serviço"
- Clique em "Create Service Account" (Criar conta de serviço)
- Preencha os detalhes da conta de serviço e clique em "Create" (Criar)
- 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
- Aceda à Consola do Google Cloud
- Navegue até "APIs & Services" > "Google Chat API"
- Clique em "Configuration" (Configuração)
- 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
- Na sua instância Botpress , vá para a secção Integrações
- Encontre e selecione a integração do Google Chat
- 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
- Abra o seu espaço do Google Chat
- Clique no nome do espaço para abrir os detalhes do espaço
- Aceda a "Aplicações e integrações"
- Clique em "Add apps" (Adicionar aplicações)
- Procure o seu bot utilizando o e-mail da conta de serviço
- 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
- 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
- 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
- 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.