Обзор проекта Chat Bridge

​

Введение

Chat Bridge — это система управления объявлениями и чатами для агентств недвижимости. Она объединяет данные со всех основных платформ (Avito, Cian, Domclick) в одном месте, позволяя менеджерам эффективно работать с клиентами.

​

Основная идея

​

Проблема

Риэлтор размещает объявления о своих объектах на нескольких платформах одновременно:

• Объявление №1 на Avito
• Объявление №2 на Cian
• Объявление №3 на Domclick

Потенциальные клиенты пишут в чаты в каждом из сервисов. Менеджер должен:

• Открыть Avito, посмотреть чаты
• Открыть Cian, посмотреть чаты
• Открыть Domclick, посмотреть чаты
• Ответить в каждом месте отдельно

Проблемы:

• Менеджер может забыть проверить одну из платформ
• Невозможно видеть ВСЕ чаты разом
• Нельзя быстро найти нужный чат
• Нельзя фильтровать по статусу (прочитано/не прочитано)

​

Решение

Chat Bridge объединяет ВСЕ данные в одной системе: Теперь менеджер:

• Видит все чаты с ВСЕ платформ в одном месте
• Может фильтровать по статусу, платформе, дате
• Может искать нужный чат по тексту
• Может ответить клиенту прямо в Chat Bridge (чат синхронизируется обратно на платформу)

​

Целевая аудитория

​

Основные пользователи

1. Агентства недвижимости
   • Работают на нескольких платформах одновременно
   • Имеют несколько менеджеров
   • Имеют сотни или тысячи объявлений
   • Нужна центральная система управления
2. Индивидуальные риэлторы
   • Сдают в аренду несколько объектов
   • Размещают объявления на разных платформах
   • Хотят видеть все чаты в одной системе
3. Call-центры и аутсорсинг компании
   • Помогают риэлторам отвечать на звонки и чаты
   • Нужна централизованная система для управления несколькими аккаунтами клиентов

​

Поддерживаемые платформы

Chat Bridge интегрируется с тремя основными платформами для поиска и продажи недвижимости:

​

🔴 Avito

Самый крупный портал недвижимости в России

• Как подключается: OAuth авторизация (как в соцсети)
• Что синхронизируется:
  • Все объявления риэлтора (из XML фида)
  • Все чаты клиентов
  • История сообщений
• Особенность: Обновление токена автоматическое (система сама обновляет доступ ежечасно)

​

🔵 Cian

Популярный портал покупки и сдачи недвижимости

• Как подключается: API токен (специальный ключ доступа)
• Что синхронизируется:
  • Все чаты клиентов
  • История сообщений
• Особенность: Токен нужно обновлять вручную в системе

​

🟢 Domclick

Платформа Яндекса для поиска недвижимости

• Как подключается: Два отдельных API токена (для статистики и для чатов)
• Что синхронизируется:
  • Все чаты клиентов
  • История сообщений
• Особенность: Требует ID компании в системе Domclick

​

Основные возможности

​

1. Управление объявлениями

• Просмотр всех объявлений из всех платформ в одном месте
• Фильтрация по платформе, дате, статусу
• Поиск по адресу, цене, описанию
• Привязка объявлений к менеджерам (автоматическая по номеру телефона)

​

2. Единая лента чатов

• Все чаты со всех платформ в одном месте
• Фильтрация по:
  • Платформе (Avito/Cian/Domclick)
  • Статусу (прочитано/не прочитано)
  • Направлению (входящие/исходящие)
  • Типу объявления
• Поиск по имени клиента или тексту сообщения

​

3. История переписки

• Полная история всех сообщений с клиентом
• Отметки о прочтении
• Информация о дате и времени сообщения
• Различные типы сообщений (текст, фото, файлы, ссылки)

​

4. Управление командой

• Несколько пользователей в одной компании
• Разные роли с разными правами:
  • MAINTAINER — владелец, может всё
  • RESPONSIBLE — может управлять интеграциями
  • MANAGER — может работать с чатами
• Пригласительные ссылки для добавления сотрудников

​

5. Управление интеграциями

• Подключение/отключение платформ
• Обновление токенов и ключей доступа
• Просмотр статуса синхронизации
• Переподключение при ошибках

​

Технические характеристики

​

Архитектура

• Тип: REST API
• Аутентификация: Laravel Sanctum (токены доступа)
• Верификация: SMS коды для новых пользователей
• Шифрование: Все секретные ключи зашифрованы в базе

​

Интеграции

• Avito API — OAuth и REST API
• Cian API — REST API с токеном
• Domclick API — REST API с двумя токенами
• SMS провайдеры — интеграция для верификации (GreenSMS, Local)

​

Синхронизация данных

• Частота: Автоматическая в фоновом режиме (используются очереди задач)
• Объявления: Синхронизируются из XML фида Avito 1 раз при подключении
• Чаты: Синхронизируются из всех платформ в фоновом режиме
• Сообщения: Загружаются из истории каждого чата

​

Как система работает (краткое описание)

​

Шаг 1: Регистрация риэлтора

1. Риэлтор заходит в систему по номеру телефона
2. Вводит SMS код (верификация)
3. Получает доступ к API

​

Шаг 2: Создание компании

1. Риэлтор создаёт компанию (вводит своё имя)
2. Выбирает платформы для подключения (Avito, Cian, Domclick)
3. Заполняет юридические реквизиты (опционально)

​

Шаг 3: Подключение платформ

Для Avito:

1. Риэлтор нажимает “Подключить Avito”
2. Переводится на страницу авторизации Avito
3. После авторизации система получает токены
4. Риэлтор вводит URL XML фида со своими объявлениями
5. Система загружает объявления

Для Cian и Domclick:

