Чат-бот для ЦИАН: подключение ИИ-агента к откликам

Отклики на ЦИАН приходят пачками по субботам: человек с утра открыл поиск квартиры, за час написал в пятнадцать объявлений и к обеду забыл половину адресов. Отвечает он тому, кто откликнулся первым, до остальных очередь доходит, только если первый не подошёл.

Агентству с сотней активных объявлений закрыть эти отклики руками невозможно физически — и здесь в игру входит автоматизация. У ЦИАН для неё своя логика получения доступа и свои условия по вложениям, разбираем их по порядку.

Как получить доступ к API ЦИАН

За ключом обращаются на почту, отдельного личного кабинета разработчика у ЦИАН нет.

Нужно написать письмо на import@cian.ru с темой ACCESS KEY и указать в тексте название агентства, от которого поступает запрос. Менеджер площадки уточнит детали и пришлёт в ответ Access key, единственное, что требуется для подключения на стороне Савви.

Разбираться в личном кабинете ЦИАН и искать раздел API не придётся: вся процедура укладывается в одно письмо, без модерации заявки в привычном смысле.

Ключ выдают на каждый кабинет отдельно

Здесь чаще всего теряют время агентства с несколькими офисами.

Access key выдаётся на конкретную учётную запись ЦИАН. Если у агентства три кабинета — три отдельных письма на import@cian.ru, и три разных ключа. Один ключ, полученный для головного офиса, во второй кабинет не подойдёт, даже если оба принадлежат одной компании.

Вставляется ключ в Савви так же просто, как получен: раздел «Каналы» → категория «Маркетплейсы» → ЦИАН → поле Access key → «Подключить». Заменить ключ можно в любой момент — например, если он перевыпущен площадкой или добавляется второй кабинет.

Что агент видит из отклика

Каждое сообщение по объявлению приходит агенту вместе с карточкой, к которой оно привязано.

В инструкцию агента по умолчанию передаются название объявления, цена, адрес объекта и ID. Ссылка на само объявление доступна отдельной переменной диалога, её можно вписать в сценарий или передать в CRM вместе с остальными полями сделки.

Клиент почти никогда не называет адрес в первом сообщении: «а торг возможен» без привязки к объекту звучит как вопрос в пустоту, с карточкой это понятный запрос по конкретному объекту. Схема с карточкой объявления работает и в Авито, и там же собран разговор о том, кого из откликнувшихся передавать риелтору.

Вложения и ограничения площадки

Ограничения на файлы задаёт сама площадка, и они шире, чем у соседних каналов.

Восемь форматов вложений покрывают почти всё, чем реально обмениваются в переписке по объявлению: фото квартиры, скан документа, PDF с планировкой. Актуальный перечень площадка ведёт в собственной документации API, при спорной ситуации ориентироваться стоит на неё.

Почему ЦИАН нужно подключать через CRM

Это главное решение, и принимать его нужно до того, как ключ вставлен в форму.

ЦИАН работает с CRM тем же образом, что и Авито: правильная схема — подключить канал внутри Битрикс24, amoCRM или Kommo, а в настройках агента Савви оставить только саму CRM. Прямое подключение ЦИАН в агенте выглядит рабочим ровно до первой попытки что-то сделать со сделкой.

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

С чего начать

Переберите свои кабинеты ЦИАН и посчитайте, сколько писем на import@cian.ru нужно отправить: по одному на каждую учётную запись — без исключений.

Пока ключи в пути, стоит решить второй вопрос — заводить канал внутри CRM или напрямую в агенте. Если CRM в компании уже используется, ответ известен заранее: только через неё, иначе действия со сделками останутся красивой настройкой без результата. Устройство связи агента с CRM в целом — в материале интеграция чат-бота с CRM, а тарифные условия соседней площадки — в статье чат-бот для Авито.

Частые вопросы