Kindly Docs

Go to App
⌘K
▶️Introduction
🔹Getting started with webhooks
🔹Webhooks reference
🔹Message processing
🔹Pattern dialogues
🔹Context memory
🔹Languages
📄Guides and Examples
◽Checking webhook signatures (HMACs)
◽Example: Chat transcript webhook
◽Kindly Chat authentication
◽Inbox backup to S3 bucket
◽Inbox backup to GCS bucket
◽Add the Spinnaker script tag to your site
◽Set up event tracking with Google Tag Manager (GTM)
⚙️APIs
▪️Application API
▪️Chat API
▪️Chat Transcript API
▪️Handover API
▪️Nudge API
▪️Statistics API
▪️iOS SDK
▪️Android SDK
▪️Text Predict API
▪️Ticket webhooks (BETA)
📦Legacy
📝APIs Changelog
🛡️Security
©️License and Disclaimer
Docs powered by Archbee
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 Amazon Web Services, a S3 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 and click Create, go with default settings. Make sure public access is OFF.

Step 2: Create an Service Account

Go to the IAM dashboard, 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

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,
    "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"
      }
    ]
  },
]




Updated 09 Oct 2023
Did this page help you?
PREVIOUS
Inbox backup to S3 bucket
NEXT
Add the Spinnaker script tag to your site
Docs powered by Archbee
TABLE OF CONTENTS
Setup user for Kindly with S3 permissions
Step 1: Create a GCS bucket (skippable if you already have one)
Step 2: Create an Service Account
Step 3: Create key for the Service Account
Step 4: Setup GCS in Kindly
Schedule
Data payload example
Docs powered by Archbee