> For the complete documentation index, see [llms.txt](https://help.clickatell.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.clickatell.com/web-chat/how-your-web-chat-widget-is-set-up.md).

# How your Web Chat widget is set up

Your Clickatell account manager configures your Web Chat widget and provides you with your Widget ID and embed code. You tell Clickatell how you want the widget to look and behave, and Clickatell sets it up on your behalf.

{% hint style="info" %}
• The Web Chat channel must be enabled for your account in Chat Flow before the Web Chat icon appears on the Routing and Keywords pages. If you do not see it, reach out to the Clickatell team for assistance.&#x20;

• Chat Desk must be enabled for Web Chat before a Chat Desk node will hand your conversations to your agents. Clickatell enables this for you.&#x20;
{% endhint %}

**What you receive.** Clickatell gives you a Widget ID, which uniquely identifies your widget, and a two-line embed code that already contains it. Everything else about the widget — its wording, its colors, and its behavior — is held in your widget's settings rather than in your website.&#x20;

**What you can change later.** Every setting listed in Widget settings you can request can be changed after the widget has been created. Ask your account manager for the change you want. A change takes up to about a minute to reach your website visitors, and no change to your website is needed.&#x20;

**Several widgets.** You can have more than one widget — for example one for Sales and one for Support, or a Sandbox widget for testing alongside a Production widget for your live website. Each widget has its own Widget ID, its own settings, and its own conversation history, and the two never cross.&#x20;

#### Further settings that you can request:

These are the settings Clickatell can configure for your widget. Give your account manager the values you want, and ask for a change at any time.

| **Setting**              | **What it does**                                                                                                                                               |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Widget Name              | A descriptive name used to identify the widget. It is not shown to your website visitors. 3 to 50 characters.                                                  |
| Widget Type              | Sandbox for testing, or Production for your live website.                                                                                                      |
| Title                    | The heading shown at the top of the chat window. 2 to 100 characters.                                                                                          |
| Subtitle                 | An optional second line under the title. Up to 200 characters.                                                                                                 |
| Logo URL                 | A link to the logo shown in the chat window header.                                                                                                            |
| Avatar URL               | A link to the image shown beside each message from your business.                                                                                              |
| Welcome Message          | The first message a visitor sees. Up to 500 characters. It supports bold text and line breaks.                                                                 |
| Primary Color            | The main color of the chat window, given as a hex code, for example #3064FF.                                                                                   |
| Auto Open                | When this is enabled, the chat window opens by itself when the page loads, with no action from the visitor.                                                    |
| Pending Response Timeout | How long the widget waits before it shows a pending response indicator. 0 to 20 seconds, where 0 turns the indicator off.                                      |
| Allowed Origins          | The websites permitted to use this widget. See Secure your widget.                                                                                             |
| Message confirmation     | The widget will confirm that each message reached Clickatell, and will send it again if it did not, showing a sending, sent, or failed state for each message. |
|                          |                                                                                                                                                                |
|                          |                                                                                                                                                                |

{% hint style="info" %}
Only the primary color can be changed. Every other color in the chat window is fixed and cannot be customized.
{% endhint %}

#### Your widget's appearance:

Everything your website visitors see in the chat window comes from your widget's settings. The header carries your title, your subtitle, and your logo. Each message from your business carries your avatar, and the first thing a visitor reads is your welcome message.
