new GroupChat()

Extends
Chat

Properties

archived  unknown

Indicates if the Chat is archived

Inherited from
Chat#archived

createdAt  date

Gets the date at which the group was created

description  string

Gets the group description

id  unknown

ID that represents the chat

Inherited from
Chat#id

isGroup  unknown

Indicates if the Chat is a Group Chat

Inherited from
Chat#isGroup

isMuted  unknown

Indicates if the chat is muted or not

Inherited from
Chat#isMuted

isReadOnly  unknown

Indicates if the Chat is readonly

Inherited from
Chat#isReadOnly

muteExpiration  unknown

Unix timestamp for when the mute expires

Inherited from
Chat#muteExpiration

name  unknown

Title of the chat

Inherited from
Chat#name

owner  ContactId

Gets the group owner

participants  Array of GroupParticipant

Gets the group participants

pinned  unknown

Indicates if the Chat is pinned

Inherited from
Chat#pinned

timestamp  unknown

Unix timestamp for when the last activity occurred

Inherited from
Chat#timestamp

unreadCount  unknown

Amount of messages unread

Inherited from
Chat#unreadCount

Methods

async

addParticipants(participantIds) → Promise containing Object

Adds a list of participants by ID to the group

Parameter

Name Type Optional Description

participantIds

Array of string

 

Returns

Promise containing Object 

async

archive()

Archives this chat

Inherited from
Chat#archive
async

clearMessages() → Promise containing Boolean

Clears all messages from the chat

Inherited from
Chat#clearMessages
Returns

result

async

clearState()

Stops typing or recording in chat immediately.

Inherited from
Chat#clearState
async

delete() → Promise containing Boolean

Deletes the chat

Inherited from
Chat#delete
Returns

result

async

demoteParticipants(participantIds) → Promise containing {status: number}

Demotes participants by IDs to regular users

Parameter

Name Type Optional Description

participantIds

Array of string

 

Returns

Promise containing {status: number} 

Object with status code indicating if the operation was successful

async

fetchMessages(searchOptions) → Promise containing Array of Message

Loads chat messages, sorted from earliest to latest.

Parameters

Name Type Optional Description

searchOptions

 

 

Options for searching messages. Right now only limit is supported.

Values in searchOptions have the following properties:

Name Type Optional Description

limit

 

Yes

The amount of messages to return. If no limit is specified, the available messages will be returned. Note that the actual number of returned messages may be smaller if there aren't enough messages in the conversation. Set this to Infinity to load all messages.

Inherited from
Chat#fetchMessages
Returns
async

getContact() → Promise containing Contact

Returns the Contact that corresponds to this Chat.

Inherited from
Chat#getContact
Returns
async

getInviteCode() → Promise containing string

Gets the invite code for a specific group

Returns

Promise containing string 

Group's invite code

async

getLabels() → Promise containing Array of Label

Returns array of all Labels assigned to this Chat

Inherited from
Chat#getLabels
Returns
async

leave() → Promise

Makes the bot leave the group

Returns

Promise 

async

markUnread()

Mark this chat as unread

Inherited from
Chat#markUnread
async

mute(unmuteDate)

Mutes this chat forever, unless a date is specified

Parameter

Name Type Optional Description

unmuteDate

 

 

Date at which the Chat will be unmuted, leave as is to mute forever

Value can be null.

Inherited from
Chat#mute
async

pin() → Promise containing boolean

Pins this chat

Inherited from
Chat#pin
Returns

New pin state. Could be false if the max number of pinned chats was reached.

async

promoteParticipants(participantIds) → Promise containing {status: number}

Promotes participants by IDs to admins

Parameter

Name Type Optional Description

participantIds

Array of string

 

Returns

Promise containing {status: number} 

Object with status code indicating if the operation was successful

async

removeParticipants(participantIds) → Promise containing Object

Removes a list of participants by ID to the group

Parameter

Name Type Optional Description

participantIds

Array of string

 

Returns

Promise containing Object 

async

revokeInvite() → Promise containing string

Invalidates the current group invite code and generates a new one

Returns

Promise containing string 

New invite code

async

sendMessage(content[, options]) → Promise containing Message

Send a message to this chat

Parameters

Name Type Optional Description

content

 

 

options

 

Yes

Inherited from
Chat#sendMessage
Returns

Message that was just sent

async

sendSeen() → Promise containing Boolean

Set the message as seen

Inherited from
Chat#sendSeen
Returns

result

async

sendStateRecording()

Simulate recording audio in chat. This will last for 25 seconds.

Inherited from
Chat#sendStateRecording
async

sendStateTyping()

Simulate typing in chat. This will last for 25 seconds.

Inherited from
Chat#sendStateTyping
async

setDescription(description) → Promise containing boolean

Updates the group description

Parameter

Name Type Optional Description

description

string

 

Returns

Promise containing boolean 

Returns true if the description was properly updated. This can return false if the user does not have the necessary permissions.

async

setInfoAdminsOnly([adminsOnly]) → Promise containing boolean

Updates the group settings to only allow admins to edit group info (title, description, photo).

Parameter

Name Type Optional Description

adminsOnly

boolean

Yes

Enable or disable this option

Defaults to true.

Returns

Promise containing boolean 

Returns true if the setting was properly updated. This can return false if the user does not have the necessary permissions.

async

setMessagesAdminsOnly([adminsOnly]) → Promise containing boolean

Updates the group settings to only allow admins to send messages.

Parameter

Name Type Optional Description

adminsOnly

boolean

Yes

Enable or disable this option

Defaults to true.

Returns

Promise containing boolean 

Returns true if the setting was properly updated. This can return false if the user does not have the necessary permissions.

async

setSubject(subject) → Promise containing boolean

Updates the group subject

Parameter

Name Type Optional Description

subject

string

 

Returns

Promise containing boolean 

Returns true if the subject was properly updated. This can return false if the user does not have the necessary permissions.

async

unarchive()

un-archives this chat

Inherited from
Chat#unarchive
async

unmute()

Unmutes this chat

Inherited from
Chat#unmute
async

unpin() → Promise containing boolean

Unpins this chat

Inherited from
Chat#unpin
Returns

New pin state