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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

8 форматов JPEG, PNG, GIF, TIFF, HEIC, HEIF, DOC, PDF

50 МБ максимальный размер одного запроса

~15 ₽ стоимость диалога при оплате по токенам

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

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

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

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

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

1 Подключить ЦИАН внутри CRM Через встроенную интеграцию Битрикс24, amoCRM или Kommo — так, как это делает сама CRM, без Access key в Савви.

2 В Савви подключить только CRM ЦИАН отдельным каналом в агенте не заводится, если он уже заведён через CRM.

3 Проверить экспорт первого диалога Ошибка про отсутствие channel_variables amoCRM или Kommo — верный признак, что где-то осталось прямое подключение.

4 Настроить доступ открытой линии В разделе «Доступ» выставить ноль пользователей — иначе бот замолкает после первого ответа сотрудника.

Какие CRM подключаются к Савви и что делать, если вашей нет в списке

В руководстве Савви перечислены пять CRM: amoCRM, Kommo, Битрикс24, RetailCRM и GetCourse. Схема из раздела выше, с каналом внутри CRM, описана для Битрикс24, amoCRM и Kommo.

Для Prosto и любой другой CRM подходит «Персональный канал (API)». Он позволяет направлять вопросы и получать ответы Савви из своего канала или CRM. В разделе «Каналы» вы вводите адрес вашего вебхука, и Савви отправляет на него сообщения. Токен канала показывается один раз, а секретное слово по желанию помогает отсеивать чужие запросы. Кнопка «Тест вебхука» проверяет, что адрес отвечает. Адрес и разбор формата сообщений нужно уточнять у отдела разработки: руководство прямо предупреждает, что нужен опыт настройки веб-серверов.

С чего начать

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

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

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

Антон БесщетниковОснователь и CEO платформы СаввиБолее 100 внедрений ИИ-сотрудников в разных сферах бизнеса. Пишет о том, как устроены ИИ-агенты: инструкции и промпты, голосовые агенты, интеграции с CRM и каналы общения с клиентами.