> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.crisp.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 to Create and Customize a Direct Link to your Crisp Chatbox *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](https://crisp.chat/en/livechat/) 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](#1-find-your-website-id) → retrieve the unique identifier of your Crisp workspace * [Generate the direct chatbox link](#2-generate-the-direct-chatbox-link) → create the URL visitors can open * [Test the chatbox link](#3-test-the-chatbox-link) → confirm that messages reach your Crisp Inbox * [Pass visitor information](#4-pass-visitor-information) → prefill useful customer details through URL parameters * [Maintain the visitor session](#5-maintain-the-visitor-session) → connect the link to an existing Crisp session * [Set the chatbox language](#6-set-the-chatbox-language) → open the chatbox in a selected locale * [Share or embed the chatbox link](#7-share-or-embed-the-chatbox-link) → use the link from another page or platform --- # ${color}[#0080dd](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**. ![Copy the Website ID from Setup and Integrations](https://storage.crisp.chat/users/helpdesk/website/-/8/7/a/e/87ae2703583ac800/website-id_1fydlo6.png =1000xauto) | For more details, see [Where to find my Website ID](https://help.crisp.chat/en/article/where-to-find-my-website-id-1ylqx1s/). --- # ${color}[#0080dd](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. || The direct link opens the chatbox configured for the selected workspace. It does not create a separate chatbox or a separate Inbox. --- # ${color}[#0080dd](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**](https://app.crisp.chat/). 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. | If you need to change the chatbox appearance, read [How to customize the chatbox](https://help.crisp.chat/en/article/how-to-customize-the-chatbox-1hj537j/). --- # ${color}[#0080dd](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. #### ${color}[#445055](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` ||| Always URL-encode parameter values before adding them to the chatbox link. Avoid placing passwords, payment information, authentication secrets, or other sensitive data directly inside a URL. --- # ${color}[#0080dd](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. | For implementation details, authentication, and token usage, read the [Crisp session continuity documentation](https://docs.crisp.chat/guides/chatbox-sdks/web-sdk/session-continuity/). --- # ${color}[#0080dd](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` || If the selected locale is invalid or unsupported, the chatbox falls back to English. --- # ${color}[#0080dd](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. | To display the chatbox directly inside a webpage, see [How can I embed the Crisp Chatbox in an iFrame?](https://help.crisp.chat/en/article/how-to-embed-the-crisp-live-chat-chatbox-in-an-iframe-bkfh98/). --- # ${color}[#0080dd](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.* ###### ${color}[#F08820](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. ###### ${color}[#F08820](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. ###### ${color}[#F08820](Can Hugo AI Agent answer conversations from the direct link?) Yes. If [Hugo AI Agent](https://hugo.ai/en/) is active on the workspace, it can handle conversations opened from the direct chatbox link according to your activation, instruction, and routing settings. ###### ${color}[#F08820](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.