API и вебхуки: данные кабинетов Авито в вашей CRM, отчётах и скриптах

Кабинет — удобно, пока данные нужны только вам. Как только клиент хочет видеть лиды в своей CRM, руководитель — сводку в своём дашборде, а разработчик — дергать статистику скриптом, нужен API. Публичный API AV Ranker отдаёт всё, что сервис уже знает о ваших аккаунтах Авито, в одном формате и по одному ключу, а вебхуки приносят события в ваши системы без опроса.

Зачем API поверх Авито, если у Авито есть своё

У Авито действительно есть API — и авитолог с десятью клиентами знает, чего оно стоит в поддержке: отдельные client_id и client_secret на каждый кабинет, токены с истечением, разные версии методов для статистики, мессенджера, автозагрузки и CPA, ограничения по числу запросов, доступ к части методов только на платных тарифах площадки. Каждый скрипт под каждого клиента — своя обвязка.

Методы API

Базовый адрес — https://av-ranker.ru/v1, авторизация — заголовок X-API-Key: avr_…, ответы — JSON в UTF-8.

Аккаунты, к которым вас пригласили как участника команды, доступны по API так же, как собственные, — с той же ролью: наблюдатель читает, менеджер ещё и пишет.

Пример: сводка по всем клиентам одним запросом на кабинет

curl -H "X-API-Key: avr_XXXX" https://av-ranker.ru/v1/clients
# → [{"id": 12, "name": "Эвакуатор 24/7", "avito_user_id": 1234567, "avito_name": "Эвакуатор 24/7",
#      "profile_url": "https://www.avito.ru/user/…", "autobidder": true, "target_cpl": 230}, …]

curl -H "X-API-Key: avr_XXXX" "https://av-ranker.ru/v1/clients/12/summary?period=week"
# → {"period": "week",
#     "totals": {"views": 4210, "contacts": 312, "calls": 118, "favorites": 57, "active_items": 41, …},
#     "items": [{"id": 300123, "title": "Эвакуатор круглосуточно", "views": 812, "contacts": 61, "bid": 38, …}, …]}

Периоды — today, yesterday, week, month. Цикл по списку клиентов, запись в Google Sheets или базу — и у руководителя агентства дашборд по 30 кабинетам с просмотрами, контактами и звонками по каждому объявлению. Расход и цена лида берутся из /leads (стоимость каждого CPA-лида) — те же цифры, что в кабинете и в брендированном отчёте, расхождений с тем, что видит клиент, не будет.

Вебхуки

Укажите https-URL и выберите события — сервис будет присылать POST с JSON:

POST https://your-crm.example/avr-hook
X-AVR-Event: deal.stage
X-AVR-Signature: 6f1c…   # HMAC-SHA256(body, secret)

{
  "event": "deal.stage",
  "ts": 1757980000.12,
  "data": {
    "client_id": 12,
    "client": {"id": 12, "name": "Эвакуатор 24/7"},
    "deal": {"id": 341, "stage": "contact", "buyer": "Александр", "phone": "+7…",
             "item_title": "Эвакуатор круглосуточно", "amount": null}
  }
}

Подпись — HMAC-SHA256 от тела запроса секретом вебхука, в заголовке X-AVR-Signature; событие дублируется в X-AVR-Event. Проверяйте подпись на приёме — так нельзя подсунуть вашей CRM поддельную сделку. При ошибке — три попытки с паузой; после 20 ошибок подряд вебхук выключается, вы видите последний статус и счётчик в кабинете, там же кнопка «Тест», которая шлёт проверочное событие.

Типовые интеграции

• Bitrix24 / amoCRM. Вебхук deal.created и deal.stage → входящий вебхук CRM (или сценарий в Albato / n8n / Make) → сделка в вашей воронке с телефоном, объявлением и ссылкой на чат. Отдельный вебхук именно для CRM настраивается в «Настройки» → CRM со своим секретом — без API-ключа, за две минуты.
• Дашборд руководителя. Раз в час скрипт забирает /summary по всем аккаунтам и складывает в Google Sheets, Power BI, Metabase или DataLens — расход и CPL по клиентам на одном экране, история накапливается у вас.
• Колл-центр. message.in прилетает в вашу систему очередей; оператор отвечает через POST …/messages — покупатель получает ответ в чате Авито от имени аккаунта.
• Сквозная аналитика. lead.new со стоимостью лида и объявлением уходит в вашу базу — считаете ROMI по каждому объявлению вместе с продажами из CRM и решаете, где поднимать целевой CPL в автобиддере.
• Своя ИИ-обработка. Если у клиента уже есть бот на NextBot, Leadarr или собственная модель — message.in + POST …/messages дают ему канал в Авито через ваш кабинет, а ИИ-ответчик AV Ranker при этом можно выключить для этого аккаунта.
• Отчёт клиенту в его формате. Клиент хочет PDF раз в неделю или Excel — /summary и /leads отдают данные, шаблон делаете свой.

Кому это нужно, а кому — нет

Ключи и безопасность

Ключи создаются в кабинете, показываются один раз и хранятся хешем. У каждого ключа — название и дата последнего использования, отзыв мгновенный. Ключ даёт доступ только к вашим аккаунтам и аккаунтам команд, где вы участник. Авито-ключи клиентов через API не отдаются никогда — интеграция не может унести с собой доступ к кабинету Авито. Вебхуки принимаются только на https; секрет вебхука хранится отдельно от API-ключей и меняется без пересоздания интеграции.

Как начать

1. «Настройки» → «API и вебхуки» → «Создать ключ», назовите его по интеграции. Скопируйте — второй раз ключ не покажется.
2. GET /v1/me — проверьте, что ключ работает и видит нужные аккаунты.
3. Для событий — добавьте вебхук: URL, секрет, события. «Тест» пришлёт проверочное событие с подписью.
4. Для CRM клиента без программиста — «Настройки» → CRM → URL входящего вебхука Bitrix24 / amoCRM.

Годовая оплата — минус 20% к любой строке. Апгрейд с «Базового» на «Про» посреди периода — с перерасчётом за оставшиеся дни, а не полной ценой.

Частые вопросы

Смотрите также

Виталий Исаков SEO и лидогенерация 12 лет. Автор AV Ranker — сервис собран на живых клиентских аккаунтах, не «на бумаге».

Запросить консультацию