Статьи по теме: Installing Crisp

How to generate the direct external link of the Crisp live-chat chatbox

This article explains how to generate a direct external link for your Crisp chatbox.


A direct chatbox link is useful when you have not installed Crisp on a website, want to share a standalone support link, or need a quick way to test a chatbox. The link uses your Crisp Website ID and can optionally include supported user or session parameters.



Generate the external chatbox link


Start with your Website ID, then insert it into the Crisp chatbox embed URL.


To generate the link:


  1. Find your Website ID with this guide.
  2. Replace `MY_WEBSITE_ID` in this URL: `https://go.crisp.chat/chat/embed/?website_id=MY_WEBSITE_ID`.
  3. Open the generated URL in your browser or share it with your users.


Example:


If your Website ID is `e93e073a-1f69-4cbc-8934-f9e1611e65bb`, your direct chatbox link is `https://go.crisp.chat/chat/embed/?website_id=e93e073a-1f69-4cbc-8934-f9e1611e65bb`.



Pass user information to the chatbox


You can add supported URL parameters to prefill or bind useful information to the chatbox session.


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`, with a URL-encoded image URL
  • 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`


Example with user data:


[`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)


Always URL-encode parameter values before adding them to the chatbox link.


For session continuity and token usage, see the Crisp session continuity documentation.



Force the chatbox locale


You can also force a locale from the URL. This is useful if the link is shared from a localized page or campaign.


Locale parameter:


  • Locale → use `locale`, for example `&locale=en`, `&locale=fr`, or `&locale=de`


Example with a French locale:


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


If the locale is invalid or unsupported, the chatbox falls back to English.



Use the link from a custom page


If you want to expose the chatbox from a branded page such as `https://acme.com/contact-us`, create a page on your own domain and either redirect to the direct link or embed the chatbox in an iframe.


See How can I embed the Crisp Chatbox in an iFrame? if you want to display the chatbox from a page you control.

Последнее изменение: 05/05/2026

Была ли эта статья полезна?

Поделиться отзывом

Отменить

Спасибо!