1. Риэлтор получает токены в личном кабинете платформы
2. Вводит токены в Chat Bridge
3. Система проверяет корректность токенов

​

Шаг 4: Синхронизация

1. Система автоматически загружает все объявления и чаты
2. Привязывает объявления к менеджерам по номеру телефона
3. Все данные готовы для работы

​

Шаг 5: Работа менеджера

1. Менеджер открывает Chat Bridge
2. Видит все чаты со всех платформ
3. Может фильтровать, искать, отвечать
4. Ответы синхронизируются обратно на платформы

​

Основные компоненты системы

​

1. API (Application Programming Interface)

Набор команд, которые могут выполнять внешние системы:

• Запросы: “Дай мне список всех чатов”, “Создай новую компанию”
• Ответы: Система отправляет запрашиваемые данные

​

2. База данных

Хранилище всех данных:

• Информация о пользователях
• Информация о компаниях
• Все объявления
• Все чаты и сообщения
• Токены доступа к платформам

​

3. Интеграция с платформами

Два направления синхронизации:

• Получение данных: Chat Bridge запрашивает данные у Avito/Cian/Domclick
• Отправка данных: Chat Bridge отправляет ответы от менеджера обратно на платформы

​

4. Фоновые задачи (Queue)

Автоматические процессы, которые работают в фоне:

• Регулярное обновление Avito токенов
• Периодическая синхронизация объявлений
• Загрузка новых чатов и сообщений

​

Данные в системе

​

Основные сущности

Пользователь

• ФИО, номер телефона
• История логинов
• Роли в разных компаниях

Компания

• Название, юридические реквизиты
• Список пользователей с ролями
• Подключённые платформы (Avito, Cian, Domclick)

Объявление

• Адрес объекта
• Описание, цены, фото
• Номер телефона менеджера
• ID в каждой платформе

Чат

• Имя клиента
• История сообщений
• Дата последнего сообщения
• Статус прочтения

Сообщение

• Текст сообщения
• Дата отправки
• Направление (входящее/исходящее)
• Статус доставки

​

Жизненный цикл объявления

​

Безопасность

​

Верификация пользователей

• Все новые пользователи подтверждают номер телефона SMS кодом
• Каждый пользователь получает уникальный API токен

​

Доступ к данным

• Пользователь может видеть только данные компаний, в которых он состоит
• Роли определяют, какие действия может выполнять пользователь
• Всё зависит от компании: менеджер одной компании не видит данные другой

​

Защита токенов

• Все токены платформ (Avito, Cian, Domclick) зашифрованы в базе
• Никто из сотрудников системы не может увидеть реальные токены
• Токены обновляются автоматически и безопасно

​

Логирование

• Все действия записываются для аудита
• Если что-то пошло не так, можно посмотреть историю

​

Примеры использования

​

Пример 1: Риэлтор с несколькими объектами

Ситуация: Марина сдаёт в аренду 5 квартир. Каждую разместила на Avito и Cian. Без Chat Bridge: Отслеживает 10 объявлений и получает чаты в 2 приложениях (Avito и Cian). Потеряла одно сообщение в Cian, клиент уехал. С Chat Bridge:

• Все объявления и чаты видны в одном месте
• Сразу видит непрочитанные чаты
• Не потеряет ни один запрос

​

Пример 2: Агентство с менеджерами

Ситуация: Агентство “Квартира” имеет 50 объявлений на 3 платформах и 5 менеджеров. Без Chat Bridge:

• Начальник не может контролировать, кто что делает
• Менеджеры дублируют работу или, наоборот, упускают чаты
• Никто не знает, на сколько запросов осталось ответить

С Chat Bridge:

• Начальник видит все чаты и статистику
• Каждый менеджер видит только свои объявления и чаты
• Система автоматически привязывает новые запросы к нужному менеджеру

​

Пример 3: Call-центр

Ситуация: Call-центр “Быстрые ответы” обслуживает 20 агентств. Без Chat Bridge:

• Оператор должен логиниться в 20 разных аккаунтов на Avito/Cian/Domclick
• Это невозможно

С Chat Bridge:

• Оператор логинится один раз
• Видит все чаты всех клиентов в одной системе
• Может переключаться между разными агентствами

​

Статистика и метрики

Система собирает информацию о:

• Количество объявлений
• Количество чатов и сообщений
• Количество менеджеров в компании
• Время отклика на сообщения
• Активность по платформам

Эта информация помогает риэлторам понять, где больше клиентов, какой менеджер работает быстрее и т.д.

​

Интеграция с другими системами

Хотя Chat Bridge разработан специально для работы с Avito, Cian и Domclick, архитектура позволяет легко добавлять новые платформы. В будущем можно добавить:

• Яндекс.Карты
• Циан.Карты
• Другие региональные порталы
• WhatsApp, Telegram (если пользователи захотят)

​

Развитие проекта

​

Текущая версия

• Работает с Avito, Cian, Domclick
• Синхронизация объявлений и чатов
• Управление командой через роли
• API для программистов

​

Возможные улучшения

• Аналитика (графики, статистика)
• Автоответы на популярные вопросы
• CRM функции (привязка контактов к клиентам)
• Интеграция с рассылками (SMS, Email)
• Мобильное приложение
• Интеграция с другими сервисами (система управления объявлениями, бухгалтерия)

​

Заключение

Chat Bridge — это система, которая экономит время риэлторов и агентств, позволяя управлять объявлениями и общаться с клиентами из одного места вместо того, чтобы прыгать между несколькими приложениями. Для project manager: это быстрорастущий продукт с четкой ценностью для клиентов. Основной фокус — стабильность синхронизации и удобство интерфейса. Для бизнес-аналитика: система строится на модели “агентство” как основная единица. Каждое агентство может иметь несколько менеджеров, несколько платформ и тысячи объявлений.