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

​

Общие принципы интеграций

​

Что такое интеграция

​

Токены доступа

​

Где хранятся токены

• Даже администраторы системы не могут увидеть реальный токен
• Токены используются только для запросов к платформам
• Если кто-то украдёт базу данных, токены всё равно будут зашифрованы

​

1. Avito

​

Обзор интеграции

• Объявления (из XML фида)
• Чаты (список, история)
• Сообщения (текст, фото, файлы)

• Объявления: один раз при первой настройке, потом по запросу
• Чаты: каждые 15-30 минут автоматически
• Сообщения: каждые 15-30 минут для каждого чата

​

Что нужно для подключения

​

1. OAuth авторизация

1. Риэлтор нажимает “Подключить Avito”
2. Переводится на сайт Avito
3. Вводит логин и пароль от своего аккаунта на Avito
4. Avito спрашивает: “Разрешить Chat Bridge доступ к вашему аккаунту?”
5. Риэлтор нажимает “Разрешить”
6. Avito отправляет Chat Bridge access_token и refresh_token

• access_token — используется для запросов к API Avito (действует ~1 год)
• refresh_token — используется для обновления access_token (действует ~2 года)

​

2. XML фид со своими объявлениями

<?xml version="1.0" encoding="UTF-8"?>
<ads>
  <ad>
    <feed_id>123</feed_id>
    <address>г. Москва, ул. Пушкина, 10, кв. 5</address>
    <price>50000</price>
    <square>65.5</square>
    <rooms>2</rooms>
    <phone>+7 999 111-22-33</phone>
    ...
  </ad>
  ...
</ads>

• Если нет сайта: Avito сам может сгенерировать фид
• Если есть свой сайт: нужно самому подготовить XML с объявлениями

​

Пошаговое подключение Avito

​

Шаг 1: Выбор платформ

​

Шаг 2: Ввод XML фида

​

Шаг 3: OAuth авторизация

​

Автоматическое обновление токенов

• Токен помечается как “недоступный”
• Система уведомляет владельца: “Нужно переавторизироваться в Avito”
• Риэлтор повторяет Шаг 3 (OAuth авторизация)

​

Процесс синхронизации объявлений

​

Процесс синхронизации чатов

​

Проблемы и их решение

​

2. Cian

​

Обзор интеграции

• Чаты (список, история)
• Сообщения (текст, фото, файлы)

• Чаты: каждые 15-30 минут автоматически

​

Что нужно для подключения

​

1. API токен (client_secret)

1. Риэлтор логинится на сайт Cian
2. Переходит в “Личный кабинет” → “Интеграции” → “API”
3. Нажимает “Создать новый токен”
4. Копирует токен (выглядит примерно как: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6)
5. Никому не показывает (это как пароль)

​

Пошаговое подключение Cian

​

Шаг 1: Получение токена

​

Шаг 2: Ввод токена в Chat Bridge

​

Шаг 3: Валидация токена

​

Синхронизация чатов из Cian

​

Обновление токена Cian

• Токен истёк (если установлена дата истечения)
• Токен потерял силу (Cian их может отзывать)
• Риэлтор решил изменить токен

1. Риэлтор генерирует новый токен на сайте Cian (или берёт существующий)
2. Вводит новый токен в Chat Bridge
3. Система проверяет новый токен
4. Если верный → заменяет старый на новый

​

3. Domclick

​

Обзор интеграции

• Чаты (список, история)
• Сообщения (текст, фото, файлы)

• Чаты: каждые 15-30 минут автоматически

​

Что нужно для подключения

​

1. ID компании в Domclick

1. Риэлтор логинится на Domclick.ru
2. Переходит в “Мои компании”
3. Выбирает нужную компанию
4. В URL видит ID (примерно: /company/12345)
5. ID = 12345

​

2. Два API токена

• stats_secret — для доступа к статистике
• chats_secret — для доступа к чатам

1. Риэлтор логинится на Domclick.ru
2. Переходит в “Интеграции” → “API”
3. Генерирует оба токена
4. Копирует их куда-нибудь в безопасное место

• stats_secret — для получения аналитики (каких клиентов сколько кликнули)
• chats_secret — для получения чатов и сообщений
• Это сделано для безопасности (если украдут один, другой всё ещё работает)

​

Пошаговое подключение Domclick

​

Шаг 1: Подготовка в личном кабинете Domclick

​

Шаг 2: Ввод данных в Chat Bridge

​

Шаг 3: Валидация обоих токенов

​

Синхронизация чатов из Domclick

​

Сравнение платформ

​

Общие проблемы и решения

​

Проблема 1: Токен не работает

• Чаты не обновляются
• В логах ошибка: “401 Unauthorized”
• Компания в статусе “WAITING_FOR_SYNCHRONIZATION”

• Токен истёк
• Токен был отозван на сайте платформы
• Токен был скопирован неправильно

1. Зайти на сайт платформы (Avito/Cian/Domclick)
2. Проверить, виден ли токен
3. Если уже не видно → генерировать новый
4. Обновить токен в Chat Bridge

​

Проблема 2: OAuth авторизация не работает (Avito)

• Белый экран
• Ошибка “Страница не найдена”
• Редирект не работает

1. Проверить интернет-соединение
2. Попробовать другой браузер
3. Очистить кеш браузера
4. Попробовать приватное окно (Incognito mode)
5. Обратиться в поддержку

​

Проблема 3: Объявления не синхронизируются (Avito)

• XML фид имеет неправильный формат
• URL фида недоступен
• Номера телефонов в XML неправильные
• Менеджер ещё не добавлен в компанию

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

​

Проблема 4: Платформа перестала отправлять чаты

• Токен истёк или был отозван
• Компания/объявления удалены на платформе
• Произошла ошибка на сервере платформы

1. Проверить, работает ли токен (попробовать логиниться в аккаунт платформы)
2. Обновить токен
3. Поставить на очередь полную повторную синхронизацию
4. Проверить, не удалены ли объявления на платформе

​

Статус синхронизации

• Токены работают
• Данные обновляются автоматически
• Всё в порядке

• Подключение в процессе
• Ждёт ввода токена или фида
• Ничего не синхронизируется

• Произошла ошибка
• Токен не работает
• Нужно вмешательство пользователя

• Платформа отключена пользователем
• Данные не синхронизируются
• Можно включить обратно в любое время