Синхронизация с сайтом

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

1. Синхронизация наличия

Для актуализации квартир на сайте рекомендуем использовать схему актуализации через фид формата Домопланер JSON [подробнее о формате фида]

Запрашивайте данные фида раз в 15 минут и обновляйте сущности объектов недвижимости на своем сайте. Рекомендуем сделать сопоставление по ID/sid помещений, в крайнем случае по ключу ПРОЕКТ-ДОМ-НОМЕР_ПОМЕЩЕНИЯ.

В Домопланере есть вебхуки на изменение цены и статусов помещений. Они могут помочь вам в считанные секунды менять наличие на сайте на актуальное, не запрашивая при этом полный фид помещений. Подробнее про вебхуки.

2. Отправка заявок с сайта в CRM

Если вы пользуетесь системой сквозной аналитики, то обязательно настройте отправку клиентов в нее. Тогда Домопланер получит информацию не от вас, а от системы сквозной аналитики.  

Если вы пользуетесь Tilda, Marquiz или любым другим генератором сайтов/посадочных страниц, то используйте соответсвующие интеграции внутри Домопланер. Личный кабинет – раздел Настройки – Интеграции.

Если у вас свой сайт, и системы сквозной аналитики нет, то вы можете отправить информацию о заявках ваших клиентов через API Домопланера. Подробное описание запроса с примерами в Postman вот тут.

3. Отправка уведомлений от агентств недвижимости c сайта в CRM

Если вы работаете с агентствами недвижимости, то можете настроить получение уведомлений от агентств сразу в Домопланер.

Схема работы:

1️⃣ Создайте страницу для риэлторов

Вы создаете страницу на сайте “Риэлторам”. На этой странице должна располагаться форма для отправки уведомления. Необходимые поля
– ФИО клиента (текстовое поле input[type=”text”])
– Телефон клиента (текстовое поле input[type=”text”])
– Комментарий по клиенту (текстовое поле textarea[rows=”3” maxlength=”500”])
– Агентство недвижимости (выпадающий список select)
– ФИО риэлтора (текстовое поле input[type=”text”])
– Телефон риэлтора (текстовое поле input[type=”text”])

При заходе на эту форму нужно загрузить список агентств, с которыми сотрудничает застройщик, из Домопланера (подробнее далее).

Пример как реализовано у одного из застройщиков: https://sibakademstroy.brusnika.ru/realtors/notification/

2️⃣ Создайте обработчик заявок

Создаете серверный скрипт, который будет принимать данные с этой формы

3️⃣ Отправьте заполненную форму в Домопланер

Пользователь заполняет форму и отправляет её вам на сервер. Ваш скрипт принимает данные, валидирует их перед отправкой в Домопланер, и отправляет.

4️⃣ Ответьте пользователю о приеме формы

Отвечаем пользователю, что с ним свяжутся или что-то в этом роде в зависимости от бизнес-процесса застройщика.

Что нужно, чтобы отправить агентский лид в Домопланер?

1️⃣ Получение API-ключа

Зайдите в Домопланере в раздел Настройки – Интеграции и выберите “API”. Создайте новый API-ключ. Скопируйте и передайте его разработчикам. Он и нужен будет для выполнения запросов. Далее по тексту API_KEY

2️⃣ Получение списка агентств недвижимости

Описание запроса с примерами в Postman вот тут

GET https://domoplaner.ru/api/agencies/get-list?addEmpty=1
HEADER Authorization: "Bearer API_KEY"

В ответ массив с агентствами, состоящий из {id: number, name: text}. Если добавить в запрос GET параметр addEmpty=1, то в список добавится пункт “Нет в списке”.

Этот список лучше реализовать через кэширование. Когда пользователь делает запрос на страницу формы, вы идете запрашивать список АН и кэшируете ответ на 30 минут. В течение всех этих 30 минут вы отдаете пользователям кэшированую версию списка АН.

Не рекомендуется запрашивать этот список перед КАЖДЫМ заходом на страницу отправки уведомления, т.к. при DDOS-атаке вашего сайта количество запросов в Домопланер может превысить лимит, и синхронизация с Домопланером перестанет работать определенное время.

ВАЖНЫЙ НЮАНС: Почему нельзя загрузить список агентств с фронтенда через javascript? Загрузка данных об агентствах идет через API-ключ. Через этот API-ключ можно произвести и другие действия. Его нужно хранить в секрете и только ваш сервер должен знать о нем. Поэтому, мы предлагаем проксировать все запросы от пользователей, связанные с Домопланером, через ваш сервер.

3️⃣ Отправка уведомления

Описание запроса с примерами в Postman вот тут