Тема
Статусы
Полный список кодов, их smysl и в какие переходы можно ожидать callback.
Read API (опционально)
Если вам нужен текущий справочник статусов программно (например, для UI на вашей стороне), он доступен в боевом приложении через GET /api/statuses (требует Sanctum-сессии — не inbound). Для статической ссылки используйте таблицу ниже.
Scope
Все статусы делятся на три scope:
lead— применимы только к лиду (до FTD).client— применимы только к клиенту (после FTD).both— применимы и там, и там.
Terminal-флаг
is_terminal: true означает: лид уже не вернётся в работу. Например, trash или chargeback — после них статус не меняется (но можно вручную «реанимировать» в CRM).
Дефолтная таблица
| Code | Scope | Terminal | Описание |
|---|---|---|---|
new | both | no | Только что принят inbound API'ем. |
assigned | both | no | Закреплён за агентом (auto или manual). |
contacted | both | no | Агент совершил первый контакт. |
callback | both | no | Лид попросил позвонить позже. |
interested | both | no | Заинтересован, не задепал. |
no_answer | lead | yes | После N попыток дозвона. |
wrong_number | lead | yes | Не его номер. |
not_interested | lead | yes | Прямой отказ. |
trash | lead | yes | Мусор / троллинг. |
do_not_call | lead | yes | Просьба не звонить (compliance). |
ftd | client | no | First Time Deposit — лид стал клиентом. |
rtd | client | no | Repeat Time Deposit — повторный депозит. |
chargeback | client | yes | Депозит возвращён (chargeback). |
vip | client | no | Активный высокобюджетный клиент. |
dormant | client | no | Был активен, давно молчит. |
Кастомные статусы
Команда CRM может создать любые свои статусы (/settings → Статусы) с цветом и сортировкой. В callback'е они придут как есть в поле our_status. Если у вас в status_mapping для них есть запись — status придёт перемапленный.
Переходы и callback'и
В callback'ах партнёр получает события смены статуса. Возможные события:
| Event | Когда отправляется |
|---|---|
lead.accepted | Сразу после успешного inbound'а. |
lead.rejected | Если лид отклонён бизнес-правилами. |
lead.status_changed | Любая смена статуса (кроме переходов на ftd / rtd). |
lead.ftd | Зафиксирован FTD — лид стал клиентом. |
lead.rtd | Повторный депозит. |
Если на стороне партнёра указан callback_events whitelist — мы будем слать только события из списка. Пустой whitelist = «все события».