> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/integrations/cian.md).

# ЦИАН

Интеграция с ЦИАН добавляет в Nextbot новый канал связи для работы с чатами по объявлениям недвижимости. После подключения ИИ-агент сможет отвечать клиентам в диалогах ЦИАН с учётом данных конкретного объявления.

{% hint style="info" %}
Для подключения нужен ключ из раздела **Циан API**. Такой ключ могут получить профессиональные участники рынка недвижимости: риелторы, застройщики и агентства недвижимости.
{% endhint %}

## Подключение

1. Войдите в личный кабинет ЦИАН.
2. Перейдите в раздел **Настройки** -> **Циан API**.
3. Скопируйте ключ API.
4. В Nextbot откройте раздел **Интеграции** -> **ЦИАН**.
5. Вставьте ключ в поле **Access Key**.
6. Нажмите **Подключить**.

<figure><img src="/files/FZ5qULHarduLB7d1JEv2" alt="Ключ Циан API в личном кабинете ЦИАН"><figcaption><p>Ключ API в личном кабинете ЦИАН</p></figcaption></figure>

После успешного подключения настройте режимы автоответов, чтобы определить, в каких диалогах будет отвечать ИИ-агент.

## Режимы автоответов

На странице интеграции ЦИАН можно выбрать, в каких диалогах агент будет подключаться к общению.

* **Отвечать в свои объявления** — агент будет отвечать клиентам, которые пишут в ваши объявления.
* **Отвечать в чужие объявления** — агент подключится к ранее созданному вами диалогу, если вы написали из своего личного кабинета ЦИАН по объявлению другого пользователя, а затем продолжит общение с клиентом.

Можно включить один или два режима одновременно.

{% hint style="warning" %}
Если включён только один режим автоответов, его нельзя отключить отдельно. Чтобы полностью остановить ответы агента в ЦИАН, отключите интеграцию.
{% endhint %}

## Данные объявления в промпте

Чтобы агент мог отвечать по конкретному объявлению ЦИАН, добавьте в системный промпт специальные переменные. При каждом обращении они автоматически заполняются актуальными данными из объявления.

Для быстрого добавления переменных откройте страницу интеграции ЦИАН и нажмите **Вставить шаблон в промпт**. В системную инструкцию агента будет добавлен готовый шаблон, который можно адаптировать под ваши задачи и стиль общения.

## Просмотр объявления в Диалогах

В разделе **Диалоги** в предпросмотре отображается адрес объявления. Нажмите на адрес, чтобы загрузить подробную информацию по объекту:

* фотографию;
* название;
* адрес;
* цену;
* ссылку на объявление;
* тип объявления;
* ID чата;
* ID сущности;
* ID объявления.

<figure><img src="/files/KKevW1r0SpNo2tEx9rlN" alt="Информация по объявлению ЦИАН в Диалогах Nextbot"><figcaption><p>Предпросмотр объявления ЦИАН в разделе Диалоги</p></figcaption></figure>


---

# 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://doc.nextbot.ru/functional/integrations/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.