AWS S3

  # AWS S3 Integratie voor Botpress

Gebruik de kracht van AWS S3 rechtstreeks vanuit je Botpress chatbot. Met deze integratie kun je S3-buckets en -objecten beheren en bewerkingen uitvoeren zoals het aanmaken en verwijderen van buckets, uploaden en ophalen van bestanden en meer.

## Inhoudsopgave
- Introductie](#introductie)
-AWS S3 Instelling en configuratie](#aws-s3-setup--configuratie)
  - Vereisten](#vereisten)
  - Integratie inschakelen](#integratie inschakelen)
- Acties](#acties)
  - Maak emmer aan](#create-bucket)
  - Verwijder emmer](#delete-bucket)
  - Kopieer object](#kopieer-object)
  - Emmerbeleid verwijderen](#delete-bucket-policy)
  - Emmer website verwijderen](#delete-bucket-website)
  - Object verwijderen](#delete-object)
  - Meerdere objecten verwijderen](#delete-multiple-objects)
  - Object ophalen](#get-object)
  - Lijst Objecten V2](#lijst-objecten-v2)
  - Object uploaden](#upload-object)
  - Lijst emmers](#list-buckets)
- Gebruiksgevallen](#use-cases)
- Ondersteunde gebeurtenissen](#ondersteunde-gebeurtenissen)

## Introductie
De AWS S3 integratie voor Botpress stelt je chatbot in staat om cloud opslag te beheren. Maak, maak een lijst van en verwijder S3 buckets en behandel bestanden direct via je chatbot. Deze integratie is ideaal voor het automatiseren van cloud workflows.

## AWS S3 Installatie en configuratie
### Vereisten
Voordat u de Botpress AWS S3  integratie inschakelt, moet u ervoor zorgen dat u over het volgende beschikt:

- Een Botpress serverinstantie lokaal of in de cloud is ingesteld.
- AWS-inloggegevens met machtigingen voor toegang tot S3-services.

### Integratie inschakelen
Voer de volgende stappen uit om de AWS S3 integratie in Botpress in te schakelen:

1. Ga naar uw Botpress beheerderspaneel.
2. Navigeer naar de sectie "Integraties".
3. Zoek de AWS S3 integratie en klik op "Inschakelen" of "Configureren".
4. Geef de vereiste `accessKeyId`, `secretAccessKey` en `region` op.
5. Sla de configuratie op.

## Acties
Hier zijn de acties die worden ondersteund door de AWS S3 integratie:

### Emmer aanmaken
Een nieuwe S3 emmer maken.

### Emmer verwijderen
Een bestaande S3 emmer verwijderen.

### Object kopiëren
Kopieer een object van de ene S3 emmer naar de andere.

### Emmerbeleid verwijderen
Verwijder het beleid dat aan een S3 emmer is gekoppeld.

### Website verwijderen
Verwijder de websiteconfiguratie van een S3 emmer.

### Object verwijderen
Verwijder een specifiek object uit een S3 emmer.

### Meerdere objecten verwijderen
Bulkverwijder meerdere objecten uit een S3 emmer.

### Object ophalen
Een specifiek object ophalen uit een S3 emmer.

### Objecten opsommen V2
Een lijst maken van objecten in een S3-bucket (versie 2 van de lijstbewerking).

### Object uploaden
Upload een bestand/object naar een S3-bucket. *Opmerking: Deze functie is momenteel in ontwikkeling. We kunnen een vooraf ondertekende URL terugsturen die de gebruiker met een curl-commando kan gebruiken om een bestand naar AWS S3 te sturen. We wachten op Botpress om uploads van bestanden toe te staan en zodra deze functie is geïmplementeerd, zal deze volledig bruikbaar zijn.*

### Overzicht emmers
Lijst van alle beschikbare S3 emmers.

## Gebruikscases
Hier zijn enkele veelvoorkomende gebruikssituaties voor de AWS S3 integratie:

1. Gegevens ophalen
   - Laat gebruikers specifieke bestanden ophalen die zijn opgeslagen in een S3 emmer.
   - Gebruik de Get Object actie om bestanden op te halen op basis van gebruikersinvoer.
   - Gebruik de actie List Objects V2 om beschikbare bestanden weer te geven waaruit gebruikers kunnen kiezen.

2. Emmer Beheer
   - Stel gebruikers in staat om buckets aan te maken en te verwijderen via de chatbot-interface.
   - Gebruik de actie Create Bucket om nieuwe opslaglocaties aan te maken.
   - Gebruik de actie Emmer verwijderen om ongebruikte of lege emmers te verwijderen.
   - Gebruik de actie Lijst emmers om alle beschikbare emmers voor beheer weer te geven.

3. Object verwijderen
   - Beheer en verwijder specifieke of meerdere objecten uit een S3 emmer.
   - Gebruik de actie Object verwijderen om individuele bestanden te verwijderen op basis van gebruikersinvoer.
   - Gebruik de actie Meerdere objecten verwijderen om bulkverwijderingen uit te voeren voor opruimoperaties.

4. Migratie van gegevens
   - Kopieer objecten van de ene emmer naar de andere voor datamigratie doeleinden.
   - Gebruik de Kopieer Object actie om bestanden te kopiëren van een bron emmer naar een doel emmer.
   - Gebruik de acties List Buckets en List Objects V2 om de migratie te verifiëren.

5. Opschoon acties
   - Schoon regelmatig specifieke objecten of hele emmers op.
   - Gebruik de actie List Objects V2 om objecten te identificeren die verwijderd moeten worden.
   - Gebruik de acties Object verwijderen of Meerdere objecten verwijderen om ongewenste bestanden te verwijderen.
   - Gebruik de actie Verwijder emmer om lege emmers te verwijderen.

## Ondersteunde gebeurtenissen
Deze integratie bevat momenteel geen gebeurtenissen die worden geactiveerd op basis van AWS S3 activiteiten. Je kunt de integratie echter aanpassen om te luisteren naar specifieke S3 gebeurtenismeldingen via AWS SNS (Simple Notification Service) of andere AWS-services die workflows triggeren in Botpress.