This article explains how to generate, customize, and share a direct external link to your Crisp chatbox.

A direct chatbox link lets visitors open your Crisp live chat widget without first visiting a website where Crisp is installed.

You can share this link directly, add it to a button or contact page, embed it inside another platform, or use it to test your chatbox. Messages sent from the link reach the Crisp workspace connected to its Website ID.

If Hugo AI Agent is active on your workspace, it can also respond from the direct chatbox according to your activation and routing settings.

In this guide, you will learn how to:

• Find your Website ID → retrieve the unique identifier of your Crisp workspace
• Generate the direct chatbox link → create the URL visitors can open
• Test the chatbox link → confirm that messages reach your Crisp Inbox
• Pass visitor information → prefill useful customer details through URL parameters
• Maintain the visitor session → connect the link to an existing Crisp session
• Set the chatbox language → open the chatbox in a selected locale
• Share or embed the chatbox link → use the link from another page or platform

Find your Website ID

Every Crisp workspace has its own unique Website ID.

To copy it from Crisp:

1. Open Settings.
2. Go to Workspace Settings → Setup & Integrations.
3. Find the Website ID field.
4. Click Copy.

Generate the direct chatbox link

Once you have your Website ID, insert it into the Crisp chatbox URL.

Use this format:

https://go.crisp.chat/chat/embed/?website_id=MY_WEBSITE_ID

Replace MY_WEBSITE_ID with the Website ID copied from your workspace.

Example:

If your Website ID is:

e93e073a-1f69-4cbc-8934-f9e1611e65bb

Your direct chatbox link becomes:

https://go.crisp.chat/chat/embed/?website_id=e93e073a-1f69-4cbc-8934-f9e1611e65bb

You can now open the URL in a browser or share it with your visitors.

Test the chatbox link

Before sharing the link, test it to make sure it is connected to the correct workspace.

To test the link:

1. Open the generated URL in a private or incognito browser window.
2. Send a test message from the chatbox.
3. Open the Crisp Inbox.
4. Confirm that the new conversation appears in the expected workspace.
5. Check that the chatbox appearance, welcome message, and automated behavior work as expected.

If Hugo AI Agent is enabled, you can also use this test to verify whether Hugo answers or escalates the conversation according to your configuration.

Pass visitor information

You can add URL parameters to prefill useful information about the visitor opening the chatbox.

This can help your team identify the customer and understand who is contacting you.

Visitor information parameters

Available parameters:

• User email → use user_email, for example &user_email=john.doe%40crisp.chat
• User phone → use user_phone, for example &user_phone=%2B33240031187
• User nickname → use user_nickname, for example &user_nickname=John%20Doe
• User avatar → use user_avatar followed by a URL-encoded image URL

Example with visitor information:

https://go.crisp.chat/chat/embed/?website_id=e93e073a-1f69-4cbc-8934-f9e1611e65bb&user_email=john.doe%40crisp.chat&user_nickname=John%20Doe

Avoid placing passwords, payment information, authentication secrets, or other sensitive data directly inside a URL.

Maintain the visitor session

More advanced integrations can use session parameters to connect the direct chatbox link to an existing Crisp session.

Available session parameters:

• Session ID → use crisp_sid, for example &crisp_sid=CRISP_SESSION_ID
• Session token → use token_id, for example &token_id=TOKEN_ID
• Session merge → use session_merge, for example &session_merge=true

These parameters are useful when a visitor should continue an existing conversation instead of starting a completely separate session.

Set the chatbox language

You can select the language used by the chatbox by adding the locale parameter to the URL.

Examples:

• English → &locale=en
• French → &locale=fr
• German → &locale=de

Example with a French locale:

https://go.crisp.chat/chat/embed/?website_id=e93e073a-1f69-4cbc-8934-f9e1611e65bb&locale=fr

Share or embed the chatbox link

Once the direct link is ready, you can use it in several ways.

For example, you can:

• Share it directly with customers
• Add it to a support button or navigation menu
• Link to it from a contact page
• Redirect a custom URL to the chatbox
• Embed the chatbox inside a compatible external platform
• Display it inside an iframe on a page you control

For example, you could add a button on https://acme.com/contact-us that opens your direct Crisp chatbox link.

Frequently Asked Questions

Still have questions which were not covered in this article? Here is a collection of the most frequently asked questions on this topic.

Where do messages sent from the direct chatbox link appear?

Messages appear in the Crisp Inbox connected to the Website ID used in the URL.

Make sure you use the Website ID from the correct workspace before sharing the link.

Does the direct link create a separate chatbox or Inbox?

No. The link opens the chatbox that already belongs to your Crisp workspace.

It uses the same Inbox, chatbox settings, welcome message, integrations, and automation configuration.

Can Hugo AI Agent answer conversations from the direct link?

Yes. If Hugo AI Agent is active on the workspace, it can handle conversations opened from the direct chatbox link according to your activation, instruction, and routing settings.

Can I use the link without installing Crisp on a website?

Yes. The direct external link can be opened independently in a browser.

This makes it useful for sharing a standalone support link, testing your chatbox, or using Crisp on a platform where you cannot install the standard JavaScript snippet.

Updated on: 27/07/2026