> 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/cian.md).

# ЦИАН

ЦИАН — российский интернет-сервис для поиска и размещения объявлений о недвижимости: покупка, продажа и аренда квартир, домов, коммерческих объектов на первичном и вторичном рынке.

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

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

Агент получает сообщения из чатов по вашим объявлениям, видит карточку объявления, по которому обратился клиент, и отвечает от имени автора объявления.

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

### Получение ключа на стороне Циан

Для подключения нужен только **Access key** — ключ авторизации Циан API. Больше ничего не потребуется.

1. Напишите письмо на **<import@cian.ru>**;
2. Укажите тему письма — **ACCESS KEY**;
3. В тексте письма укажите название агентства, которое вы представляете.

Менеджер Циан уточнит детали и пришлёт ключ в ответном письме.

{% hint style="warning" %}
Для каждой учётной записи на Циан выдаётся **отдельный** ключ авторизации. Если у вас несколько кабинетов Циан, ключ нужно запросить для каждого из них.
{% endhint %}

{% hint style="info" %}
Подробнее об API площадки — в [официальной документации Циан](https://public-api.cian.ru/docs/latest).
{% endhint %}

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

1. Перейдите в **Каналы**, откройте категорию **Маркетплейсы** и выберите **ЦИАН**:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FJWgyPqOyaoXzU65qZfH8%2Fimage.png?alt=media&amp;token=bde09f76-269e-4691-8581-5b6ed01d03d8" alt=""><figcaption></figcaption></figure>

2. Вставьте полученный ключ в поле **Access key** и нажмите **Подключить**:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FEQ3PMtPyQe3qWKp6ZZWm%2Fimage.png?alt=media&amp;token=268e4578-5f9f-411d-88f5-18ab951dd787" 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%2FGezghBfXnzn9zAI2j2Cs%2Fimage.png?alt=media&amp;token=9505e128-3c85-4f60-bda2-e20e9cab2bf3" alt=""><figcaption></figcaption></figure>

## Настройки интеграции

### Ответы агента

Переключатель в правом верхнем углу. Включает и выключает работу агента в канале.

### Access key

Ключ авторизации, полученный от Циан. Здесь его можно заменить — например, если вы перевыпустили ключ или подключаете другой кабинет Циан. После изменения нажмите **Сохранить**.

### Отправка ответов агента в ЦИАН

Определяет, уходят ли ответы агента клиенту на площадку.

{% hint style="info" %}
Если настройка выключена, агент продолжает обрабатывать диалоги, но его ответы не отправляются в Циан.
{% endhint %}

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

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

> **По умолчанию в инструкцию агента передаются:**
>
> * Название объявления
> * Цена
> * Адрес объекта
> * ID объявления

{% hint style="info" %}
Помимо этого, в переменных диалога доступна **ссылка на объявление**, по которому обратился клиент — её можно использовать в инструкции агента и передавать в CRM.
{% endhint %}

### Обработка сообщений по объявлениям

Агент обрабатывает сообщения из чатов, привязанных к вашим объявлениям на Циан.

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

### Удалить подключение

Кнопка в правом верхнем углу — полностью отключает интеграцию с Циан. Чтобы подключить канал заново, потребуется снова ввести Access key.

{% hint style="warning" %}
После изменения любых настроек нажмите **Сохранить**.
{% endhint %}

## Ограничения площадки

Ограничения на вложения задаёт сама площадка:

**Форматы файлов** — JPEG, PNG, GIF, TIFF, HEIC, HEIF, DOC, PDF.\
**Максимальный размер запроса** — 50 МБ.

{% hint style="info" %}
Актуальные ограничения всегда можно проверить в [документации Циан API](https://public-api.cian.ru/docs/latest).
{% endhint %}

## Подключение CRM, типичные ошибки и игнорирование системных событий

{% hint style="info" %}
Циан работает с CRM-системами тем же образом, что и Авито.
{% endhint %}

О том, как всё устроено, мы писали здесь:

[Подключение Авито через CRM: типичные ошибки](https://docs.suvvy.ai/ru/kanaly/marketpleisy/avito#podklyuchenie-avito-cherez-crm-tipichnye-oshibki)

[Игнорирование системных событий интеграций](https://docs.suvvy.ai/ru/kanaly/marketpleisy/avito#ignorirovanie-sistemnykh-sobytii-integracii)


---

# 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/cian.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.