How to generate the direct external link of the Crisp live-chat chatbox

This article explains how to generate a direct external link for your Crisp chatbox.

A direct chatbox link is useful when you have not installed Crisp on a website, want to share a standalone support link, or need a quick way to test a chatbox. The link uses your Crisp Website ID and can optionally include supported user or session parameters.

Generate the external chatbox link

Start with your Website ID, then insert it into the Crisp chatbox embed URL.

To generate the link:

Find your Website ID with this guide.
Replace MY_WEBSITE_ID in this URL: https://go.crisp.chat/chat/embed/?website_id=MY_WEBSITE_ID.
Open the generated URL in your browser or share it with your users.

Example:

If your Website ID is e93e073a-1f69-4cbc-8934-f9e1611e65bb, your direct chatbox link is https://go.crisp.chat/chat/embed/?website_id=e93e073a-1f69-4cbc-8934-f9e1611e65bb.

Pass user information to the chatbox

You can add supported URL parameters to prefill or bind useful information to the chatbox session.

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, with a URL-encoded image URL
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

Example with user data:

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

Always URL-encode parameter values before adding them to the chatbox link.

For session continuity and token usage, see the Crisp session continuity documentation.

Force the chatbox locale

You can also force a locale from the URL. This is useful if the link is shared from a localized page or campaign.

Locale parameter:

Locale → use locale, for example &locale=en, &locale=fr, or &locale=de

Example with a French locale:

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

If the locale is invalid or unsupported, the chatbox falls back to English.

Use the link from a custom page

If you want to expose the chatbox from a branded page such as https://acme.com/contact-us, create a page on your own domain and either redirect to the direct link or embed the chatbox in an iframe.

See How can I embed the Crisp Chatbox in an iFrame? if you want to display the chatbox from a page you control.

Updated on: 03/05/2026

Was this article helpful?

Thank you!