Special Operations in Chats: Overview of Methods

Special operations help manage chats: marking messages as read, pinning chats, disabling notifications, or removing dialogues from the recent chats list.

Quick Navigation: All Methods and Events

User Documentation: Chats in Bitrix24: Interface and Capabilities

Connection of Special Operations with Other ObjectsConnection of Special Operations with Other Objects

Chat. Special operations with chats are performed using the chat identifier DIALOG_ID or CHAT_ID. You can obtain the chat identifier using the chat creation method im.chat.add or by retrieving the chat identifier with im.chat.get.

Pin a ChatPin a Chat

To avoid losing an important chat, pin it at the top of the list. You can pin or unpin a chat using the method im.recent.pin.

Mark a Chat as ReadMark a Chat as Read

If you want to return to a read message later, use the "View Later" label. The method im.recent.unread manages this label:

• The parameter ACTION with the value Y sets the "View Later" label.

• The parameter ACTION with the value N marks all messages as read and removes the label.

The method im.dialog.read.all sets the "Read" label for all dialogues.

Disable Chat NotificationsDisable Chat Notifications

In group chats where immediate responses to messages are not required, you can disable notifications. The method im.chat.mute allows you to turn notifications off or on.

Remove a Chat from Recent ListRemove a Chat from Recent List

The method im.recent.hide removes a dialogue from the recent chats list.

Overview of MethodsOverview of Methods

Scope: im

Who can execute the method: depending on the method

Method	Description
im.recent.pin	Pins the chat at the top of the chat list
im.recent.unread	Sets or removes the "read" status for the chat
im.dialog.read.all	Sets the "read" status for all user chats
im.chat.mute	Disables notifications from the chat
im.recent.hide	Removes the chat from the recent list