URL Parameters

Use URL parameters to customize the chat page language and pass customer information from your own system into TWT Chat.

Language Parameter

Append ?lang= to switch the interface language:

https://visitor.chattwt.com/direct/{YOUR_APP_ID}?lang=en

Code	Language
zh-cn	Simplified Chinese (default)
zh-tw	Traditional Chinese
en	English
ja	Japanese
ko	Korean
de	German
fr	French
pt	Portuguese
ru	Russian

If lang is omitted, the page detects the browser language and falls back to en when the language is not supported. Portuguese browser variants such as pt-PT and pt-BR are normalized to pt.

Customer Information Parameters

Pass internal customer information to the chat page so agents can identify the visitor in the workspace.

Parameter	Type	Description
sbs	string	Unique customer identifier
sbs_mm	string	Customer signature
ranstr	string	Random string, recommended to be at least 16 characters
name	string	Customer full name
nickname	string	Customer nickname
email	string	Customer email
phone	string	Customer phone number

sbs_mm Generation Rule

sbs_mm = md5( md5(sbs + '_' + AppSecret) + '_' + ranstr )

• MD5 output must be lower-case 32 characters
• AppSecret is required to generate sbs_mm. Create it in Developer Settings and keep it private

Full Example

https://visitor.chattwt.com/direct/8cba81d468aac01b4f15f8ea4ef33677?sbs={sbs}&sbs_mm={sbs_mm}&ranstr={ranstr}&name={name}&nickname={nickname}&email={email}&phone={phone}

danger

Generate the sbs_mm signature on the server side only. Never expose AppSecret in frontend code or URLs.