Skip to content
Install the messenger

Use a custom button or inline messenger

Choose the supported embedding mode for your site design and test its navigation carefully.

CCorthex product guidesUpdated October 15, 20262 min read
Where to find itEmbed configuration / developer docs

Before you begin

Activate the agent and open its integration/embed controls. You need permission to add the snippet to your website or configure the relevant plugin.

Example workspace · Demo data. Copy the snippet belonging to your agent. Replace example identifiers before use. Select the image to enlarge it.
Embed snippet for an example agent

Example workspace · Demo data. Copy the snippet belonging to your agent. Replace example identifiers before use. Select the image to enlarge it.

Step by step

  1. 1

    Choose a supported mode

    Use the embed attributes and launcher API documented in the developer reference. Inline chat needs a deliberate container in your layout.

  2. 2

    Keep the agent identity correct

    Use the same intended bot ID and avoid creating two competing installations on one page.

  3. 3

    Connect the custom control

    Wire the website button to the documented open behavior. Keep it keyboard accessible and give it a meaningful accessible name.

  4. 4

    Test each state

    Check open, close, page navigation, mobile dimensions and an existing conversation. Inline/custom modes do not use the standard floating reply-preview stack.

Good to know

Use the Widget embed and appearance reference in this Help Center for exact script attributes. Do not guess an unsupported global function from another provider’s snippet.

Check the result

Publish the website change, open the public page, send a test question and verify the correct conversation appears in the correct Corthex workspace.

Questions & troubleshooting

A custom button opens the wrong view

Check the documented default-view/launcher options and whether an existing visitor session is being resumed.

Was this article helpful?

Rate this guide on this device. Ratings are not sent to Corthex.