Configuration

Search…
Configuration
General information
The settings panel has a few options to allow you to configure the webapp. Each webapp must have a name, and you can also add an optional description and logo. If needed, you can also link to your own terms and conditions as well.
General information about the channel
Optionally, add a logo and link to your terms and conditions
Welcome flow
When a user arrives on the page, the chatbot welcomes them with a flow. It can be any flow, but by default it is the Default flow.
Any of your flows can be a Welcome flow
If you do not want a welcome interaction at all, create an empty flow and use that as the Welcome flow!
Application menu
If you want your users to be able to quickly launch any of your flows, you can use the menu, by adding shortcuts to any of the existing flows. For each flow, you must define a label to make it easily recognizable by your users.
Define a menu for your users
This will show in the top-right corner in desktop mode 
In mobile view, the applications menu will show at the bottom of the screen and slide up when activated:
Referral Parameter
You can launch a specific flow (and step) instead of the default Welcome Flow when loading the webapp by providing a ref parameter in the webapp URL.
There are two ways to use Ref parameters to redirect to flows. You can either configure them in the channel's settings page by adding connections between custom Ref parameters and a target flow:
​
​
Or you can use the following special syntax:
1
# will redirect to the step NAME_OF_STEP in the flow called NAME_OF_FLOW
2
https://chat.csml.dev/s/abc12345678901234?ref=target:[email protected]_OF_FLOW
3
​
4
# or, if no step is provided, the `start` step will be used
5
https://chat.csml.dev/s/abc12345678901234?ref=target:NAME_OF_FLOW
Copied!
The main advantage of the second syntax is that you can generate the links on the go; however, the first method is more flexible as you can easily change where a link is redirected even after it is created, and the content of the Ref parameter is entirely customizable.
Autocomplete
The autocomplete feature helps your chatbot provide a list of up to 5 items that are contextualized to what the user is currently typing. Think of it as quickly hitting one of the first google search results!
To configure Autocomplete, you need to have a backend endpoint that will handle the requests and respond accordingly. You can configure this endpoint in the webapp's configuration panel:
The request that will be performed by the webapp will be as follows:
1
curl -X "POST" "https://my.example.com/autocomplete?token=some-auth-token" \
2
     -H 'Content-Type: application/json;charset=utf-8' \
3
     -d #x27;{"text": "Give me the best result"}'
Copied!
Your endpoint must return results within 5 seconds as an application/json content-type, formatted as an array of maximum 5 results containing a title, optional highlighting matches, and the corresponding payload. 
1
[
2
  {
3
    "title": "What is the best result?",
4
    "matches": {
5
      "highlights": [
6
        {
7
          "word": "What",
8
          "highlight": false
9
        },
10
        {
11
          "word": "is",
12
          "highlight": false
13
        },
14
        {
15
          "word": "the",
16
          "highlight": false
17
        },
18
        {
19
          "word": "best",
20
          "highlight": true
21
        },
22
        {
23
          "word": "result",
24
          "highlight": true
25
        },
26
        {
27
          "word": "?",
28
          "highlight": false
29
        }
30
      ],
31
      "text": "What is the best result?",
32
      "has_highlights": true
33
    },
34
    "payload": "RESULT_ONE_PAYLOAD"
35
  },
36
  {
37
    "title": "Another good result",
38
    "matches": {
39
      "highlights": [
40
        {
41
          "word": "Another",
42
          "highlight": false
43
        },
44
        {
45
          "word": "good",
46
          "highlight": false
47
        },
48
        {
49
          "word": "result",
50
          "highlight": true
51
        }
52
      ],
53
      "text": "Another nice result",
54
      "has_highlights": true
55
    },
56
    "payload": "ANOTHER_RESULT_PAYLOAD"
57
  }
58
]
Copied!
When a user selects a result, it will behave as a button click where the text is displayed and the payload is sent to the chatbot.
Enabling/disabling autocomplete
If an autocomplete endpoint is set, it will be enabled by default. However, it can be disabled or reenabled dynamically in your CSML script:
1
say Autocomplete(false)
2
say Autocomplete(true)
Copied!
Autocomplete status is not persisted across page reloads. When reloading the page, this will always be set to true by default!
Installation
Customization
Last modified 9d ago
Export as PDF
Copy link
Contents
Enabling/disabling autocomplete