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
Availability acts similarly to welcomeMessage but appears as a system message.
configuration
string

Deprecated. Please use role instead.

custom
{     [name: string]: string }
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
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
An optional URL to a photo which will be displayed as the user's avatar
role
string
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
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

id
string | number