06.04.2026 22:55

Chat

Модель, описывающая чат

Название Тип данных Описание
id String UUID чата
name String Наименование чата
logo_url String Ссылка на логотип чата
last_message_id String UUID последнего сообщения
last_message_date Int64 Дата последнего сообщения (Unix time, сек.)
last_message_text String Текст последнего видимого сообщения (для staff-only сообщений подбирается ближайшее доступное)
created_user_id Int64 ID пользователя, создавшего чат
last_update Int64 Дата последнего изменения записи (Unix time, сек.)
closed Boolean Признак закрытого чата
closed_date Int64 Дата закрытия чата (Unix time, сек.)
entity_type Enum Тип связанной бизнес-сущности (Task, Lead, Deal, Ticket)
entity_id Int64 ID связанной бизнес-сущности
unread_count Int64 Количество непрочитанных сообщений текущего пользователя
participants Array of ChatParticipant Участники чата
ChatParticipant
Название Тип данных Описание
entity_type Enum Тип участника: User, Client, ChatBot
entity_id Int64 ID сущности участника
role Enum Роль участника: Staff, Member или Bot
name String Отображаемое имя участника
photo_url String Ссылка на фото участника
joined_date Int64 Дата вступления в чат (Unix time, сек.)
last_update Int64 Дата последнего изменения участника (Unix time, сек.)
ChatEntityTypeEnum
Значение Описание
User Пользователь
ChatBot Чат-бот
Client Клиент
ChatParticipantRoleEnum
Значение Описание
Staff Сотрудник
Member Участник
Bot Бот
ChatBot
Название Тип данных Описание
id Int64 ID чат-бота
name String Название чат-бота
photo_url String URL фотографии чат-бота
connected_integration_id String ID подключенной интеграции чат-бота
ChatLinkedEntityTypeEnum
Значение Описание
Task Чат связан с задачей проекта
Lead Чат связан с CRM-лидом
Deal Чат связан с CRM-сделкой
Ticket Чат связан с CRM-обращением

Для чатов, связанных с Lead/Deal/Ticket/Task:

  • доступ к Chat/* и ChatMessage/* наследуется от прав связанной сущности;
  • управление участниками выполняется только через связанный объект (Lead, Deal, ProjectTask, Ticket);
  • редактирование чата через Chat/Edit запрещено.