For the complete documentation index, see llms.txt. This page is also available as Markdown.

Авито

Ави́то — интернет-сервис для размещения объявлений о товарах, недвижимости, вакансиях и резюме на рынке труда, а также услугах.

Что позволяет?

Данный канал предназначен для автоматизации общения с клиентами на площадке интернет-сервиса Avito.

Как подключить?

Подключение API на стороне Avito

Сервис API доступен пользователям с подключенным тарифом.

Если у вас активен тариф:

  1. В профиле откройте раздел «Для профессионалов» → API;

  1. Нажмите Получить ключи.

У вас появятся client_id и client_secret. Они всегда будут доступны вам во вкладке API.

Подключение Avito на стороне Савви

  1. Перейдите в Каналы и выберите Avito:

  1. Введите полученные client_id и client_secret в соответствующие поля и нажмите Подключить:

  1. Здесь Вы можете Включить/Выключить ответы агента, а также полностью Отключить интеграцию. Нажмите Сохранить:

Возможности интеграции

Добавлять информацию о параметрах объявления в инструкцию для агента

Отправлять уведомление, если агент не может найти ответ на вопрос

Предварительно надо настроить отправку оповещений в Telegram.

Таблица товаров с описанием

Чтобы агент имел полное описание объявления, а не только название и цену, надо выгрузить с Савви таблицу всех активных объявлений, заполнить/дополнить колонку с описанием объявлений и подгрузить её в раздел Таблицы.

Чтобы это сделать, надо:

  1. Скачать таблицу всех активных объявлений на Avito по кнопке в Савви:

  1. Внести изменения в таблицу, загрузить эту таблицу в агента в разделе Таблицы и выбрать загруженную таблицу в выпадающем меню:

По умолчанию в контекст агенту передаются:

  • ID объявления

  • Описание

  • Название объявления - если в названии есть какая-то информация, агент сможет использовать её при ответе.

  • Категория

  • Адрес

  • URL объявления

Возможности передачи медиафайлов:

Можем принять от Авито:

  • Текст

  • Ссылку

  • Карточку прикреплённого объявления

  • Локацию

  • Изображение

  • Голосовое сообщение

Можно отправить на Авито:

  • Текст

  • Изображение

Требования к отправке изображений:

Формат — JPEG, HEIC, GIF, BMP или PNG. Максимальный размер файла — 24 МБ; Максимальное разрешение — 75 мегапиксилей;

Отвечать только на определённые объявления

Чтобы выбрать те объявления, на которые агент будет отвечать, нужно перейти в раздел Настройки

Включить флаг Отвечать только на выбранные объявления.

Перед нами окажется список всех созданных объявлений. Чтобы агент отвечал, например, только на объявления Ford Focus 1.6 MT, 2018, 120 250 км и Chery Tiggo 4 1.5 CVT, 2022, 50 250 км, необходимо включить соответствующие флаги.

Подключение Авито через CRM: типичные ошибки

Правильная схема подключения

Правильная схема:

  • Подключите Авито внутри нужную Вам CRM (через встроенную интеграцию с Битрикс, Amocrm или Kommo)

  • Подключите только выбранную CRM в настройках агента Suvvy

  • Не подключайте Авито напрямую в Suvvy

Почему именно такая схема: При прямом подключении Авито в Suvvy диалоги не будут содержать контекст CRM (переменные channel_variables), и действия с CRM (создание задач, изменение полей, смена статуса) работать не будут.

Требования к тарифам Авито

Для работы интеграции нужно выбрать верные тарифы на самой платформе Авито:

  • Для товаров: тариф «Максимальный»

  • Для услуг: тариф «Расширенный» или «Максимальный»

  • Обязательно: подписка «API мессенджера» (доп. 3000 руб/мес)

Настройка доступа в Битрикс24 / amoCRM/ Kommo

Если бот отвечает только на первое сообщение клиента:

  • Откройте настройки Открытой линии Авито в вашей CRM

  • Перейдите в раздел «Доступ»

  • Установите 0 пользователей с доступом

Если в разделе указаны конкретные сотрудники — бот перестанет отвечать после их первого ответа.

Логи запросов

Доступ к логам запросов (для диагностики проблем с Авито) доступен только пользователям с подпиской Pro и выше в Suvvy.

Ошибка «Не удалось обработать ответ от агента (отправить присланный им файл)»

Вот так выглядит в экспорте:

Эта ошибка возникает при попытке отправить файл в Авито.

Частые причины:

  • Некорректная структура файла — проверьте, что файл содержит корректные данные

  • Вызовы функций amoCRM внутри файла — уберите действия типа «изменить поле» или «создать задачу» из логики отправки файла

  • Двусмысленные инструкции — упростите промпт, сделайте инструкции однозначными

  • Одновременная отправка текста и файла — Авито может не принять сообщение, попробуйте отправлять раздельно

  • Перегруженная логика сценария — упростите сценарий, разбейте на шаги

Ошибка «Dialogue don't have amoCrm/Kommo channel_variables»

Пример из экспорта:

Причина: диалог ведётся через канал Авито, подключённый напрямую в Suvvy, а не через amoCrm, Bitrix или Kommo.

Решение:

  • Удалите прямое подключение Авито из настроек агента

  • Убедитесь, что Авито подключено внутри CRM

  • В Suvvy подключите только CRM

  • Перезапустите агента

Игнорирование системных событий интеграций

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

Как настроить игнорирование системных событий

  • Перейдите в настройки агента → раздел «Дополнительные настройки» → Параметры ответов → Условия прерывания → Игнорировать первые сообщения от сотрудника:

  • Добавьте паттерны (шаблоны текста) системных событий, которые нужно исключить из обработки:

Последнее обновление

Это было полезно?