Integração do Google Chat Spaces | Botpress Hub

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