AddParticipant

[POST] .../v1/chat/addparticipant

Добавляет одного участника в чат.

Входные параметры

Ограничения и проверки

• chat_id обязателен и должен быть корректным UUID существующего чата.
• Поле participant обязательно.
• Для participant обязательны корректные entity_type, entity_id и role (entity_id > 0).
• Допустимые типы участника для этого метода: User, Client.
• ChatBot добавляется только методом Chat/AddBot.
• На сервере роль нормализуется по типу участника: User -> Staff, Client -> Member.
• Метод доступен участнику чата с ролью Staff.
• Пользователь с правом chat_manage_all (688) может добавлять участника в любой обычный чат.
• Для entity-чатов (Task/Lead/Deal/Ticket) прямое изменение состава участников через этот метод запрещено.
• Для entity-чатов обратная синхронизация из Chat/* в сущность не выполняется; состав берется только из связанной сущности.
• Для нового участника заполняется персональная read-история по уже существующим сообщениям чата.

Пример запроса

{
  "chat_id": "6f6fdb2f-7d0b-4c34-b6fd-1fbcf40d37ef",
  "participant": {
    "entity_type": "User",
    "entity_id": 31,
    "role": "Member"
  }
}

Выходные параметры

Пример ответа

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": null
  }
}