Skip to main content
Property nameTypeDescription
_idstringID of the dialog. Generated automatically by the server after dialog creation.
user_idintID of dialog’s owner.
created_atdatetimeDate & time when a record was created, filled automatically.
updated_atdatetimeDate & time when a record was updated, filled automatically.
typeintType of dialog. Possible values are:type=1 (PUBLIC_GROUP)type=2 (GROUP)type=3 (PRIVATE)
namestringName of a group chat. Makes sense if type=1 (PUBLIC_GROUP) or type=2 (GROUP). The maximum length for the dialog name is 200 symbols.
photostringPhoto of a group chat. Makes sense if type=1 (PUBLIC_GROUP) or type=2 (GROUP). Can contain a link to a file in Content module, Custom Objects module or just a web link.
xmpp_room_jidstringJID of XMPP room for group chat to connect. Null if type=3 (PRIVATE). Generated automatically by the server after dialog creation.
occupants_ids[]array of intArray of users’ IDs - dialog occupants. Empty array when type=1 (PUBLIC_GROUP) because public dialogs available for everyone.
admin_ids[]array of intArray of users’ IDs - dialog admins. Applicable only to type=1 (PUBLIC_GROUP) and type=2 (GROUP). For type=3 (PRIVATE), returns an empty array. Added in v2.52.0.
last_messagestringLast sent message in this dialog.
last_message_date_senttimestampTimestamp of last sent message in this dialog.
last_message_user_idintID of the user who sent last message in this dialog.
unread_messages_countintNumber of unread messages in this dialog for a current user.
is_join_requiredint (0 or 1)Defines whether a user must join the dialog before sending/receiving messages via XMPP. Applies only to type=2 (GROUP). 0 - join not required. 1 - join required. Null if type=1 or type=3.
dataobject- Information about class and fields in Custom Objects. - Any dialog can be extended using Custom Objects to store additional parameters.
data.class_namestringClass name in Custom Objects.
data.{field_name_N}stringField name of class in Custom Objects. Can be many: 1..N.