[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-openlines\u002Fconfig\u002Fcreate":3,"docs-tabs-openlines\u002Fconfig\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать конфигурацию открытой линии\n\n`POST \u002Fv1\u002Fopenline-configs`\n\nСоздаёт новую конфигурацию открытой линии. Для создания достаточно передать хотя бы одно распознанное записываемое поле — остальные параметры устанавливаются по умолчанию. Полная запись с идентификаторами и всеми полями доступна через `GET \u002Fv1\u002Fopenline-configs\u002F:id`.\n\n## Поля запроса (body)\n\nМинимум для создания: хотя бы одно распознанное записываемое поле (см. [Поля конфигурации](\u002Fdocs\u002Fopenlines\u002Fconfig\u002Ffields)).\n\n**Имена полей.** Все поля передавайте в camelCase (`name`, `active`, `queueType`, `crmCreate`, `workTimeFrom` и т. д. — см. [Поля конфигурации](\u002Fdocs\u002Fopenlines\u002Fconfig\u002Ffields)) — это канонический регистр, как они приходят в ответе и в `GET \u002Fv1\u002Fopenline-configs\u002Ffields`. B24-native UPPER_SNAKE_CASE-имена также принимаются для обратной совместимости и приводятся к нужному имени Битрикс24 автоматически. Пример ниже использует camelCase.\n\n**Булевы поля** (`active`, `crm`, `workTimeEnable`, `welcomeMessage`, …) принимают `true` \u002F `false` — значение приводится к ожидаемому Битрикс24 `\"Y\"`\u002F`\"N\"` автоматически.\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|-------|---------|\n| `name` | string | нет | Название открытой линии |\n| `active` | boolean | нет | Активна ли линия (`true` \u002F `false`) |\n| `queueType` | string | нет | Распределение очереди: `all` — всем одновременно, `evenly` — равномерно, `strictly` — строго по порядку |\n| `queueTime` | number | нет | Время ожидания в очереди (секунды) до перевода |\n| `noAnswerTime` | number | нет | Время без ответа (секунды), после которого срабатывает правило `noAnswerRule` |\n| `crm` | boolean | нет | Включить интеграцию с CRM |\n| `crmCreate` | string | нет | Режим создания CRM-сущностей при новом обращении |\n| `workTimeEnable` | boolean | нет | Включить расписание рабочего времени |\n| `workTimeFrom` | string | нет | Начало рабочего дня (например `\"9\"` или `\"9.30\"`) |\n| `workTimeTo` | string | нет | Конец рабочего дня (например `\"18\"` или `\"18.30\"`) |\n| `workTimeTimezone` | string | нет | Часовой пояс расписания (например `\"Europe\u002FMoscow\"`) |\n| `welcomeMessage` | boolean | нет | Включить приветственное сообщение |\n| `welcomeMessageText` | string | нет | Текст приветственного сообщения |\n| `languageId` | string | нет | Язык линии (например `\"ru\"`, `\"en\"`) |\n\nПолный список полей — [`GET \u002Fv1\u002Fopenline-configs\u002Ffields`](\u002Fdocs\u002Fopenlines\u002Fconfig\u002Ffields).\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fopenline-configs \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"name\": \"Поддержка клиентов\",\n    \"active\": true,\n    \"queueType\": \"evenly\",\n    \"workTimeEnable\": true,\n    \"workTimeFrom\": \"9\",\n    \"workTimeTo\": \"18\"\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fopenline-configs \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"name\": \"Поддержка клиентов\",\n    \"active\": true,\n    \"queueType\": \"evenly\",\n    \"workTimeEnable\": true,\n    \"workTimeFrom\": \"9\",\n    \"workTimeTo\": \"18\"\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fopenline-configs', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    name: 'Поддержка клиентов',\n    active: true,\n    queueType: 'evenly',\n    workTimeEnable: true,\n    workTimeFrom: '9',\n    workTimeTo: '18',\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('Новая конфигурация ID:', data)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fopenline-configs', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    name: 'Поддержка клиентов',\n    active: true,\n    queueType: 'evenly',\n    workTimeEnable: true,\n    workTimeFrom: '9',\n    workTimeTo: '18',\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('Новая конфигурация ID:', data)\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | number | Идентификатор созданной конфигурации |\n| `meta.warnings` | string[] | Необязательное. Присутствует, если часть переданных полей не распознана — перечисляет ключи, которые Битрикс24 проигнорировал |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": 29\n}\n```\n\n## Пример ответа при ошибке\n\n400 — в теле нет ни одного распознанного поля:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"VALIDATION_ERROR\",\n    \"message\": \"No recognised openline-configs field in the body. Unrecognised: bogusField. Provide at least one known field (e.g. lineName, queueType, active) — see GET \u002Fv1\u002Fopenline-configs\u002Ffields.\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `VALIDATION_ERROR` | Тело запроса пустое — не передано ни одного поля |\n| 400 | `VALIDATION_ERROR` | В теле нет ни одного распознанного поля (все ключи неизвестны) — в сообщении перечислены нераспознанные поля |\n| 400 | `READONLY_FIELD` | В теле передано поле только для чтения (`id`, `queue`, `dateCreate` и другие) |\n| 401 | `TOKEN_MISSING` | Заголовок `X-Api-Key` не передан |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `imopenlines` |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n`data` в ответе — это число (идентификатор новой конфигурации), а не объект записи. Чтобы получить созданную конфигурацию со всеми полями, выполните отдельный запрос: `GET \u002Fv1\u002Fopenline-configs\u002F:id`.\n\n**Нераспознанные поля.** Битрикс24 молча игнорирует незнакомые ключи метода `imopenlines.config.add`. Обёртка сверяет тело с полной схемой полей ([Поля конфигурации](\u002Fdocs\u002Fopenlines\u002Fconfig\u002Ffields)) и реагирует так:\n\n- ни одно поле не распознано (например `{ \"bogusField\": \"x\" }`) — запрос отклоняется с `400 VALIDATION_ERROR` до вызова Битрикс24, в сообщении перечислены нераспознанные поля.\n- распознано хотя бы одно поле, но часть ключей неизвестна — конфигурация создаётся, а в ответе возвращается `meta.warnings` со списком проигнорированных ключей.\n- в теле передано поле только для чтения (`id`, `queue`, `dateCreate` и другие) — запрос отклоняется с `400 READONLY_FIELD`.\n\n## Смотрите также\n\n- [Получить конфигурацию](\u002Fdocs\u002Fopenlines\u002Fconfig\u002Fget)\n- [Список конфигураций](\u002Fdocs\u002Fopenlines\u002Fconfig\u002Flist)\n- [Поля конфигурации](\u002Fdocs\u002Fopenlines\u002Fconfig\u002Ffields)\n","2026-07-21",{}]