> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rovax.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget

The **Widget** channel is used to embed an interactive chat directly on your website or system.

### Steps to Create

1. Select **Type: Widget**.
2. Name the channel (e.g., *Official Widget*).
3. Assign a responder (Agent or Squad).
4. Optionally, add a custom prompt.
5. Set the response delay.
6. Click **Create Channel**.

Once created, the channel exposes a **Widget Configuration Page** containing:

| Section                   | Description                                                                  |
| ------------------------- | ---------------------------------------------------------------------------- |
| **Configuration Code**    | JavaScript snippet that must be copied and pasted into your site or web app. |
| **Theme Controls**        | Switch between **Light Mode** and **Dark Mode** versions.                    |
| **Customization Options** | Modify colors for background, text, and buttons.                             |
| **Open on Load**          | Option to auto-open the widget when the page loads.                          |

```html theme={null}
<body>
  <script>
    window.ZV2Widget = {
      ChannelURL: "https://widget.timelyai.com.br/widget/channel/..."
    };
  </script>
  <script src="https://widget.timelyai.com.br/script/widget-loader.js" async></script>
</body>
```

> ⚙️ Use the “Copy” button to copy the full script into your HTML `<body>` section.\
> Once deployed, your website visitors will be able to chat directly with your Agent.

## **Customization Notes**

For **Widget Channels**, Timely.ai provides a live customization environment:

* Modify message bubble colors and text colors.
* Adjust button color to match your branding.
* Switch between Light and Dark previews.
* Instantly preview all UI changes before saving.

Each customization option is applied independently per channel, allowing multiple widget styles for different sites or environments.
