By default, the Crisp chatbox is embedded on your website, as a little box that can be opened and closed. However, if you would like to be able to share a link that pops up a Crisp chatbox in full-screen that users cannot close, this article may help you.

Crisp provides a simple way to build links that open up the chatbox in full-screen. That way, you can easily create custom links that open the chatbox in a new browser tab; or share this direct link in emails. It's also useful if you want to include Crisp using an Iframe

The Crisp chatbox can be opened in full-screen

Here's how to proceed:

Go to: https://app.crisp.chat/
Go to your website settings: click on the cog icon on the bottom-left corner, then click on "Websites" and select your website in the list
Grab the Website ID code by clicking on "Get chatbox code" (we'll call it WEBSITE_ID there, a valid Website ID looks like: e30a04ee-f81c-4935-b8d8-5fa55831b1c0)
Alternatively, your website ID can be found in the Crisp App URL https://app.crisp.chat/website/[WEBISTE_ID]/inbox/

Your URL will take the following form (replace with your WEBSITE_ID):

https://go.crisp.chat/chat/embed/?website_id=WEBSITE_ID

Example (replace with your WEBSITE_ID):

https://go.crisp.chat/chat/embed/?website_id=-SzqEmZ56venQuQw4YV1

Pass User Data

You can pass optional user data to the embed URL (user email and nickname). This will be saved once the chat is ready:

User email: use the user_email parameter (eg: &user_email=valerian%40crisp.chat)
User phone: use the user_phone parameter (eg: &user_phone=%2B33630138382)
User nickname: use the user_nickname parameter (eg: &user_nickname=Valerian%20Saliou)
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. &oken_id=TOKEN_ID - see tokens docs)
Session merge: use the session_merge parameter (eg. &session_merge=true - see tokens docs)

Notice: make sure to URL encode values before you pass them to the embed URL.

Force Chat Locale

You can force the chat locale and disable the locale auto-detect feature:

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

If you pass in an invalid or unsupported locale, the chatbox will fallback to English (en).
Was this article helpful?
Thank you!