Статусы и их значение

Этот документ описывает все статусы в системе: статусы компании, чатов и сообщений.

​

Статусы компании

Компания всегда находится в одном из девяти статусов. Каждый статус определяет, что нужно сделать дальше.

​

NEW

Что это: Компания только что создана, нужна первоначальная настройка Когда наступает: Сразу после создания компании Что нужно сделать: Выбрать платформы для интеграции Переход: → WAITING_FOR_PROVIDER_SELECTION Длится: Несколько минут (пока пользователь выбирает платформы)

​

WAITING_FOR_PROVIDER_SELECTION

Что это: Нужно выбрать, какие платформы использовать (Avito обязателен, Cian и Domclick опционально) Что показывает пользователю: Переход: Зависит от выбора:

• Если выбран только Avito → WAITING_FOR_AVITO_FEED
• Если выбран Avito + Cian → WAITING_FOR_AVITO_FEED
• Если выбран Avito + Domclick → WAITING_FOR_AVITO_FEED
• Если выбраны все три → WAITING_FOR_AVITO_FEED

Длится: Зависит от пользователя (может быть минута или неделю)

​

WAITING_FOR_AVITO_FEED

Что это: Нужно указать URL XML фида со своими объявлениями на Avito Что показывает пользователю: Что происходит в системе:

• Система проверяет, доступен ли файл по URL
• Проверяет, что это валидный XML
• Сохраняет URL

Переход: → WAITING_FOR_AVITO_ACCESS Длится: Пока пользователь не введёт корректный URL

​

WAITING_FOR_AVITO_ACCESS

Что это: Нужна OAuth авторизация в Avito (как авторизация через Facebook) Что показывает пользователю: Что происходит:

1. Пользователь нажимает кнопку
2. Переходит на сайт Avito
3. Вводит логин/пароль
4. Нажимает “Разрешить доступ”
5. Avito отправляет код в Chat Bridge
6. Система получает токены

Переход: Зависит от выбранных платформ:

• Если выбран Cian → WAITING_FOR_CIAN_ACCESS
• Если выбран Domclick → WAITING_FOR_DOMCLICK_ACCESS
• Если только Avito → WAITING_FOR_FULL_SYNCHRONIZATION

Длится: Несколько минут (время авторизации)

​

WAITING_FOR_CIAN_ACCESS (если выбран Cian)

Что это: Нужно ввести API токен для Cian Что показывает: Что происходит:

• Система проверяет токен (делает тестовый запрос)
• Если работает → сохраняет

Переход: Зависит от выбранных платформ:

• Если выбран Domclick → WAITING_FOR_DOMCLICK_ACCESS
• Если только Avito + Cian → WAITING_FOR_FULL_SYNCHRONIZATION

Длится: Пока пользователь не введёт корректный токен

​

WAITING_FOR_DOMCLICK_ACCESS (если выбран Domclick)

Что это: Нужно ввести два API токена для Domclick (stats и chats) Что показывает: Что происходит:

• Система проверяет оба токена
• Если работают → сохраняет

Переход: → WAITING_FOR_FULL_SYNCHRONIZATION Длится: Пока пользователь не введёт корректные токены

​

WAITING_FOR_FULL_SYNCHRONIZATION

Что это: Система загружает все данные (объявления, чаты, сообщения) Что показывает пользователю: Что происходит в системе:

1. Загружаются объявления из XML (Avito)
2. Объявления привязываются к менеджерам
3. Загружаются чаты из всех платформ
4. Для каждого чата загружается история сообщений
5. Всё сохраняется в базе данных

Переход: → COMPLETED (если успешно) или остаётся в этом статусе (если ошибка) Длится: 10-60 минут (зависит от объёма данных) Если произошла ошибка:

• Компания остаётся в WAITING_FOR_FULL_SYNCHRONIZATION
• Пользователь может попросить повторную синхронизацию
• Система попытается ещё раз

​

COMPLETED

Что это: Компания готова к работе, все данные синхронизированы Что означает:

• ✅ Все объявления загружены
• ✅ Все чаты загружены
• ✅ Все сообщения загружены
• ✅ Токены работают и обновляются автоматически (для Avito)
• ✅ Менеджеры могут работать

