Avito

Приложение Avito подключает профессиональный аккаунт к рабочему пространству Promto. Агент может анализировать объявления и статистику, читать кошелёк и расходы, разбирать сообщения и отзывы, а после подтверждения — менять цену, отправлять сообщения и публиковать ответы на отзывы.

Подключение

1. Откройте раздел Avito для профессионалов → API.
2. В основном аккаунте компании перейдите в Профиль → Настройки → Avito API.
3. Создайте приложение и скопируйте Client ID и Client Secret.
4. В Promto откройте Avito, нажмите Подключить и вставьте оба значения.
5. Дождитесь проверки профиля через API.

Promto получает служебный access token по схеме client_credentials и обновляет его на сервере. Такой токен живёт около 24 часов; повторно вводить секрет каждый день не нужно.

Доступность отдельных методов зависит от тарифа Avito и типа аккаунта. API сообщений работает только для основного аккаунта компании; для товаров и вакансий нужен тариф «Максимальный», для услуг — «Расширенный».

Интерфейс приложения

На главном экране доступны сценарии:

Сценарий	Что делает
Объявления	Показывает активные объявления и их состояние
Статистика	Сравнивает уникальные просмотры, контакты и добавления в избранное
Кошелёк	Сверяет баланс, операции и расходы
Сообщения	Находит непрочитанные чаты и готовит ответы
Отзывы	Показывает рейтинг и готовит проекты публичных ответов

В Настройках видны имя и ID аккаунта, маска Client ID, состояние подключения и действие отключения.

Работа с агентом

Основной агент использует инструмент promto_avito. Это встроенный инструмент чата, а не терминальная команда.

Область	Действия инструмента
Профиль и финансы	get_self, get_balance, list_operations, get_spendings
Объявления	list_items, get_item, update_item_price, get_item_stats
Сообщения	list_chats, get_chat, list_messages, send_message, mark_chat_read
Отзывы	get_ratings_info, list_reviews, answer_review, delete_review_answer
Дополнительный метод API	request

Первым вызовом делайте get_self: он возвращает фактический ID аккаунта, который нужен следующим методам.

Для статистики используйте актуальные поля uniqViews, uniqContacts, uniqFavorites. Старые views, contacts и favorites не следует смешивать с ними в одном сравнении.

Практические сценарии

Найти неэффективные объявления

Агент соберёт список и уникальную статистику за одинаковые периоды, затем выделит объявления с просмотрами без контактов или с расходами без результата.

Разобрать входящие

Агент найдёт непрочитанные чаты, покажет контекст и подготовит черновики. send_message вызывается только после утверждения точного текста и получателя.

Ответить на отзывы

Сначала агент получает рейтинг и список отзывов, затем предлагает варианты ответа. Публикация видна всем пользователям Avito и требует отдельного согласия.

Обновить цену

Агент читает объявление, показывает текущую и новую цену, просит подтверждение и только затем вызывает update_item_price.

Ограничения и безопасность

• update_item_price, send_message, answer_review и delete_review_answer требуют params.confirm=true после явного согласия.
• Удалённый ответ на отзыв нельзя восстановить через интеграцию.
• Статистика должна сравниваться по одинаковым диапазонам и актуальным uniq*-полям.
• Ошибка avito_messenger_forbidden обычно означает неподходящий тариф или неосновной аккаунт компании, а не неверный секрет.
• Не передавайте Client Secret в чат, файлы проекта или параметры универсального запроса.
• Перед отправкой сообщения проверяйте чат, объявление, адресата и финальный текст.

Если не работает

Симптом	Что проверить
Авторизация не проходит	Client ID, Client Secret и состояние приложения в кабинете Avito
avito_messenger_forbidden	Тариф, категорию и то, что подключён основной аккаунт компании
Статистика пустая или странная	Период, ID объявления и поля uniqViews, uniqContacts, uniqFavorites
Неверный аккаунт в запросе	Повторить get_self и использовать возвращённый ID
Действие отклонено	Проверить явное подтверждение и повторить с неизменными параметрами

Связанные материалы

• Настройки рабочего пространства
• Telegram — если обращения дополнительно ведутся в Telegram
• Как получать лучший результат

Готовый промпт

Через promto_avito сначала вызови get_self, затем найди непрочитанные чаты и покажи контекст последних сообщений. Подготовь черновики ответов, но ничего не отправляй и не отмечай прочитанным. Используй фактический ID аккаунта из get_self.