Коротко: чтобы подключить API Авито, нужно иметь профессиональный профиль с подключённым магазином, подходящий тариф площадки, а затем в кабинете создать пару ключей (идентификатор клиента и секрет) и передать их своему сервису или разработчику. Дальше сервис сам получает временный токен доступа и начинает работать от вашего имени в тех границах, которые вы разрешили.
Важная оговорка, с которой стоит начать: Авито регулярно меняет условия доступа — названия тарифов, состав методов, лимиты запросов и порядок подачи заявки. Поэтому ниже разобрана общая логика, которая держится годами, а конкретные цифры и названия проверяйте в актуальной документации Авито и в своём кабинете. Не верьте ни одной статье в интернете, которая называет точный лимит запросов в минуту — включая эту.
Что API вообще даёт
API — это программный доступ к вашему аккаунту: не человек кликает мышкой, а сторонняя программа отправляет запросы и получает данные. Через него обычно доступны:
- список объявлений, их статусы, остатки и цены;
- статистика просмотров и обращений;
- переписка с покупателями — чтение сообщений и отправка ответов;
- операции с продвижением и расходами.
Отдельно стоит мессенджер: это самая востребованная часть доступа, потому что именно на ней работают автоответчики. У неё свои требования и свои ограничения, они подробно разобраны в статье про API мессенджера Авито — здесь не будем повторяться.
Чего API не даёт: доступа к чужим аккаунтам, к контактным данным покупателей сверх того, что видно в интерфейсе, и к содержимому чужих объявлений в объёме, которого нет в публичной выдаче.
Шаг 1. Проверить исходные условия
Прежде чем разбираться, как подключить API Авито, проверьте три вещи:
Тип профиля. Личный аккаунт частного лица к API обычно не допускается. Нужен профессиональный профиль с подключённым магазином.
Тариф. Часть методов открывается только на платных тарифах определённого уровня, и требования отличаются по категориям: для услуг и для товаров условия исторически разные. Что именно нужно вам — смотрите в разделе тарифов кабинета, а не в чужих статьях. Общий обзор платных возможностей площадки есть в материале про тарифы Авито.
Состояние аккаунта. Если на профиле висят блокировки или незакрытые нарушения, заявку могут не одобрить. Сначала приведите аккаунт в порядок.
Шаг 2. Заявка и доступ
Порядок в общем виде такой: в кабинете вы находите раздел, посвящённый API или интеграциям, оставляете заявку и указываете, зачем вам доступ — свой сервис, сторонний сервис, интеграция с учётной системой. Дальше заявку рассматривают.
Сроки рассмотрения плавают от суток до нескольких недель, и это нормально: планируйте запуск с запасом, а не «подключим завтра к утру». Если отказали, в ответе обычно указана причина — чаще всего тариф или тип профиля.
Шаг 3. Ключи
После одобрения в кабинете появляется пара значений: идентификатор клиента и секретный ключ. Это и есть ваши учётные данные для API.
Три правила обращения с ними:
- Секрет — это пароль. Не отправляйте его в мессенджерах, не кладите в общие таблицы, не публикуйте в переписке с подрядчиком, которую читают посторонние.
- Ключи выдаются на аккаунт, а не на человека. Если сотрудник с доступом уходит — перевыпустите пару.
- Отзыв доступа делается в кабинете и действует сразу. Это ваша страховка: любой сервис отключается в один клик, без смены пароля от аккаунта.
По этим ключам программа получает временный токен, который живёт ограниченное время и обновляется автоматически. Вам это делать руками не нужно — этим занимается сервис.
Шаг 4. Подключение сервиса
Если вы не пишете интеграцию сами, дальнейшее выглядит просто: заходите в личный кабинет сервиса, вставляете идентификатор и секрет, сохраняете. Сервис проверяет доступ, подтягивает список объявлений и показывает, какие методы ему разрешены.
Дальше начинается содержательная часть — настройка того, что именно будет делать программа. Для автоответчика это самое важное: чем он отвечает, какие вопросы задаёт, где останавливается и зовёт человека. Технический доступ занимает полчаса, а настройка ответов — вечер, и именно она определяет результат. У нас на этом этапе бот учится говорить вашими формулировками, а не общими фразами, и передаёт живому человеку тех, кто дошёл до сделки.
Вебхуки против опроса
Есть два способа узнавать о новых сообщениях.
Опрос (polling). Программа раз в N секунд спрашивает: «есть что-то новое?» Просто в реализации, но тратит лимиты запросов и добавляет задержку.
Вебхуки. Вы регистрируете свой адрес, и площадка сама присылает уведомление о событии. Быстрее и экономнее по лимитам, но требует, чтобы у вашей стороны был постоянно доступный адрес с валидным сертификатом.
Для автоответчика разница принципиальна: на опросе ответ приходит с задержкой в десятки секунд, на вебхуках — почти сразу. Если сервис заявляет ответ «за минуту», уточните, как он получает события.
Подводные камни
Лимиты запросов. У API есть ограничения на частоту обращений. Их превышение приводит к временной блокировке — обычно это проблема самописных интеграций, которые опрашивают площадку в цикле без пауз.
Смена тарифа задним числом. Если тариф понизился или закончился, часть методов перестаёт отвечать. Внешне это выглядит как «сервис сломался», хотя сломался доступ.
Не все методы одинаково доступны. Список того, что открыто именно вам, зависит от категории и тарифа. Планируя автоматизацию, сначала проверьте, что нужный метод у вас работает, и только потом стройте на нём процесс.
Ожидание, что API заменит работу. Доступ сам по себе не отвечает покупателям и не поднимает объявления — он только позволяет это делать программе. Что имеет смысл автоматизировать, а что нет, разобрано в статье про автоматизацию Авито.
Когда API подключать не нужно
Если у вас пять объявлений и два обращения в неделю, интеграция ничего не изменит: вы успеваете отвечать сами. Смысл появляется, когда обращений столько, что часть теряется, или когда объявлений столько, что руками их не обновить.
Второй случай, когда не нужно: если доступ не дают по тарифу, а экономика не сходится. Считайте честно — стоимость тарифа плюс стоимость сервиса против того, сколько заявок вы сейчас теряете. Иногда дешевле нанять человека на приём сообщений, чем поднимать тариф ради интеграции.
Коротко
- Чтобы подключить API Авито, нужны профессиональный профиль, подходящий тариф и заявка в кабинете.
- Доступ работает на паре «идентификатор + секрет», секрет хранится как пароль и отзывается в один клик.
- Вебхуки предпочтительнее опроса: быстрее ответы и меньше расход лимитов.
- Условия доступа меняются — точные названия тарифов, методы и лимиты смотрите в актуальной документации Авито.
- Технический доступ — полчаса, настройка сценариев — основная работа.
- Если доступа не дают, ни один сервис не сможет читать вашу переписку; обещания обратного — повод насторожиться.
«Папа БУ» подключается по официальному доступу: вы вставляете ключи, отзываете их когда угодно, а бот отвечает покупателям за минуту вашими словами. Три дня бесплатно — этого хватает, чтобы посмотреть на реальных диалогах, а не на демо.