API Вебхуков

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

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

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

{<br></br> "time": 1611112517,<br></br> "data": {<br></br> ... <br></br> }<br></br>}где time - timestamp времени отправки уведомления data - полезная нагрузка уведомления

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

{<br></br> "time": 1611112517,<br></br> "data": {<br></br> "estate": {<br></br> "category": "flat",<br></br> "complex_id": null,<br></br> "contacts_agency_id": null,<br></br> "id": 44901,<br></br> "parent_id": 1233,<br></br> "previous_status": 0,<br></br> "previous_status_name": "Запись удалена",<br></br> "previous_status_custom": null,<br></br> "previous_status_custom_name": null,<br></br> "status": 100,<br></br> "status_name": "Сделка проведена",<br></br> "status_custom": null,<br></br> "status_custom_name": null<br></br> }<br></br> }<br></br>}### Поля в объекте 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.