API Вебхуков

При изменении статусов объектов, система может отправлять уведомления об этом во внешние ресурсы

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

Любое вебхук-уведомление от MACRO имеет следующую базовую структуру

{
"time": 1611112517,
"data": {
...
}
}

где
time - timestamp времени отправки уведомления
data - полезная нагрузка уведомления


При изменении статусов объектов cистема будет отправлять POST-запросы со следующим содержимым

{
"time": 1611112517,
"data": {
"estate": {
"category": "flat",
"complex_id": null,
"contacts_agency_id": null,
"id": 44901,
"parent_id": 1233,
"previous_status": 0,
"previous_status_name": "Запись удалена",
"previous_status_custom": null,
"previous_status_custom_name": null,
"status": 100,
"status_name": "Сделка проведена",
"status_custom": null,
"status_custom_name": null
}
}
}

Поля в объекте estate

category - (string) категория недвижимости. Список возможных вариантов категорий недвижимости см. ниже
complex_id - (int|null) id родительского комплекса недвижимости
contacts_agency_id - (int|null) id агентства
id - (int) id объекта недвижимости
parent_id - (int|null) id родительского объекта недвижимости
previous_status - (int) id предыдущего системного статуса объекта
previous_status_name - (string) название предыдущего системного статуса объекта
previous_status_custom - (null|int) id предыдущего пользовательского статуса объекта (если компания использует произвольные статусы)
previous_status_custom_name - (null|string) название предыдущего пользовательского статуса объекта (если компания использует произвольные статус)
status - (int) id текущего/нового системного статуса объекта
status_name - (null|string) название текущего/нового системного статуса объекта
status_custom - (null|int) id текущего/нового пользовательского статуса объекта (если компания использует произвольные статусы)
status_custom_name - (null|string) название текущего/нового пользовательского статуса объекта (если компания использует произвольные статус) 

Список возможных категорий недвижимости

comm - Коммерческая недвижимость
flat - Квартира
garage - Машиноместо
house - Коттедж / таунхаус
land - Земельный участок
storageroom - Кладовая
apphouse - Дом
building - Коммерческая недвижимость
cottages - Группа коттеджей/таунхасов
parking - Парковочный комплекс
landgroup - Группа земельных участков


Список возможных системных статусов объектов недвижимости


0 - Запись удалена
3 - Неактив
4 - Отказ
5 - Неразобранное
7 - Оценка
8 - Обзвон
10 - Проверка
15 - Отложено
20 - Подбор
30 - Бронь
32 - Резерв (маркетинг)
40 - Сделка расторгнута
50 - Сделка в работе
52 - Сделка проведена (маркетинг)
53 - Сделка в работе (маркетинг)
100 - Cделка проведена
120 - В архиве

Контроль получения запроса принимающим сервером и повторная отправка

На данный момент MACRO не контролирует ответ от вашего сервера при отправке вебхука и не производит повторную отправку уведомлений при получении статуса отличного от 200 Ok.