SetStage

[POST] .../v1/lead/setstage

Изменяет стадию CRM-обращения.

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

Название	Тип данных	Обязательность	Описание
id	Int64	Обязательный	ID обращения
stage_id	Int64	Обязательный	ID новой стадии
comment	String	Необязательный	Комментарий к смене стадии

stage_id должен принадлежать той же воронке, что и обращение.

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

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

{
  "id": 105,
  "stage_id": 26,
  "comment": "Связались с клиентом"
}

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

Название	Тип данных	Описание
result.row_affected	Int64	Количество измененных строк
result.ids	Array of Int64	ID измененных записей

При смене стадии статус определяется так:

переход в терминальную успешную стадию (is_terminal = true, is_success = true, например won) -> status = Converted;
переход в терминальную неуспешную стадию (is_terminal = true, is_success = false, например lost) -> status = Closed;
переход с терминальной стадии на не терминальную -> status = New;
переход между не терминальными стадиями сохраняет текущий рабочий статус (New/InProgress/WaitingClient).

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

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": [105]
  }
}