Документація | Довідник API

Огляд функціоналу

Комерційна пропозиція — це професійна презентація об'єкта нерухомості, яку ви можете надіслати потенційному наймачу електронною поштою. Отримувач отримує посилання на сторінку з детальною інформацією про об'єкт, фотографіями, характеристиками та формою зворотного зв'язку.

Ключові можливості

Повна інформація про об'єкт нерухомості
Фотогалерея
Характеристики та параметри об'єкта
Перелік майна наймодавця
Форма зворотного зв'язку для отримувача
Відстеження переглядів та відповідей
Підтримка 4 мов (UK, EN, RU, PL)

Права доступу

Надсилати комерційні пропозиції можуть тільки власники об'єкта та їх представники.

Роль	Надсилання	Перегляд списку	Видалення
Наймодавець	Так	Так	Так
Представник наймодавця	Так	Так	Так
Наймач	Ні	Ні	Ні

Як надіслати пропозицію

1

Відкрийте об'єкт

Перейдіть на сторінку об'єкта нерухомості, для якого хочете створити комерційну пропозицію.

2

Натисніть кнопку відправки

На сторінці об'єкта знайдіть кнопку з іконкою конверта (📨) або виберіть пункт "Комерційна пропозиція" в меню дій.

3

Заповніть форму

Введіть email та ім'я отримувача, виберіть мову та валюту відображення. За бажанням додайте супровідне повідомлення.

4

Виберіть термін дії

Вкажіть, скільки днів пропозиція буде активною: 7, 14, 30 або 60 днів. Після закінчення терміну посилання стане недоступним.

5

Надішліть пропозицію

Натисніть кнопку "Надіслати". Отримувач отримає лист з посиланням на сторінку пропозиції.

Поля форми

Поле	Обов'язкове	Опис
Email отримувача	Так	Email адреса, на яку буде надіслано лист з пропозицією
Ім'я отримувача	Так	Ім'я отримувача для персоналізації листа
Валюта відображення	Ні	Валюта для відображення цін та вартостей на сторінці пропозиції
Супровідне повідомлення	Ні	Персональне повідомлення від вас, яке буде показано в листі та на сторінці пропозиції
Мова документа	Так	Мова інтерфейсу для листа та сторінки пропозиції
Посилання дійсне (днів)	Так	Кількість днів, протягом яких посилання буде активним (7, 14, 30 або 60 днів)

Що включено в пропозицію

Сторінка комерційної пропозиції автоматично включає всю публічну інформацію про об'єкт:

Інформація про об'єкт

Назва, адреса, тип об'єкта

Фото

Фотогалерея об'єкта, до 8 фото

Характеристики

Площа, поверх, кількість кімнат та інші параметри

Інфраструктура

Відстані до метро, магазинів, шкіл та інших точок — у хвилинах пішки

Умови оренди

Сума та період оренди, вказані вами під час відправлення пропозиції

Майно

Меблі та обладнання наймодавця

Статуси пропозицій

Система автоматично відстежує стан кожної пропозиції:

Надіслано

Лист надіслано, отримувач ще не відкрив посилання

Переглянуто

Отримувач переглянув сторінку пропозиції

Отримано відповідь

Отримувач залишив відповідь через форму

Термін минув

Термін дії пропозиції закінчився

Що бачить отримувач

Отримувач комерційної пропозиції проходить наступні кроки:

1

Отримання листа

Отримувач отримує професійний лист з описом пропозиції, вашим супровідним повідомленням та кнопкою для перегляду деталей.

2

Перегляд пропозиції

Перейшовши за посиланням, отримувач бачить красиву сторінку з усією інформацією про об'єкт, галереєю фото та характеристиками.

3

Відповідь

Якщо отримувач зацікавлений, він може залишити повідомлення та контактний телефон через форму зворотного зв'язку.

Форма зворотного зв'язку

Коли отримувач залишає відповідь, ви отримуєте email-повідомлення з його контактами та повідомленням. Статус пропозиції змінюється на "Отримано відповідь".

Конфіденційність

Важливо

Кожен лист містить застереження про конфіденційність інформації. Отримувач попереджається, що передача даних про об'єкт третім особам заборонена без письмової згоди.

Перегляд результатів

Список усіх надісланих пропозицій доступний у меню об'єкта. Для кожної пропозиції відображається:

Колонка	Опис
Отримувач	Ім'я та email отримувача пропозиції
Відправлено	Дата та час надсилання пропозиції
Статус	Поточний статус пропозиції (надіслано, переглянуто, відповідь, прострочено)
Перегляди	Кількість переглядів сторінки пропозиції
Відповідь	Текст відповіді та контактний телефон (якщо отримувач відповів)

REST API

Комерційні пропозиції також доступні через REST API для інтеграції з іншими системами.

Примітка рівня обслуговування

Ендпоінти API

GET    /api/v1/properties/{id}/proposals           # Список пропозицій
POST   /api/v1/properties/{id}/proposals           # Створити та надіслати
GET    /api/v1/properties/{id}/proposals/{pid}     # Деталі пропозиції
DELETE /api/v1/properties/{id}/proposals/{pid}     # Видалити пропозицію
POST   /api/v1/properties/{id}/proposals/{pid}/resend # Повторно надіслати

Приклад запиту

Приклад тіла запиту (POST)

{
  "recipient_email": "[email protected]",
  "recipient_name": "John Doe",
  "locale": "uk",
  "currency_id": 1,
  "cover_message": "Personal message for the recipient",
  "expires_in_days": 14
}

Повна документація API доступна в Swagger UI

Відкрити документацію API

Комерційні пропозиції