Avito: подключение и работа

Avito — ключевая площадка: OAuth2-авторизация, опрос чатов, детект брони по фразе «У вас новая бронь», оплаты и залоги SafeDeposit, отправка текста и фото.

1. Подключение (client_id + client_secret)

2. Синхронизация чатов и истории

• Фоновый опрос StartAvitoPolling: активные чаты + история за avito_history_days (по умолчанию 7).
• Ручной запуск: POST /api/avito/sync-chats (все чаты) и POST /api/avito/sync-history (N дней) — оба возвращают 202 и работают в фоне.
• Глубина общая: channel_history_days + sync_days объекта. Старые чаты пропускаются.
• Каждая новая бронь определяется по системному уведомлению «У вас новая бронь» + разбору дат/сумм из сообщений.

3. Оплаты и залог SafeDeposit

• Поля avito_payment_info (сырой JSON), total_amount (залог), base_price (стоимость).
• Статусы маппятся в payment_status. После вашего ручного paid/fully_paid автоматика не перезаписывает.
• Проверить можно в панели «💳 Оплаты» и в GET /api/v1/bookings/{id}/view.

4. Отправка сообщений и фото

• Текст: POST /api/booking/{id}/send или /api/v1/bookings/{id}/messages (platform опционально, по умолчанию первый чат).
• Фото: POST /api/avito/send-image (multipart: chat_id + photo). Avito принимает только изображения — PDF/документы не уйдут.
• В ленте отправленные фото видны как [Фото: Attachment/…].

5. Ручная привязка непривязанных чатов

• GET /api/avito/unlinked-chats — непривязанные с маркером брони за 30 дней (chat_id, время, имя).
• GET /api/avito/all-chats-with-notifications — все с маркером, включая привязанные.
• GET /api/avito/unlinked-chats-for-booking — кандидаты под конкретную бронь; unlinked-bookings-with-chats — брони без чата + кандидаты по окну времени.
• POST /api/avito/link-chat-manual {chat_id, booking_id} — привязать.
• GET /api/avito/search-unlinked-chats и debug-chat-search — полный обход и диагностика (имена контактов сохраняются).