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://visitorchat.twt.com/direct/{YOUR_APP_ID}?lang=en

Code	Language
zh-cn	Simplified Chinese (default)
zh-tw	Traditional Chinese
en	English

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://visitorchat.twt.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.