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

# Installation

## Overview

Install [Messaging](/docs/channels/messaging) on a website or mobile app. Share the platform guide with the developers who own the integration.

## Limitations

[Messaging](/docs/channels/messaging) installation depends on the platform and the existing integration. Do not replace an existing script tag solely to change the channel name.

The legacy `@ada-support/embed2` npm package requires a package migration. It does not switch through the hosted script loader.

## Capabilities & configuration

Choose the [Messaging](/docs/channels/messaging) setup that matches your application.

| Platform                        | Developer guide                                                                                                                  |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| New website without a bundler   | [Web module script](/messaging/web/getting-started#embed-with-a-module-script)                                                   |
| Website with a bundler          | [Messaging npm loader](/messaging/web/getting-started#install-from-npm)                                                          |
| Existing hosted script tag      | [Web script migration](/messaging/web/getting-started#migrate-from-the-chat-sdk-web-script)                                      |
| Existing Embed2 npm integration | [npm migration](/messaging/web/getting-started#migrate-from-the-embed2-npm-package)                                              |
| iOS                             | [iOS setup and migration](/messaging/ios/getting-started)                                                                        |
| Android                         | [Android setup and migration](/messaging/android/getting-started)                                                                |
| React Native                    | [React Native setup and migration](/messaging/react-native/getting-started)                                                      |
| Custom interface                | [Custom apps](/messaging/custom-apps/getting-started) and [integration options](/messaging/introduction/choosing-an-integration) |

## Implementation & usage

Find your [Messaging](/docs/channels/messaging) installation details in the dashboard.

**To prepare an installation:**

1. Open **Config > Channels > Messaging**.
2. Open **Installation**.
3. Copy the AI Agent handle and the cluster details shown for your Agent.
4. Open the appropriate platform guide.
5. Give the guide and connection details to your developers.
6. Verify the installed integration before you change [launch options](/docs/channels/messaging/messaging-configuration/launch-options).

Developers must also configure the host application's [content security policy](/messaging/web/getting-started#content-security-policy).

## Related features

Use [Migrating to Messaging](/docs/channels/messaging/migrating-to-messaging) for the end-to-end transition checklist.

---

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