Website chat

The snippetCopy Anchor Link

Copy your snippet from "2. Put the chat window on your website" (2. 把客服窗口装到你的网站) on the Setup (接入) page of the console, and paste it before </body> on every page of your site:

<script src="https://askpurser.com/embed/v1.js" data-key="pk_…" async></script>

• data-key is your workspace's publishable key, starting with pk_. It is public by design and can only open a chat.
• async keeps the script from blocking your page. Pasting it twice on one page still loads it once.
• A round button appears in the bottom right (or bottom left) corner and opens the chat window. The window is 380px wide; on screens 480px wide or less (phones) it fills the screen.
• The chat runs in its own iframe served from askpurser.com, so other scripts on your site (analytics, session recorders, browser extensions) cannot read the conversation or the customer's orders.
• When a customer opens the chat, it carries the current page's title and address so the AI knows what they're looking at (see Shopping and sales). With proactive outreach on, the script also checks things like how long they've been on a product page, in the browser; none of that is uploaded.
• Every error inside the script is caught; it never breaks your page.

Optional attributesCopy Anchor Link

Which workspace it belongs to, how it looks and what it may do are all decided by the server; nothing on the page can change them.

Open it from your own buttonCopy Anchor Link

<script src="https://askpurser.com/embed/v1.js" data-key="pk_…" data-hidden async></script>

<button onclick="window.Purser.open()">Contact us</button>

Once the script has loaded, window.Purser has these methods:

If your site sends a Content Security PolicyCopy Anchor Link

If your site has a Content-Security-Policy header, allow askpurser.com:

script-src  https://askpurser.com
frame-src   https://askpurser.com
connect-src https://askpurser.com

The button is styled with a stylesheet inside a Shadow DOM, so style-src does not need to change.

Allowed websitesCopy Anchor Link

On the Setup (接入) page, under Allowed websites (允许的网站), enter one storefront address per line, for example https://shop.example.com, then click Save (保存).

• It must be https; only http://localhost may use http. Up to 20 entries.
• Only the scheme, host and port count; any path is dropped. www. and the bare domain are two different addresses, so list both if you use both.
• Changes apply shortly after you save; you do not need to paste the snippet again.

On a site that isn't listed, a real workspace shows no chat button (the browser console says why). Such sites appear above Allowed websites, under "These sites have the chat window installed but aren't allowed yet"; if one is your shop, click Allow this site (允许这个网站).

The in-app support page is not restricted by this list.

StylingCopy Anchor Link

Chat window style (客服窗口样式) on the Setup page has four settings, with a live preview beside them:

Text on the button, the customer's message bubbles and the send button is always white, so the accent colour must reach a 4.5:1 contrast ratio against white (WCAG AA). A colour that is too light cannot be saved; the page offers a darker colour of the same hue, and clicking "Use #……" (改用 #……) applies it.

After you save, the change shows on your site within seconds (reload the page to see it), and within 5 minutes at most. These four settings are all there is: custom CSS is not supported.

"Powered by purser"Copy Anchor Link

The bottom of the chat window shows a small "Powered by purser" line linking to askpurser.com.

• On Free it is always shown and cannot be turned off.
• On Starter, Growth and Scale you can turn it off in Settings (设置) → Plan & billing (套餐与账单), on the "由 purser 提供" card.
• If a paid plan ends, or a failed payment runs past the grace period and the workspace falls back to Free limits, it shows again.

Signed-in customersCopy Anchor Link

By default every conversation is anonymous, and the AI does not reveal any order details.

To let the AI answer "where is my order", your server signs an identity token for the signed-in customer and your page hands it to the chat window:

<script>
  window.Purser = window.Purser || {};
  window.Purser.identity = async () => {
    const vid = localStorage.getItem("purser_vid");
    const r = await fetch("/purser-token?vid=" + encodeURIComponent(vid));
    return r.ok ? r.text() : null; // null when nobody is signed in
  };
</script>

This can go before or after the snippet. /purser-token is an endpoint on your own site, and purser_vid is the visitor ID the snippet creates in the browser.

• A token is valid for 10 minutes at most, can be used once, and is bound to that visitor ID.
• An invalid token makes the conversation anonymous; nothing errors.
• When the customer signs in or out, call Purser.identify(newToken or null) and the window starts a new conversation. If the page no longer provides a token, the next chat is a new anonymous one; it never continues the previous customer's conversation.

How to sign tokens, and the full rules: Identity tokens.

Self-service before the chat startsCopy Anchor Link

Before the customer's first message, the chat window shows under the greeting:

• A "Check my orders" button, for signed-in customers who have orders with you (a site with no order data, such as a SaaS, never shows it). It answers with the status and tracking of their 3 latest orders from fixed templates: no AI, and not counted as an AI conversation. A parcel in trouble (lost, exception, returned) is also handed to a person.
• Common questions, when the help center is on: up to 5 articles (featured ones first, in the customer's language). Tapping one shows the answer right in the chat window with a "Read the full article" link; again no AI and nothing metered.

The block folds away once the customer writes.

LanguagesCopy Anchor Link

The window's interface (input box, buttons, notices) comes in 12 languages: English, Simplified Chinese, Traditional Chinese, Japanese, Korean, Spanish, French, German, Portuguese, Thai, Vietnamese and Indonesian.

• The interface language is, in order: the one set with Purser.setLocale(code) → the script's data-locale → the page's <html lang> → the customer's browser language. Chinese from Taiwan, Hong Kong and Macau uses Traditional Chinese. Any other language shows English.
• On a bilingual site (say /docs and /zh/docs), the window follows the page as long as each language's pages set <html lang> correctly. When a single-page app switches language and updates <html lang>, an open window switches too, without a reload.
• Use data-locale to fix the interface language; it then no longer follows <html lang>.

AI replies are not translated: the AI writes directly in the language of the customer's latest message, whatever the language of your knowledge base or the interface. A customer who asks in Japanese gets an answer in Japanese.

AI disclosureCopy Anchor Link

The chat window tells customers they are talking to an AI, and you cannot turn this off:

• Every conversation starts with a greeting that says this is your shop's AI assistant and that a person can take over at any time. In English: "Hi! I'm Blind Box Tokyo's AI assistant. Ask me anything — a person from our team can take over whenever you like." The store name is your workspace name.
• AI replies are labelled "AI assistant", and replies from your team "Customer service".

In a test workspace and in Try it, the window shows "Test mode" next to its title.

AlsoCopy Anchor Link

• Customers can send photos with Add a photo (JPEG, PNG, WebP or HEIC, up to 10 MB).
• Customers can tap the microphone to send a voice message (up to 60 seconds); see Voice messages.
• You can add a feedback entry to the top of the window; see Product feedback.