> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/docs/channels/chat/chat-onboarding/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Chat onboarding

> **Warning**
>
> Ada has deprecated Chat. Messaging fully replaces Chat on December 15, 2026. Read [Introducing Messaging](https://docs.ada.cx/2026-09-30-introducing-messaging) to learn how to migrate.

If your AI Agent uses Messaging, follow [Messaging onboarding](/docs/channels/messaging/messaging-onboarding) for setup and platform requirements.

## Overview

With web chat, you can seamlessly integrate your Ada AI Agent with your website or app. It looks like the classic web widget that most people think of when they think of an AI Agent - but the generative responses it creates set it apart.

> **Tip**
>
> If your use case requires displaying images to customers, you can include URLs in the AI Agent's response that link to pages containing the visual content. Alternatively, you can configure [Handoffs](/docs/handoffs) to route specific inquiries to human agents or support channels that support image sharing.

For every AI Agent, the first thing you have to do is connect your knowledge base to your AI Agent. For more information, see the topics in the [Set up your AI Agent's knowledge and behavior](/docs/knowledge) section of the Help Docs. Those topics take you through preparing and uploading your knowledge base content to your AI Agent, then customizing its behavior with more advanced features like Guidance, Processes, and Actions for any situations you need your AI Agent to handle with specific actions or content.

## Limitations

The AI Agent generates text-only responses and cannot display images, videos, or other media formats directly in the chat widget. Images are supported in the Chat channel when provided by end users or during [Handoffs](/docs/handoffs) to human agents—they are simply not within the scope of AI-generated responses.

## Use cases

Web chat integration helps you provide AI-powered support directly on your website or app.

* **Self-service support**: Enable end users to resolve inquiries without waiting for human agents.
* **24/7 availability**: Provide instant responses to end users outside of business hours.
* **Reduce support volume**: Deflect common inquiries from your support team.

## Capabilities & configuration

Chat provides flexible options for embedding and customizing your AI Agent.

* **Multi-platform support**: Embed on websites, iOS apps, Android apps, and React Native apps.
* **Branding customization**: Customize the look and feel of your chat widget to match your brand.
* **Embed script options**: Modify the embed code to set default language, add end user metadata, and more.
* **Website restrictions**: Restrict your AI Agent to approved websites only.
* **Rollout controls**: Control what percentage of end users see your AI Agent.

## Quick start

Add Chat to your website in a few steps.

On the Ada dashboard, go to **Channels > Chat > Launch**.

Under **Chat availability**, enable the **Enable chat** toggle.

Copy the [embed code](/docs/channels/chat/chat-configuration/installation) and add it to your website.

Optionally, [customize your AI Agent's branding](/docs/channels/chat/chat-configuration/appearance-settings).

For detailed instructions, see [Implementation & usage](#implement-chat).

## Implementation & usage

Set up and customize your Chat widget.

### Customize branding

You can customize the look and feel of your chat widget, so it fits seamlessly within your organization's branding guidelines. For more information, see [Customize your AI Agent's branding](/docs/channels/chat/chat-configuration/appearance-settings).

### Implement and customize your chat widget\[#implement-chat]

Once the content in your AI Agent is ready, you can add a chat widget to your website or app with an [embed code](/docs/channels/chat/chat-configuration/installation). You can then modify the embed code to customize elements of the widget's behavior, like:

* Setting the default language for the chat
* Adding meta information about the end user for the AI Agent to use

For detailed information on different ways you can customize your chat widgets, see the developer documentation for the platform you're interested in:

* [Website](https://developers.ada.cx/reference/add-chat-to-website)
* [iOS](https://developers.ada.cx/reference/add-chat-to-ios-app)
* [Android](https://developers.ada.cx/reference/add-chat-to-android-app)
* [React](https://developers.ada.cx/reference/add-chat-to-react-native-app)

For browser compatibility information, see [Browser support](#browser-support).

### Control chat widget visibility

To start, make sure Chat is enabled as a channel for your AI Agent. You can do this by ensuring that **Enable chat** under **Chat availability** on the **Launch** tab is enabled.

Once Chat is enabled, you have control over your chat widget's visibility. This ensures malicious parties can't embed your AI Agent on unauthorized websites, and also gives you flexibility to roll out your AI Agent gradually.

For more information, see:

* [Restrict your AI Agent to a list of approved websites](/docs/channels/chat/chat-configuration/launch-options#website-restrictions)
* [Control how many users see your AI Agent](/docs/channels/chat/chat-configuration/launch-options)

### Browser support\[#browser-support]

Use the following tables to determine which actions you can perform in which browser.

#### Dashboard (desktop)

| Browser           | Minimum compatible version |
| ----------------- | -------------------------- |
| Chrome            | 107                        |
| Edge              | 108                        |
| Safari            | 16.2                       |
| Firefox           | Not compatible             |
| Internet Explorer | Not compatible             |

#### Chat widget (desktop)

| Browser           | Minimum compatible version |
| ----------------- | -------------------------- |
| Chrome            | 99                         |
| Edge              | 99                         |
| Firefox           | 97                         |
| Safari            | 15.4                       |
| Internet Explorer | Not compatible             |

#### Chat widget (mobile)

| Platform                           | Minimum compatible version |
| ---------------------------------- | -------------------------- |
| iOS (Safari and in-app WebViews)   | 15.4                       |
| Android (System WebView or Chrome) | 99                         |
| Windows                            | Not compatible             |

The chat widget runs in the device's web engine. On Android, System WebView updates separately from the operating system through the Play Store app **Android System WebView**. Devices below these minimum versions are not supported.

## Related features

* [Chat installation](/docs/channels/chat/chat-configuration/installation): Add your AI Agent to your website or mobile app.
* [Knowledge](/docs/knowledge): Set up your AI Agent's knowledge base.
* [Greetings](/docs/automation/greetings): Configure how your AI Agent greets end users.
* [Handoffs](/docs/handoffs): Configure handoffs to human agents.

---

Have any questions? Contact your Ada team, or email us at [](mailto:help@ada.cx?subject=Help%20Docs%20inquiry).