Cian

Как подключить чаты Циан к Lalexi: аккаунт агентства на платном тарифе, сервис «Сообщения», ключ доступа к Циан API — и что канал умеет после подключения.

Cian — переписка по объявлениям недвижимости в общем списке чатов. Сообщения из чатов Циан приходят в Lalexi, ответы оператора уходят обратно в Циан, причём в диалоге видно, по какому объявлению написал клиент.

Подключение делится на две части, и первая — не техническая. Чаты по API Циан отдаёт не всякому аккаунту: нужен аккаунт агентства на платном тарифе с включённым сервисом «Сообщения» и выданный Циан ключ доступа к API. Пока этого нет, подключать нечего.

Это канал самой площадки, а не мессенджер. Клиент пишет вам по объявлению из своего аккаунта Циан; ни телефона, ни ссылки на мессенджер у такого контакта нет.

Часть первая: подготовка на стороне Циан

Всё в этом разделе делается в вашем кабинете Циан и в переписке с Циан, до того как вы откроете Lalexi.

1. Аккаунт агентства на платном тарифе

Доступ к Циан API даёт платный тариф — у Циан это «Базовый», и аккаунт должен быть оформлен как агентство, а не как частное лицо. Условия тарифа описаны в справке Циан.

Переход на платный тариф у Циан необратим: вернуться к прежнему способу размещения нельзя. Решайте это до того, как писать в Циан.

2. Сервис «Сообщения»

В кабинете должен быть включён сервис «Сообщения» — это он создаёт те самые чаты по объявлениям. Без него ключ выдадут, но чатов по API не будет.

3. Кто в кабинете отвечает на сообщения

Это тот пункт, на котором подключение чаще всего даёт неожиданный результат. В кабинете Циан есть настройка, кому принадлежат чаты:

Настройка в кабинете Циан	Что увидит Lalexi по ключу агентства
отвечает только главный аккаунт	все чаты аккаунта доступны по одному ключу
отвечают сотрудники (агенты)	чаты лежат у сотрудников, и ключ агентства их не увидит

Подключать нужно главный аккаунт агентства — ключ выдаётся только в нём. Смена этой настройки перекладывает уже существующие чаты между аккаунтами, поэтому определитесь с ней до подключения, а не после.

4. Ключ доступа к Циан API

Ключ — это одна строка, которой Lalexi читает и отправляет сообщения вашего аккаунта. Получить его можно двумя путями.

Письмом в Циан. Если тарифа ещё нет, он и ключ согласуются одним письмом: пишите на import@cian.ru — так это прошло у нас, ключ прислали в ответ. В справке Циан для подключения самого тарифа указан также адрес fb@cian.ru. В любом случае назовите регионы, по которым вы размещаете объявления. Примерный текст:

Добрый день!

Хочу настроить интеграцию с вашим API. По информации на support.cian.ru мне нужен тариф «Базовый», а для подключения — написать вам.

Планирую публикацию объявлений по Москве и Подмосковью.

Учётная запись: <логин или номер аккаунта>, подключение от имени организации «<название>», ИНН <номер>.

Прошу согласовать подключение тарифа и сообщить, что ещё требуется с моей стороны.

В ответном письме Циан присылает ключ доступа к Циан API и предупреждение, что ключ открывает доступ к приватной информации аккаунта. Больше ничего согласовывать не нужно — этого ключа достаточно, чтобы подключить канал.

В кабинете. Если тариф и сервис «Сообщения» уже подключены, ключ можно выпустить самостоятельно: Настройки → Ещё → Циан API → «Получить ключ API». Ключ придёт на почту, на которую зарегистрирован аккаунт (она указана в разделе «Регистрационные данные»), а не покажется на экране.

Ключ доступа — это доступ к API вашего аккаунта Циан и к приватной информации в нём. Lalexi хранит его в зашифрованном виде и использует только для чтения и отправки сообщений этого аккаунта. Если ключ утёк — перевыпустите его в кабинете Циан и переподключите канал (не заводите новый источник, см. ниже).

Адрес обратного вызова: готовить не нужно

Адрес, на который Циан доставляет входящие сообщения, Lalexi регистрирует сам в момент подключения — вводить его куда-либо не нужно, и он у каждого подключения свой. Чужие интеграции, уже подписанные на ваш аккаунт, мы не снимаем.

Часть вторая: подключение в Lalexi

Откройте Настройки → Источники (Settings → Inboxes), нажмите Добавить источник (Add Inbox) и выберите плитку Cian.
Нажмите Connect — откроется вкладка со страницей привязки.
Вставьте ключ доступа и, если хотите, укажите имя подключения — например название агентства.
Нажмите Connect. Ключ проверяется сразу, живым запросом к Циан: если он не подойдёт, форма скажет об этом, и источник не создастся.

Когда привязка прошла, источник появится в списке под именем Cian · «имя подключения» со статусом Подключено.

Имя подключения вы вводите сами — и это единственный способ его задать. У Циан API нет вызова «кто я»: ни названия агентства, ни номера аккаунта он не возвращает. Если поле оставить пустым, в названии источника будет технический идентификатор подключения, и различать несколько аккаунтов станет труднее.

Сразу после привязки вы попадёте на вкладку «Подключение», где нужно выбрать, какие чаты зеркалировать, и при желании импортировать прежнюю переписку — см. Настройки синхронизации. Пока фильтр не настроен, ничего не импортируется и входящие игнорируются.

