Avito API в n8n: сообщения и заявки в CRM

В этой статье вы получите ключи Avito, подключите API мессенджера к n8n и настроите передачу новых обращений в CRM. Официальная документация находится в каталоге API Avito. Адреса методов ниже взяты из открытых клиентских библиотек и примеров интеграторов. Avito меняет версии методов, поэтому перед запуском сверьте их с каталогом.

Что понадобится

• Аккаунт Avito с подпиской, в которую входит API мессенджера.
• Ключи client_id и client_secret.
• n8n на своём сервере с HTTPS.
• CRM с API, например amoCRM или Битрикс24.

Условия доступа

По данным интеграторов, с ноября 2025 года Avito требует платную подписку для чтения и отправки сообщений через API. Без неё API отвечает ошибкой 402 с текстом «Перейдите на подписку с API мессенджера». Список чатов и управление вебхуками при этом могут работать, поэтому сценарий выглядит настроенным, но сообщений не получает.

Какой тариф нужен, источники описывают по-разному: для товарных категорий называют максимальный, для услуг расширенный. Уточните условия в личном кабинете или у менеджера Avito до начала работ и заложите подписку в расчёт окупаемости.

Шаг 1. Получить client_id и client_secret

Ключи выдаются в личном кабинете Avito в настройках для профессионалов, в разделе интеграций и API. Название раздела в разных инструкциях отличается, ориентируйтесь на кабинет. Ключи принадлежат вашему аккаунту. Храните их только в Credentials n8n.

Шаг 2. Получить токен

Avito выдаёт токен по схеме OAuth 2.0 Client Credentials. Проверочный запрос:

curl -X POST https://api.avito.ru/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=$AVITO_ID&client_secret=$AVITO_SECRET"

В ответе будут access_token, token_type и expires_in. Дальше токен передаётся в заголовке Authorization: Bearer ТОКЕН.

В n8n не нужно получать токен вручную. Создайте в Credentials доступ типа OAuth2 API:

• Grant Type: Client Credentials
• Access Token URL: https://api.avito.ru/token
• Client ID и Client Secret: ваши ключи

Если Avito не выдаёт токен, в настройках доступа выберите передачу ключей в теле запроса. n8n сам обновит токен, когда срок закончится.

Шаг 3. Узнать user_id

Почти все методы мессенджера содержат ID вашего аккаунта:

GET https://api.avito.ru/core/v1/accounts/self

Сохраните id из ответа. Ниже он обозначен как {user_id}.

Шаг 4. Чаты и сообщения

Все адреса начинаются с https://api.avito.ru. Тело запроса на отправку:

{
  "type": "text",
  "message": { "text": "Здравствуйте. Товар в наличии, могу ответить на вопросы." }
}

Параметры фильтрации списка чатов, например только непрочитанные, смотрите в описании метода.

Шаг 5. Подписаться на вебхук

Чтобы не опрашивать чаты по расписанию, подпишитесь на события мессенджера:

POST https://api.avito.ru/messenger/v3/webhook

{ "url": "https://n8n.example.ru/webhook/avito-k7f3q9" }

Проверить подписки можно методом POST /messenger/v1/subscriptions, отписаться методом POST /messenger/v1/webhook/unsubscribe.

Требования к адресу:

• Доступен из интернета по HTTPS.
• Отвечает кодом 200 быстро, по опыту разработчиков примерно за 2 секунды. В узле Webhook выберите ответ Immediately, а обработку ведите дальше по сценарию.
• Содержит длинную случайную часть, чтобы адрес нельзя было угадать.

Структуру события посмотрите в первом полученном запросе в n8n. Для сценария нужны ID чата, автор и текст сообщения.

Шаг 6. Передать заявку в CRM

Типовая схема:

1. Webhook принимает событие о новом сообщении.
2. Filter отсеивает ваши собственные ответы по автору. Без этого сценарий может реагировать на свои же сообщения.
3. Поиск в CRM сделки с этим chat_id, например по отдельному полю сделки.
4. Если сделки нет, создаём заявку: объявление, текст первого сообщения, ссылка на чат. Если есть, добавляем сообщение в примечание.
5. Менеджеру уходит уведомление: «Новое обращение с Avito, сделка № 1234».

Как создавать сделки, описано в статьях об amoCRM и n8n и о Битрикс24 и n8n.

В нерабочее время нейросеть может отвечать на типовые вопросы о наличии и доставке. Используйте YandexGPT или GigaChat, задайте в инструкции, что модель не обещает цены и скидки, и передавайте ей только текст вопроса. Как это настроить, описано в статье о YandexGPT в n8n.

Частые ошибки

• 401. Токен истёк. Проверьте, что доступ в n8n настроен как OAuth2 и обновляет токен сам.
• 402. Нет подписки с API мессенджера.
• 403. У аккаунта нет доступа к методу или в пути указан чужой user_id.
• Вебхук молчит. Нет подписки, адрес недоступен снаружи, сценарий в n8n не активирован или указан тестовый адрес.
• Дубли заявок. Если событие придёт повторно или клиент напишет несколько сообщений подряд, сценарий без проверки создаст несколько сделок. Перед созданием ищите сделку по chat_id.