> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/kanaly/marketpleisy/avito.md).

# Авито

## Что позволяет? <a href="#chto-pozvolyaet" id="chto-pozvolyaet"></a>

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

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

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

Сервис **API** доступен пользователям с подключенным[ тарифом](https://www.avito.ru/subscription).

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

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

{% hint style="success" %}
Либо перейдите по ссылке: [«Для профессионалов» → «API»](https://www.avito.ru/professionals/api).
{% endhint %}

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

У вас появятся **client\_id** и **client\_secret**. Они всегда будут доступны вам во вкладке API.

<figure><img src="/files/BajGIA9ec1aoc70Bn2M9" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NGDJniA64GqiPQsERvZJ" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/VFhEQajf7rePwtdCHufE" alt=""><figcaption></figcaption></figure>

2. Введите полученные **client\_id** и **client\_secret** в соответствующие поля и нажмите **Подключить:**

<figure><img src="/files/OrtjFiiOH6ea7JEhfvLp" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/6qUMQME019JsGQmWn1qQ" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/iTqGcPS7cCL9Nu3EkK8c" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Это значит, что будут не просто сформированы переменные из диалога, а ещё и автоматически добавлены в инструкцию агента как системная инструкция и переданы в модель.
{% endhint %}

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

<figure><img src="/files/bTHyXqantnU9hHy8OkyC" alt=""><figcaption></figcaption></figure>

Предварительно надо настроить [отправку оповещений в Telegram](/ru/osnovnye-nastroiki/opovesheniya-ot-savvi.md).

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

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

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

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

<figure><img src="/files/EJ96clyyYj1uAlJZS4q2" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/Yq1dtkRmwRXDaThixTnY" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Как **загрузить таблицу**, можете прочитать в статье [Таблицы (CSV-XLS / Google)](/ru/rabota-s-tablicami/tablicy-csv-xls-google.md).
{% endhint %}

> **По умолчанию в контекст агенту передаются:**
>
> * ID объявления
> * Описание
> * Название объявления - если в названии есть какая-то информация, агент сможет использовать её при ответе.
> * Категория
> * Адрес
> * URL объявления

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

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

* Текст
* Ссылку
* Карточку прикреплённого объявления
* Локацию
* Изображение
* Голосовое сообщение

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

* Текст
* Изображение

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

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

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

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

<figure><img src="/files/CHgLAlMaVYkTiMapdLgn" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/Yeo30IxEKbIaOeWsf8PL" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/EKRt5OjrU4gypOEKxJV5" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Если не выбрано ни одно объявление, то агент будет отвечать **во всех объявлениях Авито** аккаунта.
{% endhint %}

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

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

{% hint style="warning" %}
Важно: Авито нужно подключать через CRM, а не напрямую в Suvvy.
{% endhint %}

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

* Подключите Авито внутри нужную Вам CRM (через встроенную интеграцию с Битрикс, Amocrm или Kommo)
* Подключите только выбранную CRM в настройках агента Suvvy
* Не подключайте Авито напрямую в Suvvy

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

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

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

* Для товаров: тариф «Максимальный»
* Для услуг: тариф «Расширенный» или «Максимальный»
* Обязательно: подписка «API мессенджера» (доп. 3000 руб/мес)

{% hint style="warning" %}
Тариф «Авито Про расширенный» не даёт доступ к чатам через объявления.
{% endhint %}

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

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

* Откройте настройки Открытой линии Авито в вашей CRM
* Перейдите в раздел «Доступ»
* Установите 0 пользователей с доступом

{% hint style="info" %}
Если в разделе указаны конкретные сотрудники — бот перестанет отвечать после их первого ответа.
{% endhint %}

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

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

{% hint style="warning" %}
Без подписки Pro агент будет работать, но вы не сможете диагностировать технические ошибки через логи
{% endhint %}

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

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

<figure><img src="/files/oL8QcG6oczaw121Sohyr" alt=""><figcaption></figcaption></figure>

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

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

* **Некорректная структура файла** — проверьте, что файл содержит корректные данные
* **Вызовы функций amoCRM внутри файла** — уберите действия типа «изменить поле» или «создать задачу» из логики отправки файла
* **Двусмысленные инструкции** — упростите промпт, сделайте инструкции однозначными
* **Одновременная отправка текста и файла** — Авито может не принять сообщение, попробуйте отправлять раздельно
* **Перегруженная логика сценария** — упростите сценарий, разбейте на шаги

#### Ошибка «Dialogue don't have amoCrm/Kommo channel\_variables»

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

<figure><img src="/files/l2ITGb2IuOLfSTJNYqYh" alt=""><figcaption></figcaption></figure>

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

Решение:

* Удалите прямое подключение Авито из настроек агента
* Убедитесь, что Авито подключено внутри CRM
* В Suvvy подключите только CRM
* Перезапустите агента

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

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

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

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

<figure><img src="/files/N1gDj6Hp29u7PQXZdJeH" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/l4bGsT6ES2qne1Wt2MBW" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Лучше выбирать режим "Может быть частью слова", а не точное совпадение. Так выше вероятность, что сценарий сработает верно по любому сообщению рассылки из Авито.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.suvvy.ai/ru/kanaly/marketpleisy/avito.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.