Artikelen over: 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](https://go.crisp.chat/chat/embed/?website_id=e93e073a-1f69-4cbc-8934-f9e1611e65bb&user_email=john.doe%40crisp.chat&user_nickname=John Doe)

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

Bijgewerkt op: 12/02/2026

Was dit artikel nuttig?

Dankuwel!