TalkJS Documentation

The Chat API + Javascript SDK for websites and apps

Log in or Sign up to view personalized docs.

User

Thursday, September 3, 2020 4:29 AM

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

__sync
boolean
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

id
string | number