Articles on: Install Crisp

How can I generate the direct external link of my Chatbox?

You may be looking to share the direct link of your Crisp Chatbox with your customers if you haven't installed it on a website, but also if you wish to easily and quickly load it for some tests. This is easily done thanks to this guide.

Generating the external chatbox link

First and foremost, you will need to obtain your Website ID
Simply replace MY_WEBSITE_ID in this URL by yours: https://go.crisp.chat/chat/embed/?website_id=MY_WEBSITE_ID
And voilà! You can open this link on your browser or share it with your users

__Example: __

If your Website ID is e93e073a-1f69-4cbc-8934-f9e1611e65bb,

then your direct chatbox link would be: https://go.crisp.chat/chat/embed/?website_id=e93e073a-1f69-4cbc-8934-f9e1611e65bb

Passing user information to the chatbox

You can optionally pass certain data to the direct link (such as the user's email address or their nickname).

The following options are available:

User email: use the user_email parameter (eg: &user_email=john.doe%40crisp.chat)
User phone: use the user_phone parameter (eg: &user_phone=%2B33240031187‬)
User nickname: use the user_nickname parameter (eg: &user_nickname=John%20Doe)
User avatar: use the user_avatar parameter (eg: &user_avatar=https%3A%2F%2Fimage.enrich.email%2Fperson%2Favatar%2F7d47b5be7e31885719e6587eb49fd50403045c80.jpg)
Session ID: use the crisp_sid parameter (eg: &crisp_sid=CRISP_SESSION_ID)
Session token: use the token_id parameter (eg. &token_id=TOKEN_ID - see tokens docs )
Session merge: use the session_merge parameter (eg. &session_merge=true - see tokens docs )

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

Make sure to URL encode values before you pass them to the embed URL.

If you are looking to generate a direct link by using a custom domain (such as https://acme.com/contact-us) or use our JS SDK to perform more actions (like starting a Bot scenario or pushing segments), you can check out this guide to see how to implement the chatbox in an iFrame and display it in full page

Changing the chatbox's locale

You can force also force the chatbox's locale to adapt it to your user's language, similarly to how you can pass user data above.

This is done with:

Locale: use the locale parameter (eg: &locale=en, &locale=fr, &locale=de any other locale code)

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

If you pass in an invalid or unsupported locale, the chatbox will fallback to English

Updated on: 15/09/2025

Was this article helpful?

Thank you!