PATCH
PATCH /settings/ai
https://app.otvech.ai/api/v1/settings/aiЧастичное обновление настроек автоответов. В теле обязательно укажите type: feedback (настройки по отзывам) или question (по вопросам). Обновляются только те поля, которые вы передали; остальные не трогаются.
Обязательные поля в body:
| Поле | Тип | Описание |
|---|---|---|
| type | string | feedback — настройки отзывов; question — настройки вопросов. |
Опциональные поля (для feedback и question):
| Поле | Тип | Для кого | Допустимые значения / формат | Что делает |
|---|---|---|---|---|
| rating | int | только feedback | 1, 2, 3, 4 или 5 | Обновить настройки только для этой оценки. Если не передавать — обновляются все пять оценок разом. |
| reply_mode | string | оба | disabled, auto, semi_auto | disabled — автоответ выключен; auto — ИИ сам генерирует и отправляет ответ; semi_auto — ИИ генерирует, отправку делает пользователь. |
| signature | string | оба | произвольная строка | Текст в конце каждого сгенерированного ответа (подпись). |
| tone | string | оба | произвольная строка | Тональность ответа (например friendly, professional). По умолчанию в системе — friendly. |
| excluded_words | string | оба | слова через запятую или перенос строки | Стоп-слова: ИИ не будет использовать эти слова/фразы в тексте ответа. |
| required_words | string | оба | слова через запятую или перенос строки | Обязательные слова: должны присутствовать в ответе. |
| reply_from_date | string | оба | YYYY-MM-DD или пустая строка | Отвечать только на отзывы/вопросы с этой даты и новее. Пустая строка — сброс ограничения. |
| ai_instructions | string | оба | произвольный текст | Дополнительные пожелания для ИИ (приоритетные правила). |
Только для type=feedback:
| Поле | Тип | Допустимые значения | Что делает |
|---|---|---|---|
| empty_review_mode | string | skip, template, generate | Как обрабатывать отзывы без текста (только оценка): skip — не отвечать; template — использовать шаблон; generate — генерировать ответ ИИ по оценке. |
Примеры запросов:
Обновить только режим и тон для отзывов с оценкой 5:
{ "type": "feedback", "rating": 5, "reply_mode": "auto", "tone": "friendly" }Включить автоответ на вопросы и задать подпись:
{ "type": "question", "reply_mode": "auto", "signature": "С уважением, поддержка" }Обновить стоп-слова для всех оценок отзывов (rating не передаём):
{ "type": "feedback", "excluded_words": "гарантия, бесплатно" }Сбросить дату «с какой отвечать»:
{ "type": "feedback", "reply_from_date": "" }При успехе вернётся ответ 200 с полем message: "Settings updated". Ошибка 400: неверный JSON; type не feedback/question; rating не от 1 до 5 (для feedback); либо не передано ни одного поля для обновления (кроме type).
Пример ответа
{
"success": true,
"data": {
"message": "Settings updated"
}
}