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.
Last updated