# Авито

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FoNI66HJW3uaboicYd5W4%2Fimage.png?alt=media&#x26;token=b3f7b221-6c6c-494c-bb16-6c3fda96967f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F0SkrI0qQpsfhki8NisE0%2F1.png?alt=media&#x26;token=13b97364-bfa1-4026-a3d5-67fac975f54f" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FJI2LvBOAT808ypVbICDE%2Fimage.png?alt=media&#x26;token=1ae72837-05d6-4d53-9d10-08be0e75c5bf" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FFFNSaPO5ZS3lD3opLetD%2Fimage.png?alt=media&#x26;token=6802bbf1-4d57-4618-b503-fbf566a94349" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F63v3zjSHtsgRNgr0qWzz%2Fimage.png?alt=media&#x26;token=a3ef95e9-475d-4e2b-b14c-db437ab0149a" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FHvt4ODW7ZAXYRy8xmqAo%2Fimage.png?alt=media&#x26;token=cf955641-6913-4533-9093-bef4d18aeec0" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F7LgVLdj0iJNrnlXSsp5Q%2Fphoto_5393407497399373783_y.jpg?alt=media&#x26;token=747980ae-f831-4970-ba98-ce79282e8bf1" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FkBZ1hMlWJeGKChkuPe3g%2Fimage.png?alt=media&#x26;token=af743e5d-0a59-43e1-906c-f8d4578b3a55" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F4oTxgi8HwocGIva6qOHF%2Fimage.png?alt=media&#x26;token=b59cbca6-109e-46ab-92ef-650a2f233544" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FG9H8QObnq2gD95VTtUX3%2Fimage.png?alt=media&#x26;token=8a7df3e1-9c47-417a-8fd3-2e3a25931391" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F0MkgATYCm3AyhXtIVgW7%2Fimage.png?alt=media&#x26;token=4f1e526d-555d-4701-84fe-37d3e47be369" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FJewb9WQt7gcgD8eN1AJh%2Fimage.png?alt=media&#x26;token=583ce64f-a3ea-4143-a64d-3b8fdfeef298" alt=""><figcaption></figcaption></figure>

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