# Descrição

Habilite o seu bot com a capacidade de listar e gerir os seus ficheiros no Google Drive e de transferir/carregar dados entre o Google Drive e a API de ficheiros Botpress .

Configuração

Devido à natureza potencialmente sensível dos ficheiros no seu Google Drive, a integração do Google Drive requer uma ligação segura entre Botpress e o Google Drive. Para estabelecer esta ligação segura, deve configurar a integração do Google Drive utilizando o OAuth.

Configuração automática com OAuth

Para configurar a integração do Google Drive utilizando o OAuth, clique no botão de autorização e siga as instruções no ecrã para ligar o seu bot Botpress ao Google Drive.

Ao utilizar este modo de configuração, será utilizada uma aplicação do Google Drive gerida por Botpress para estabelecer ligação à sua conta do Google Drive. No entanto, as acções realizadas pelo bot serão atribuídas ao utilizador que autorizou a ligação, e não à aplicação. Por este motivo, não recomendamos a utilização de contas pessoais do Google Drive para esta integração. Deve configurar uma conta de serviço e utilizar esta conta para autorizar a ligação. Pode então partilhar pastas e ficheiros específicos com esta conta de serviço para dar ao seu bot acesso a esses ficheiros.

Configurar a integração em Botpress

  1. Autorize a integração do Google Drive clicando no botão de autorização.
  2. Siga as instruções no ecrã para ligar o seu chatbot Botpress ao Google Drive.
  3. Quando a ligação estiver estabelecida, pode guardar a configuração e ativar a integração.

Usando a integração

Utilize as acções disponíveis para gerir os seus ficheiros e descarregar/carregar conteúdos de e para o Google Drive.

Utilize os accionadores disponíveis para saber quando um ficheiro ou pasta foi criado ou eliminado.

Utilize a ação "syncChannels" para criar e atualizar canais de subscrição em todos os ficheiros e pastas disponíveis. São estes canais que permitem que o seu bot seja notificado sobre a criação e eliminação de recursos. Os canais são válidos até um dia. Certifique-se de que esta ação é chamada uma vez por dia para evitar a perda de eventos. Chamar esta ação com demasiada frequência pode resultar em erros e na perda de eventos devido ao limite da taxa de criação de subscrições do Google Drive.

Limitações

As limitações padrão da API do Google Drive aplicam-se à integração do Google Drive em Botpress. Essas limitações incluem limites de taxa, restrições de tamanho de arquivo e outras restrições impostas pela plataforma do Google Drive. Certifique-se de que o seu bot respeita estas limitações para manter o desempenho e a fiabilidade ideais.

Estão disponíveis mais pormenores na documentação da API do Google Drive.