Koji is polite, so all users get a welcome message when they open the chatbot. You can edit this message to make it match your organization’s style by adding colors, images, and personalization.

...

Editing a message

To edit a welcome message, go to Koji settings and click Edit in the Welcome section.

Restoring the default message

Feel free to modify your message, as you can always restore the default welcome message by clicking the round arrow icon.

...

Editing modes

There are 2 modes of editing a message: plain text and HTML.

• If you plan to add images, switch to the HTML mode. If you want to keep a message rather simple, stick to the plain mode.

Buttons

You can enrich messages with buttons. When adding a button, you must type the button’s label, specify the action the button should perform, and its modifier.

Basically, this is the structure of a button:

%(<button label>|<message that is sent to the server>)<modifier>

Thus, a typical button looks like this:

%(<Chat help>|<#help>)b

Label

Label is the button’s text.

Action

The button’s purpose. What’s going to happen when a user clicks it?

Modifier

Modifiers define a button’s behavior and how it is displayed. There are 3 modifiers:

• b for inline buttons that are displayed in the message itself.

• ra for required actions that are displayed in column. They are called required, because a user cannot skip these buttons and must select one. The bot expects a user to select one option, but a user can type something similar as well.

• sa for suggested actions that are displayed in a row. These options are pre-built, so you cannot edit them. Users can skip suggested actions.If you plan to add images or use HTML tags, switch to the HTML mode.

Buttons

Welcome messages are equipped with pre-built buttons — Knowledge self-help and Quick request management. These buttons are added automatically.

These buttons provide users with quick access to Koji’s functionalities, such as finding information, and managing requests.

Personalizing

You can make welcome messages personalized by using keys. When a key is used, Koji replaces it with the actual value, making a message more vivid. For instance, a username firstname key is replaced with the person’s name. Simple and effective.

To use a key in the message, use the following syntax: %(<username>firstname)s. For  For example, to give someone a nice welcome, use the message of the following kind: Hello, %(firstname)s! Hope you are doing fine today!

...

Keys that you can use:

• username

• firstname

• surname

• channel

• lang

• botname

Testing your custom welcome message

Once you have defined a nice welcome message, you can test it and make sure it looks just as you need it. To do so:

1. Open the chat by clicking the Chat icon in the upper right of the window.

2. If you already have some conversations there, click hamburger menu in the upper left of the chat pane and select Clear the chat.

3. Once the chat is refreshed, the welcome message is displayed.

...