метод REST scope: humanresources

humanresources.node.communication.edit

Изменить коммуникации отдела

Кто может выполнять: пользователь с правом «Редактирование отделов» или «Редактирование команд»

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод humanresources.node.communication.edit привязывает, отвязывает или создает чат, канал или коллаб для отдела или команды.

Параметры

nodeId integer обязательный

Идентификатор отдела или команды.

Идентификатор можно получить методом humanresources.node.list

communicationType string обязательный

Тип коммуникации.

Возможные значения:

  • CHAT — чат
  • CHANNEL — канал
  • COLLAB — коллаб
createDefault boolean необязательный

Создает коммуникацию по умолчанию для отдела или команды.

Возможные значения:

  • true — создать коммуникацию по умолчанию
  • false — не создавать коммуникацию по умолчанию

По умолчанию — false

ids array необязательный

Идентификаторы коммуникаций, которые нужно привязать.

Идентификаторы чатов и каналов можно получить методом im.recent.list, а идентификаторы коллабов — методом socialnetwork.api.workgroup.list

removeIds array необязательный

Идентификаторы коммуникаций, которые нужно отвязать.

Идентификаторы связанных коммуникаций можно получить методом humanresources.node.communication.list

withChildren boolean необязательный

Применяет изменение к дочерним отделам и командам.

Возможные значения:

  • true — применить изменение к дочерним отделам и командам
  • false — применить изменение только к отделу или команде из параметра nodeId

По умолчанию — false

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"nodeId":15,"communicationType":"CHAT","ids":[21],"removeIds":[18],"createDefault":false,"withChildren":false}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/humanresources.node.communication.edit

Ответ

HTTP-статус: 200

{
    "result": {
        "success": true
    },
    "time": {
        "start": 1780407100,
        "finish": 1780407100.186404,
        "duration": 0.18640398979187012,
        "processing": 0.1328411102294922,
        "date_start": "2026-06-02T16:31:40+03:00",
        "date_finish": "2026-06-02T16:31:40+03:00",
        "operating_reset_at": 1780407700,
        "operating": 0
    }
}

Возвращаемые данные

result object

Объект с результатом операции

success boolean

Значение true, если коммуникации изменены

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "message": "Parameter \"communicationType\" is required.",
                "field": "communicationType"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
nodeId Parameter "nodeId" is required. Передайте идентификатор отдела или команды
communicationType Parameter "communicationType" is required. Передайте тип коммуникации
communicationType Invalid "communicationType" value. Allowed: CHAT, CHANNEL, COLLAB. Передайте одно из допустимых значений

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.