Website chat settings
All fields of the chat widget, the visitor form and the options you can put on the snippet.
Last updated on
You find the settings under SettingsIntegrationsWebsite chat. Installing and placing the snippet are described in Putting the chat on your website.
Widget
| Field | What does it do? |
|---|---|
| Widget enabled | Hides the chat everywhere without removing the integration. On by default |
| Show on Tillor public pages | Shows the chat button on public Tillor pages such as the access pass, outstanding invoice and public map. Your own site uses the snippet. On by default |
| Welcome message | Text in the chat header and before the visitor's first message. Maximum 500 characters. Leaving it empty gives a default text in the widget's language |
| Launcher tooltip | Label for the floating button, meant for screen readers. Maximum 80 characters |
| Reply soon message | Line under the organisation name in the chat header, for example "We usually reply quickly" |
| Launcher icon | Icon on the chat button: Speech bubble, Rounded chat, Question mark, Search or Person |
| Accent color | Colour of the chat button and of the visitor's messages. Choose a colour or enter a hex value, for example #2563eb |
| Allowed domains | Comma-separated hostnames that may load the chat. Empty means: any domain |
| Email visitors about unread replies | See below. On by default |
The chat header automatically shows your organisation's logo. Messages from the AI assistant get a little robot instead of that logo. Neither can be set under Website chat.
Which language does the visitor get?
If you do not set a Welcome message, Launcher tooltip or Reply soon message, the widget uses a default text in its own language. You set that language on the snippet with data-locale (see Options on the snippet).
Visitor form
Here you decide what a visitor fills in before the first message. If there are required fields, they appear together with the message field on one screen. The visitor fills everything in and clicks Send, with no separate intermediate step.
Standard fields
| Field | What does it do? |
|---|---|
| Name required | Visitors enter their name. The name is stored with the conversation |
| Email required | Visitors enter their email address. The address is stored with the conversation |
| Phone required | Visitors enter a phone number. Tillor converts it to a fixed format and uses it to link the conversation to calls and customers |
Each field is switched on or off separately. If only phone is on, the visitor only sees the phone field.
Extra fields
Click Add field for your own questions. You can add a maximum of 8 extra fields. Delete a field with Remove field.
| Option | Explanation |
|---|---|
| Field label | What the visitor sees in the widget. Maximum 80 characters |
| Field key | Internal name of the field. Start with a lowercase letter and use only lowercase letters, digits and _ (maximum 32 characters) |
| Field type | Text or Email |
| Required | The visitor must fill in the field before they can chat. A new field is required by default |
| Placeholder | Hint in the input field. Maximum 120 characters |
The answers to extra fields appear in the inbox with the conversation, next to the channel and visitor ID.
Email reminder
Visitors often close the page before your team or Tillie replies. With Email visitors about unread replies, the visitor receives an email with the Continue the conversation button as soon as a reply is waiting that they have not read.
- The visitor must have provided an email address, via the visitor form or pre-filled. Without an address, nothing happens.
- The email only goes out once the visitor has been inactive for about 5 minutes. They receive one email per series of unread replies.
- The button opens the chat and continues the conversation, also on another device or in another browser. The link works for 30 days.
- The visitor can also reply directly to the email. That reply appears in the same conversation in the inbox, with a small envelope icon next to the message.
- Replies from Tillie count, just like replies from your team.
Options on the snippet
Besides data-org-id and data-widget-key, you can put optional attributes on the script. This is intended for whoever places the snippet on the site.
| Attribute | What does it do? |
|---|---|
data-locale | Widget language: en, nl, de, fr, pt or ro, optionally with a region such as nl-BE. Default en; another language falls back to English. The region determines the date and time format |
data-accent-color | Accent colour for this page as a 6-digit hex. Overrides the colour under Settings |
data-messages | JSON object to adjust individual texts, for example {"send":"Versturen","messagePlaceholder":"Typ uw bericht…"} |
data-sounds | false turns off sounds for new team replies and on sending. On by default |
data-launcher | false hides the floating chat button. You then open the chat with your own button via the widget SDK |
data-visitor | JSON object to pre-fill name, email and phone, for example {"name":"Jan","email":"jan@voorbeeld.nl","phone":"+32470123456"} |
data-visitor-name, data-visitor-email, data-visitor-phone | Pre-fills one of those fields |
data-debug | true shows log lines in the browser console |
Attributes only fill in empty fields. If the visitor has already entered details in this browser, those stay in place.
An example with Dutch texts:
<script
src="https://tillor.eu/inbox-widget.js"
data-org-id="org_abc123"
data-widget-key="iwk_xxx"
data-locale="nl"
async
defer
></script>You can also turn on debug without changing the snippet: run localStorage.setItem('tillor-inbox-debug', '1') in the browser console and refresh the page.
Spam protection
The widget does not use a captcha. Tillor protects sending with the widget key and with Allowed domains. If your contact form has its own captcha, it may stay as an extra layer.
Terms for visitors
Under the message field is a short notice that by sending, the visitor agrees to the website chat terms. The link opens in a new tab and follows the language of data-locale.