SetStage

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

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

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

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

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

• Перемещение по стадиям доступно только если у лида назначен ответственный .
• Если ответственный не назначен, метод возвращает ошибку.

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

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

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

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

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

Успешная терминальная стадия для лида доступна только через lead/convert, так как конвертация создает связанную сделку. При попытке перейти в успешную терминальную стадию через setstage метод возвращает ошибку use_lead_convert_for_success_stage.

Лид в статусе Converted нельзя переоткрыть через setstage; метод возвращает ошибку converted_lead_reopen_not_allowed.

Метод всегда отправляет webhook LeadStageSet. При переходе в терминальную неуспешную стадию дополнительно отправляется LeadClosed.

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

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