AWS S3

  # AWS S3 Integração para Botpress

Aproveite o poder do AWS S3 diretamente a partir do seu chatbot Botpress . Esta integração permite-lhe gerir baldes e objectos S3, realizando operações como a criação e eliminação de baldes, o carregamento e a recuperação de ficheiros, entre outras.

## Índice
- Introdução](#introdução)
- [AWS S3 Setup & Configuration](#aws-s3-setup--configuration)
  - [Pré-requisitos](#pré-requisitos)
  - Ativar a integração](#ativar-integração)
- [Acções](#acções)
  - [Criar Bucket](#criar-bucket)
  - [Eliminar Balde](#delete-bucket)
  - [Copiar objeto](#copy-object)
  - [Eliminar Política do Bucket](#delete-bucket-policy)
  - [Eliminar sítio Web do contentor](#delete-bucket-website)
  - [Eliminar objeto](#delete-object)
  - [Eliminar vários objectos](#delete-multiple-objects)
  - Obter Objeto](#get-object)
  - [Listar Objectos V2](#list-objects-v2)
  - Carregar Objeto](#upload-object)
  - [Listar contentores](#list-buckets)
- [Casos de utilização](#casos-de-utilização)
- [Eventos suportados](#eventos-suportados)

## Introdução
A integração AWS S3 para Botpress permite que seu chatbot gerencie o armazenamento cloud . Crie, liste e exclua buckets S3 e manipule arquivos diretamente através do seu chatbot. Esta integração é ideal para automatizar os fluxos de trabalho do cloud .

## AWS S3 Instalação e configuração
### Pré-requisitos
Antes de ativar a integração Botpress AWS S3  , verifique se você tem o seguinte:

- Uma instância do servidor Botpress configurada localmente ou no cloud.
- Credenciais do AWS com permissões para acessar os serviços S3.

### Ativar a integração
Para ativar a integração AWS S3 em Botpress, siga estes passos:

1. Aceda ao seu painel de administração de Botpress .
2. Navegue até à secção "Integrações".
3. Localize a integração AWS S3 e clique em "Enable" (Ativar) ou "Configure" (Configurar).
4. Forneça os dados necessários `accessKeyId`, `secretAccessKey` e `region`.
5. Salve a configuração.

## Acções
Aqui estão as ações suportadas pela integração AWS S3 :

### Criar bucket
Criar um novo bucket S3.

### Excluir bucket
Eliminar um bucket S3 existente.

### Copiar objeto
Copiar um objeto de um bucket S3 para outro.

### Excluir política de bucket
Excluir a política associada a um bucket S3.

### Excluir site do bucket
Exclui a configuração do site de um bucket S3.

### Excluir objeto
Excluir um objeto específico de um bucket S3.

### Eliminar vários objectos
Eliminar em massa vários objectos de um bucket S3.

### Obter objeto
Recuperar um objeto específico de um bucket S3.

### Listar Objetos V2
Listar objetos em um bucket S3 (versão 2 da operação de lista).

### Carregar objeto
Carregar um arquivo/objeto para um bucket S3. *Nota: Atualmente, esta funcionalidade está em desenvolvimento. Podemos devolver um URL pré-assinado que o utilizador pode utilizar com um comando curl para enviar um ficheiro para AWS S3. Estamos a aguardar que Botpress permita o carregamento de ficheiros e, uma vez implementado, esta funcionalidade será totalmente utilizável.

### Listar Buckets
Lista todos os buckets S3 disponíveis.

## Casos de uso
Aqui estão alguns casos de uso comuns para a integração AWS S3 :

1. Recuperação de dados
   - Permitir que os utilizadores recuperem ficheiros específicos armazenados num balde S3.
   - Utilize a ação Obter Objeto para recuperar ficheiros com base na entrada do utilizador.
   - Utilize a ação Listar Objectos V2 para apresentar os ficheiros disponíveis para os utilizadores escolherem.

2. Gerenciamento de buckets
   - Permitir que os utilizadores criem e apaguem baldes através da interface do chatbot.
   - Utilize a ação Criar Compartimento para criar novos locais de armazenamento.
   - Utilize a ação Eliminar contentor para remover contentores não utilizados ou vazios.
   - Utilize a ação Listar contentores para apresentar todos os contentores disponíveis para gestão.

3. Eliminação de objectos
   - Gerencie e exclua objetos específicos ou múltiplos de um bucket S3.
   - Utilize a ação Eliminar objeto para eliminar ficheiros individuais com base na introdução do utilizador.
   - Utilize a ação Eliminar vários objectos para efetuar eliminações em massa para operações de limpeza.

4. Migração de dados
   - Copie objetos de um bucket para outro para fins de migração de dados.
   - Use a ação Copiar objeto para copiar arquivos de um bucket de origem para um bucket de destino.
   - Use as ações Listar compartimentos e Listar objetos V2 para verificar a migração.

5. Operações de limpeza
   - Limpe regularmente objetos específicos ou compartimentos inteiros.
   - Use a ação Listar Objetos V2 para identificar objetos para exclusão.
   - Utilize as acções Eliminar objeto ou Eliminar vários objectos para remover ficheiros indesejados.
   - Utilize a ação Eliminar Compartimento para remover compartimentos vazios.

## Eventos suportados
Atualmente, esta integração não inclui eventos que são accionados com base nas actividades de AWS S3 . No entanto, é possível personalizar a integração para ouvir notificações de eventos específicos do S3 por meio do AWS SNS (Simple Notification Service) ou de outros serviços do AWS que acionam fluxos de trabalho em Botpress.