> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.chrisp.chat/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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

1. First and foremost, you will need to [obtain your Website ID](https://help.crisp.chat/en/article/where-can-i-find-my-website-id-1ylqx1s/)
2. Simply replace `` `MY_WEBSITE_ID` `` in this URL by yours: [`` `https://go.crisp.chat/chat/embed/?website_id=MY_WEBSITE_ID` ``](https://go.crisp.chat/chat/embed/?website_id=MY_WEBSITE_ID)
3. 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](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](https://docs.crisp.chat/guides/chatbox-sdks/web-sdk/session-continuity/) )
* ****Session merge:**** use the `` `session_merge` `` parameter (eg. `` `&session_merge=true` `` - see [tokens docs](https://docs.crisp.chat/guides/chatbox-sdks/web-sdk/session-continuity/) )

__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](/en/article/how-can-i-embed-the-crisp-chatbox-in-an-iframe-bkfh98/) 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](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