Guides and Examples
Inbox backup to GCS bucket
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 google cloud, a gcs bucket, and a user for kindly to use setup user for kindly with s3 permissions step 1 create a gcs bucket (skippable if you already have one) go to the gcs dashboard https //console cloud google com/storage/browser and click create , go with default settings make sure public access is off step 2 create an service account go to the iam dashboard https //console cloud google com/iam admin/serviceaccounts , and click create a policy on grant this service account access to project step, give the service account the storage object creator you can skip giving access to users step 3 create key for the service account right after creating the service account, go to details of the service account you can use the search function to help with finding the account after going into details page you should go to keys tab and click on add key and create new key select json as the key format now your browser should download a file step 4 setup gcs in kindly navigate to workspace > settings > inbox backup app kindly ai/workspace/\[id]/settings/message backups fill out the bucket name and path fields the google application credential is the content of the file you downloaded at step 3 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 data payload example payload "data" \[ { "id" "1107ff573fb78f4ffa6666a2", "language code" "en", "taken over" false, "completed takeover" false, "takeover by agent id" 4040, "created" "2023 09 18t07 42 15 265000z", "updated" "2023 09 18t07 42 20 571000z", "messages" \[ { "message" "hi! i'm kindly's chatbot i can answer questions about kindly and our services how can i help you? 🟢\<br>\n\<br>feel free to ask me a question! you can also use one of the buttons below to get started ", "from bot" true, "sender" "bot", "score" null, "created" "2023 09 18t07 42 15 321000z", "exchange id" "c2db8b5d 6386 438c b7ca 00a1cdc969bd", "is followup" false, "exchange type" "greeting", "reply type" "standard", "reply candidates" \[], "suggestions" \[] }, { "message" "how are you?", "from bot" true, "sender" "bot", "score" null, "created" "2023 09 18t07 42 20 526000z", "exchange id" "c83969eb 4486 4612 9d10 d09ee364169c", "is followup" false, "exchange type" "usersays", "reply type" "standard", "reply candidates" \[], "suggestions" \[] } ], "feedback" \[], "context" { " name" "kindly chatbot", " organization name" "kindly chatbot", " web path" "/blog/chatbot faq example", " web host" "www kindly ai", " web url" "https //www kindly ai/blog/chatbot faq example", "some random variable" "some random value", }, "web host" "www kindly ai", "web path" "/blog/chatbot faq example", "labels" \[ { "id" "2g65d747 b644 456e b0a6 0e66c3c2dde9", "name" "support" } ] }, ]