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