## Изменить быстрый ответ `PATCH /v1/openline-configs/:lineId/quick-replies/:id` Заменяет текст быстрого ответа открытой линии и при необходимости переносит его в другой раздел или убирает из раздела. ## Параметры | Параметр | Тип | Обяз. | Описание | |----------|-----|:-----:|----------| | `lineId` (path) | integer | да | ID открытой линии. Список: [`GET /v1/openline-configs`](/docs/openlines/config/list) | | `id` (path) | integer | да | ID быстрого ответа этой линии. Список: `data.replies[].id` в ответе [`GET /v1/openline-configs/:lineId/quick-replies`](/docs/openlines/quick-replies/list) | ## Поля запроса (body) Тело передаётся плоско, без обёртки `fields`. | Поле | Тип | Обяз. | Описание | |------|-----|:-----:|----------| | `text` | string | да | Новый текст ответа целиком. Строка из одних пробелов не принимается | | `sectionId` | integer | нет | ID раздела этой же линии из `data.sections` ответа [`GET /v1/openline-configs/:lineId/quick-replies`](/docs/openlines/quick-replies/list). Без поля раздел ответа не меняется, `0` убирает ответ из раздела | ## Примеры ### curl — личный ключ ```bash curl -X PATCH "https://vibecode.bitrix24.tech/v1/openline-configs/3/quick-replies/7277" \ -H "X-Api-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Здравствуйте, оператор ответит в течение минуты", "sectionId": 123 }' ``` ### curl — OAuth-приложение ```bash curl -X PATCH "https://vibecode.bitrix24.tech/v1/openline-configs/3/quick-replies/7277" \ -H "X-Api-Key: YOUR_APP_KEY" \ -H "Authorization: Bearer USER_SESSION_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "text": "Здравствуйте, оператор ответит в течение минуты", "sectionId": 123 }' ``` ### JavaScript — личный ключ ```javascript const res = await fetch('https://vibecode.bitrix24.tech/v1/openline-configs/3/quick-replies/7277', { method: 'PATCH', headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ text: 'Здравствуйте, оператор ответит в течение минуты', sectionId: 123, }), }) const { data } = await res.json() console.log(data.name, data.sectionId) ``` ### JavaScript — OAuth-приложение ```javascript const res = await fetch('https://vibecode.bitrix24.tech/v1/openline-configs/3/quick-replies/7277', { method: 'PATCH', headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Authorization': 'Bearer USER_SESSION_TOKEN', 'Content-Type': 'application/json', }, body: JSON.stringify({ text: 'Здравствуйте, оператор ответит в течение минуты', sectionId: 123, }), }) const { data } = await res.json() console.log(data.name, data.sectionId) ``` ## Поля ответа | Поле | Тип | Описание | |------|-----|----------| | `success` | boolean | `true` при успехе | | `data` | object | Быстрый ответ после правки. Те же поля, что у записи `data.replies[]` в [списке быстрых ответов](/docs/openlines/quick-replies/list) | | `data.id` | integer | ID ответа, совпадает с `id` из пути | | `data.name` | string | Название ответа — первые 100 символов нового `text` | | `data.text` | string | Текст ответа после правки | | `data.sectionId` | integer | ID раздела после правки. `0` — ответ без раздела | | `data.canEdit` | boolean | Может ли пользователь ключа изменить ответ | | `data.rating` | number \| string | Рейтинг ответа | ## Пример ответа ```json { "success": true, "data": { "id": 7277, "name": "Здравствуйте, оператор ответит в течение минуты", "text": "Здравствуйте, оператор ответит в течение минуты", "sectionId": 123, "canEdit": true, "rating": 1 } } ``` ## Пример ответа при ошибке 404 — в линии из пути нет ответа с таким `id`: ```json { "success": false, "error": { "code": "ENTITY_NOT_FOUND", "message": "Quick reply not found in this line" } } ``` ## Ошибки | HTTP | Код | Описание | |------|-----|----------| | 400 | `MISSING_REQUIRED_FIELDS` | `text` не передан, пустой или состоит из пробелов | | 400 | `INVALID_PARAMS` | `lineId` или `id` не положительное целое число | | 400 | `INVALID_PARAMS` | `sectionId` не целое неотрицательное число | | 400 | `INVALID_PARAMS` | `sectionId` не `0`, не совпадает с текущим разделом ответа и его нет среди `data.sections` этой линии. Ответ не меняется | | 400 | `INVALID_PARAMS` | Тело запроса не JSON-объект | | 400 | `INVALID_JSON_BODY` | Тело запроса не разбирается как JSON | | 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` | | 401 | `TOKEN_MISSING` | У ключа нет действующей авторизации в Битрикс24 | | 403 | `SCOPE_DENIED` | У ключа нет скоупа `imopenlines` | | 403 | `WRITE_BLOCKED_READONLY_KEY` | Ключ в режиме «только чтение» | | 403 | `BITRIX_ACCESS_DENIED` | У пользователя ключа нет права просматривать быстрые ответы линии | | 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отказал пользователю ключа в доступе при сохранении | | 404 | `ENTITY_NOT_FOUND` | Сообщение `Quick reply not found in this line`: ответа с таким `id` нет в линии из пути, в том числе если он принадлежит другой линии | | 404 | `ENTITY_NOT_FOUND` | Сообщение `Record not found`: открытой линии с таким `lineId` нет | | 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку. Текст — в `message` | | 429 | `RATE_LIMITED` | Превышен собственный лимит метода. Общий потолок платформы — 120 запросов в минуту на портал, он делится между репликами платформы, поэтому код может прийти раньше 120-го запроса. Действующее значение — в заголовке `x-ratelimit-limit` | | 502 | `OPENLINE_OPERATOR_FAILED` | Битрикс24 вернул ответ неожиданной формы | | 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен | | 503 | `BITRIX_TIMEOUT` | Битрикс24 не ответил вовремя. Правка могла сохраниться: перед повтором проверьте [список ответов](/docs/openlines/quick-replies/list) | Полный список общих ошибок API — [Ошибки](/docs/errors). ## Смотрите также - [Список быстрых ответов](/docs/openlines/quick-replies/list) - [Создать быстрый ответ](/docs/openlines/quick-replies/create) - [Удалить быстрый ответ](/docs/openlines/quick-replies/delete) - [Быстрые ответы открытой линии](/docs/openlines/quick-replies) - [Список конфигураций открытых линий](/docs/openlines/config/list)