Ссылка на страницу привязки живёт 30 минут. Если она устарела, вернитесь в «Добавить источник» и выберите Cian заново.

Перевыпущенный ключ — переподключение, а не новый источник

Ключ Циан можно перевыпустить в кабинете, и тогда прежний перестаёт работать: канал перейдёт в состояние «Требуется переподключение». Новый ключ нужно вставить на вкладке «Подключение» → «Переподключить» — канал, диалоги и история при этом сохранятся.

Если вместо этого завести новый источник и вставить туда перевыпущенный ключ, получится второй канал с пустой историей, а прежние диалоги останутся в старом: со стороны Lalexi новый ключ выглядит как другой аккаунт, и связать их потом уже нельзя.

По какому объявлению пишут

На площадке клиент обращается не «в агентство», а по конкретному объявлению, поэтому Lalexi подписывает им диалог: заголовок объявления, цена, адрес и ссылка приходят вместе с самим сообщением и показаны в шапке диалога и в строке списка чатов — разбирать входящие можно, не открывая каждое. По новостройкам так же показываются название ЖК и адрес.

У диалогов из импорта истории в шапке будет стоять «Объявление №…» с номером — до тех пор, пока по ним не придёт новое сообщение: в списке чатов Циан отдаёт только номер объявления, а карточку с заголовком и ценой приносит уже входящее.

Что канал умеет и чего не умеет

Ограничения тут не наши, а самого Циан:

Отвечает только тем, кто написал первым. Чат на площадке всегда открывает клиент, метода «начать переписку» в API нет. Поэтому канал недоступен в «Новом сообщении», рассылках и прогреве.
Список чатов и история есть — можно выбрать, какие чаты зеркалировать, и импортировать прежнюю переписку, см. Настройки синхронизации.
Импорт не трогает кабинет. После импорта чаты в кабинете Циан остаются непрочитанными — мы специально не помечаем их прочитанными, чтобы не сбить вашу работу в кабинете.
Ответ оператора помечает чат прочитанным в кабинете Циан. Пока никто не ответил, чат там остаётся непрочитанным — честный сигнал о неотвеченном обращении.
Ответы из кабинета Циан видны в Lalexi. Если кто-то ответил клиенту прямо в кабинете, его сообщение появится в диалоге как исходящее, и оператор не поздоровается второй раз.
Телефона клиента Циан не отдаёт: контакт опознаётся по его идентификатору в Циан и не объединяется с контактом из WhatsApp или Telegram. Имя берётся из того, что Циан прислал вместе с сообщением.
Файлы — только тех типов, что принимает Циан: JPEG, GIF, PNG, TIFF, HEIC/HEIF, DOC, PDF. Остальное (видео, аудио, архив, таблица) канал отклонит с ошибкой прямо в чате, ещё до отправки. Текст уходит подписью к файлам, отдельным сообщением его дублировать не нужно.
Длинный ответ не режется: ограничения на длину текста у Циан нет.
Служебные сообщения Циан (уведомления о прочтении и системные события) в диалоги не попадают. Сообщения чат-бота Циан видны в переписке, но собеседником он не становится.
Скорость ограничена пятью запросами в секунду на ключ — поэтому большой импорт истории идёт постепенно, а не мгновенно.
Один ключ — один источник. Повторная привязка того же ключа не создаст второй канал, а обновит существующий.

Подключение занимает слот в лимите подключений.

Если что-то не так

Симптом	Что делать
Ключ не принимается	Скопируйте его целиком, без пробелов по краям. Проверьте, что ключ выдан в главном аккаунте агентства, тариф оплачен, а сервис «Сообщения» включён.
Форма пишет, что ссылка больше не действует	Ссылка на привязку живёт 30 минут. Вернитесь в «Добавить источник» и выберите Cian заново.
Канал просит переподключения	Ключ перевыпущен или отозван в кабинете Циан. Нажмите «Переподключить» на вкладке «Подключение» и вставьте новый ключ.
Подключено, но диалогов нет вовсе	Сначала проверьте, какие чаты зеркалируются, в настройках синхронизации — без выбранного режима не импортируется ничего. Вторая частая причина — в кабинете Циан на сообщения отвечают сотрудники, и чаты лежат у них, а не у агентства.
Подключено, но часть чатов не пришла	Та же настройка «кто отвечает»: чаты, закреплённые за сотрудником, по ключу агентства не видны.
В шапке диалога «Объявление №…» вместо названия	Так выглядит диалог из импорта, пока по нему не пришло новое сообщение: карточку объявления Циан присылает вместе с сообщением.
Файл не отправился	Циан принимает JPEG, GIF, PNG, TIFF, HEIC/HEIF, DOC и PDF. Остальное придётся отправить ссылкой.
Сообщения перестали приходить, хотя статус «Подключено»	Циан отключает адрес доставки, если сообщения долго не доходят (например, из-за аварии). Напишите в поддержку и укажите ID подключения с вкладки «Подключение» — адрес нужно зарегистрировать заново.
Чаты в кабинете Циан стали прочитанными	Так работает ответ оператора: отвечая из Lalexi, он помечает чат прочитанным и в кабинете. Импорт истории этого не делает.

Cian

Содержание