Inbox backup to AWS S3

You can schedule to receive daily dumps of conversations in the Inbox from us. This is useful if you e.g. want to routinely analyze your message data, or feed it to your own logging systems.

For this you will need Amazon Web Services, a S3 Bucket, and a user for Kindly to use.

Setup user for Kindly with S3 permissions

Step 1: Create a S3 bucket (skipable if you already have one)

Go to the S3 dashboard and click Create bucket, go with default settings. Make sure public access is OFF

Step 2: Create an IAM Policy

Go to the IAM dashboard, and click Create a policy.

Go to the JSON tab, add the following (note the wildcard the end is needed for allowing all paths within the bucket):

{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": "s3:PutObject",
"Resource": "arn:aws:s3:::MY_BUCKET/*"
}
]
}

Remember to replace MY_BUCKET with your actual bucket name

Step 3: Create a Group

Create a group and attach the policy from step 2

Step 4: Create a User, and get the public key / private key

Create a user for Kindly to use, it only needs Programmatic access, add this user to the group from step 3, skip tags.

On the success-page, copy the Access key ID (public key), and the Secret access key (private key).

Step 5: Use the key-pair in Kindly

Now that you have a key-pair, go to the Inbox Backup page in your Bot settings (https://app.kindly.ai/bot/YOUR_BOT_ID/settings/message-backups).

Kindly AWS settings

Schedule

If enabled in Kindly, the job will execute every night. It will upload a file for each language in the bot to a path structure like e.g. YYYY-MM-DD/INBOX-(BOTID)_BOTNAME-LOCALE-FILEPART. This file will include norwegian conversations for BOTNAME from 12am to 12pm, 31st of aug.