class User

A user of your app. TalkJS uses the id to uniquely identify this user. All other fields of a User are allowed to vary over time and the TalkJS database will update its fields accordingly.

Methods

Constructor

Create a TalkJS User

Properties

availabilityText string \| null	Availability acts similarly to welcomeMessage but appears as a system message.
configuration string \| null	Deprecated. Please use role instead.
custom { [name: string]: string \| null } \| null	Allows you to set custom metadata for the User
email string \| Array<string> \| null	One or more email address belonging to the User. The email addresses will be used for Email Notifications if they are enabled.
id string	The unqiue ID which is used to identify the user in TalkJS
locale string \| null	The locale field expects an IETF language tag. See the localization documentation.
name string	The User's name which will be displayed on the TalkJS UI
phone string \| Array<string> \| null	One or more phone numbers belonging to the User. The phone number will be used for SMS Notifications (this feature requires standard plan and up).
photoUrl string \| null	An optional URL to a photo which will be displayed as the user's avatar
role string \| null	TalkJS supports multiple sets of settings, called "roles". These allow you to change the behavior of TalkJS for different users. You have full control over which user gets which configuration.
welcomeMessage string \| null	The default message a user sees when starting a chat with that person

Method Details

Constructors

new User(options)

Create a TalkJS User

Use this constructor to synchronize user data with the TalkJS backend.

The fields id, name and email are required. A warning will be emitted if role is not specified.

Set email to null if you want to use TalkJS without email fallback.

Parameters

options

UserOptions

new User(id)

Create a TalkJS User

Only use this constructor if you're sure that a user by the given id already exists in TalkJS (for instance, because you synchronized it via the REST API). Otherwise use the new User(options: object): constructor instead.

Parameters

string | number