Интеграция Авито — API, лиды в CRM, автоответы

Триггеры и действия Авито

Как настроить Авито API технически

1. Аутентификация: Используется протокол OAuth 2.0 (метод client_credentials). Ключи client_id и client_secret генерируются в личном кабинете «Авито для бизнеса» в разделе «Интеграции». Токен получается через POST /token, время жизни токена — 3600 секунд.
2. Базовые эндпоинты: Вся работа ведется через API v1, основной хост: api.avito.ru. Документация доступна по адресу developers.avito.ru, где описаны схемы запросов для Core, Messenger и Statistics API.
3. Обработка ошибок: Реализуйте логику обработки HTTP-кодов: 401 (рефреш токена), 403 (недостаточно прав для метода), 429 (превышение лимитов — необходим экспоненциальный бэкофф).
4. Лимиты и квоты: Базовый лимит — 5000 запросов в сутки. Для высоконагруженных систем лимиты рассчитываются индивидуально по Rate-Limit заголовкам (обычно до 10-20 req/sec в зависимости от метода).
5. Мониторинг и Retry-логика: При получении 5xx ошибок необходимо реализовать повторные запросы с задержкой (Retry-after). Для критических операций обязательно логирование request_id в ответах Авито для отладки через техподдержку.
6. Интеграционный слой: Для синхронизации с базой данных (PostgreSQL/MySQL) рекомендуется использовать брокер сообщений (Redis, RabbitMQ), чтобы не блокировать основной поток при ответе на вебхуки.

Часто задаваемые вопросы о Авито

Какие типы событий поддерживает API?

API поддерживает события через Webhooks: изменения статусов объявлений, входящие сообщения в чатах и события звонков (Call Tracking). Полный список доступен в разделе «Webhooks» документации разработчика.

Есть ли песочница для тестов?

Отдельной изолированной среды (песочницы) нет. Все тесты проводятся на реальном аккаунте, поэтому рекомендуется использовать отдельный «тестовый» аккаунт Авито для разработки.

Как получить API-ключ?

Ключи выдаются только для бизнес-аккаунтов. Необходимо зайти в настройки профиля, перейти в раздел «Интеграции» и нажать кнопку «Получить ключи» (доступно при наличии активного тарифа «Расширенный» или «Максимальный»).

Что делать при ошибке 429?

Ошибка означает превышение лимита запросов. Необходимо реализовать паузу перед повторным запросом (минимум 1-2 секунды) и внедрить очередь с задержкой обработки.

Поддерживает ли Авито асинхронные вебхуки?

Да, все события передаются асинхронно методом POST на ваш URL. Сервер обязан ответить 200 OK в течение 5 секунд, иначе Авито пометит доставку как неудачную.

Совместим ли API с коробкой vs SaaS?

API является RESTful и не имеет привязки к типу системы. Оно одинаково эффективно работает как с облачными (SaaS) решениями, так и с локальными (on-premise) CRM. Настроить интеграцию Авито под ключ с гарантией — flowframe.ru, от 40 000 ₽, срок 7-21 день.