Что показывает: Как остаться в этом статусе:

• Система автоматически обновляет токены (Avito)
• Система автоматически синхронизирует новые чаты и сообщения
• Пользователь может:
  • Добавлять новых менеджеров
  • Менять платформы
  • Запрашивать полную повторную синхронизацию

​

Диаграмма переходов статусов

​

Статусы сообщений

Каждое сообщение имеет свой статус доставки.

​

PENDING ⏳

Что это: Сообщение в процессе отправки Когда: Пользователь только что нажал “Отправить”

​

SENT ✓

Что это: Сообщение отправлено на платформу (Avito/Cian/Domclick) Когда: Система успешно передала сообщение платформе

​

DELIVERED ✓✓

Что это: Сообщение доставлено клиенту (клиент получил уведомление) Когда: Платформа подтвердила доставку Ограничение: Не все платформы поддерживают этот статус

​

READ ✓✓✓

Что это: Клиент прочитал сообщение Когда: Клиент открыл чат и прочитал сообщение Ограничение: Не все платформы поддерживают этот статус

​

Статусы чатов

​

АКТИВНЫЙ 🟢

Что это: Чат с активной перепиской Характеристики:

• Есть новые сообщения
• Может быть непрочитанные сообщения
• Менеджер должен ответить

​

НЕАКТИВНЫЙ ⚪

Что это: Чат без новых сообщений Характеристики:

• Давно нет переписки
• История сохранена
• Может быть заархивирован

​

АРХИВНЫЙ 🔒

Что это: Чат закрыт, но информация сохранена Характеристики:

• История доступна
• Не показывается в основной ленте
• Можно восстановить

​

Примеры жизненного цикла компании

​

Пример 1: Быстрая настройка (1 день)

Сценарий настройки компании и первой синхронизации 10:00 Иван создаёт компанию «Иванов и партнёры». Система инициализирует компанию в статусе: NEW → WAITING_FOR_PROVIDER_SELECTION. 10:05 Иван выбирает платформы для интеграции: Avito и Cian. Статус компании меняется на: WAITING_FOR_AVITO_FEED. 10:10 Иван вводит URL XML-фида Avito. Система выполняет проверку доступности и структуры фида — успешно. Статус: WAITING_FOR_AVITO_ACCESS. 10:15 Иван проходит авторизацию в Avito через OAuth. Avito возвращает access-токены. Статус компании обновляется на: WAITING_FOR_CIAN_ACCESS. 10:20 Иван вводит API-токен Cian. Система проверяет токен — успешно. Статус компании: WAITING_FOR_FULL_SYNCHRONIZATION. 10:25 – 10:45 Выполняется полная синхронизация данных: загружено 50 объявлений, загружено 120 чатов, загружено 450 сообщений. По завершении статус компании устанавливается в: COMPLETED. 10:45 Компания полностью готова к работе. Иван создаёт пригласительные ссылки и приглашает 3 менеджеров. Менеджеры регистрируются в системе и начинают работу с чатами и объявлениями.

​

Пример 2: Длительная настройка (1 неделя)

Сценарий настройки с паузами со стороны пользователя Понедельник, 10:00 Иван создаёт компанию в системе. Компания инициализируется в статусе: NEW. Понедельник, 10:05 Иван выбирает платформы для интеграции. Статус компании обновляется на: WAITING_FOR_PROVIDER_SELECTION. Вторник, 14:00 Иван вводит URL XML-фида Avito. Задержка связана с занятостью пользователя. Статус компании: WAITING_FOR_AVITO_ACCESS. Среда, 09:00 Иван проходит авторизацию в Avito. Система получает необходимые токены доступа. Статус компании меняется на: WAITING_FOR_CIAN_ACCESS. Четверг, 11:00 Иван вводит API-токен Cian. Токен успешно проверяется системой. Статус компании: WAITING_FOR_FULL_SYNCHRONIZATION. Четверг, 11:30 Выполняется полная синхронизация данных. Система завершает загрузку объявлений, чатов и сообщений. Финальный статус компании: COMPLETED. Пятница, 10:00 Все менеджеры добавлены в компанию. Пользователи работают с объявлениями и чатами в штатном режиме.