> 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-to-use-web-chat-with-chat-flow.md).

# How to use Web Chat with Chat Flow

Linking a widget to a workflow is what gives the chat window its behavior. The workflow decides what a visitor is asked, what is looked up, when Clickatell AI answers, and when a live agent takes over. You can link a widget to a workflow directly, and you can also let a visitor reach a specific workflow with a keyword.&#x20;

#### Link Web Chat to a flow&#x20;

Link your widget to the workflow that should answer it. This is the one step that turns the chat window from a shell into a conversation.&#x20;

1. In Chat Flow, select your production environment.&#x20;
2. Under Configuration, select Routing.&#x20;
3. Select the Web Chat icon.&#x20;
4. In the API ID column, paste your Widget ID.&#x20;
5. Select the workflow and the step it should start at.&#x20;
6. Save your changes.&#x20;
7. Open your website and send a message to confirm the workflow replies as you expect.&#x20;

{% hint style="info" %}
If the Web Chat icon is not shown on the Routing page, the channel still has to be enabled on your account. Reach out to the Clickatell team for assistance.
{% endhint %}

**Set up a keyword**&#x20;

A keyword lets a visitor jump straight to a specific workflow, which is useful when you want a short route to one task without rebuilding your main menu.&#x20;

1. In Chat Flow, select your production environment.&#x20;
2. Under Configuration, select Keywords.&#x20;
3. Select the Web Chat icon.&#x20;
4. Select New Keyword Group and enter the keyword.&#x20;
5. Select the workflow and the step it should start at.&#x20;
6. Select Save Keywords.&#x20;
7. Send the keyword from your widget to confirm the correct workflow runs.&#x20;

**What you can build**&#x20;

The standard Chat Flow node set works on Web Chat, so a workflow you already know how to build works here too. The nodes you are most likely to reach for are:&#x20;

* Display and input nodes such as Text Display, Media, Menu, and Request Input, for asking a question and showing the answer.&#x20;
* API Integration, to look something up in your own systems and bring it back into the conversation.&#x20;
* Clickatell AI, to answer with your AI assistant.&#x20;
* Chat Desk, to hand the conversation to a live agent.&#x20;
* Chat 2 Pay, to take a payment inside the chat window.&#x20;
* OAuth Request, to sign a visitor in to your own service.&#x20;

{% hint style="warning" %}
• Web Chat conversations are always started by the website visitor, so your business cannot send the first message, and Web Chat is not available for broadcast or campaign sending.&#x20;

• There is no persistent visitor identity. A conversation is identified by a session only, so a visitor is not recognized from one conversation to the next.&#x20;

• Location sharing, link previews, and masked input are not available on Web Chat.&#x20;

• WhatsApp message templates and template categories do not apply to Web Chat.&#x20;

• Multi-select lists, radio buttons, and check boxes are not available. A visitor selects one option from a list.&#x20;
{% endhint %}
