Як працює Budvid

Що таке Budvid

Онлайн-сервіс, який робить із плану квартири чи будинку 3D-презентацію: покупець відкриває її за посиланням з телефона. В агенції — каталог усіх об’єктів під своїм брендом, у забудовника — шахматка на 3D-будинку. Нічого не встановлюється: кабінет і презентації працюють у браузері, співробітники входять через свій Telegram, без паролів.

Шлях від плану до заявки

1. БазаІмпорт фіда DIM.RIA або об’єкт вручну
2. 3DПлан із PDF, фото чи DXF — 3D за кілька хвилин
3. ПублікаціяЗгода власника, посилання, каталог
4. ПокупецьДивиться з телефона й залишає заявку
5. ЗаявкаКабінет, Telegram агента, ваша CRM

Як почати

Реалістичний план для агенції на 50–300 об’єктів. Перші об’єкти можемо зібрати за вас — послуга «під ключ», ціна на сторінці тарифів.

Тест-драйв — щоб спробувати Budvid: «Тест-драйв» — на одному об’єкті, «Тест-драйв ШІ» — на кількох і з більшою кількістю ШІ-дій. На тест-драйвах немає API, галереї фото й закритих показів, вебхук у CRM — лише один і лише на «Тест-драйв ШІ», а команда — до 2 людей. Повне впровадження за цим планом робиться на тарифі.

Перші кроки до заявок

Картка над вкладками кабінету веде до першої заявки за п’ять кроків: «Тест-драйв або тариф» → «Перший об’єкт» → «Каталог агенції» → «Заявки в Telegram» → «Перша заявка». Бренд каталогу — назву, телефон, сайт, логотип і колір — заповнюєте у формі «Каталог об’єктів»: кнопка «Налаштувати» на кроці «Каталог агенції».

Що підготувати заздалегідь

• Особистий Telegram у кожного співробітника, який працюватиме в кабінеті.
• Адресу XML-фіда, який ваша CRM віддає DIM.RIA, або сам XML-файл.
• Плани об’єктів: PDF, фото чи скан техпаспорта, DXF. DWG збережіть як DXF.
• Логотип (PNG, JPEG або WebP), фірмовий колір, телефон і сайт агенції.
• Для CRM — публічну https-адресу, яка приймає вебхук.

Є разове налаштування: ваші об’єкти з планів — 3D-презентації, плани й каталог агенції — робимо ми. Ціна — на сторінці тарифів.

Вхід, ролі й права

Вхід

• Через Telegram. Пароль у Budvid не вводиться й не зберігається: особу підтверджує Telegram.
• Запасний вхід — ключем API, на тарифах з API. Ключ має права власника й обходить Telegram, тож зберігайте його як пароль адміністратора. Змінювати дані ключем можна, лише поки діє тариф з API; інакше ключ тільки читає — і ще дає оплатити тариф, відкликати ключі й прив’язати Telegram.
• Окремої двофакторної автентифікації в Budvid немає: вхід захищають налаштування Telegram співробітника. Тому кожен, хто працює в кабінеті, має ввімкнути в Telegram хмарний пароль (двоетапну перевірку).

Дві ролі: власник і менеджер

Роль у всіх менеджерів одна: обмежити менеджера лише його об’єктами в поточній версії не можна.

Команда

• Запрошення: вкладка «Команда» → «Запросити менеджера». Посилання живе 7 днів і спрацьовує один раз. Створити його можна на діючому тарифі, коли в команді є вільне місце. Розмір команди рахується разом із власником: на «Агенція 30» — до 5 людей, на «Агенція 100» — до 10, на «Агенція 300» — до 30.
• Telegram-акаунт, у якого вже є свій кабінет, у чужу команду не ввійде. Тож менеджер не реєструється сам — він просто відкриває посилання-запрошення.
• Відключення: кнопка «Відключити» навпроти співробітника. Вхід і всі його сесії закриваються одразу, особистий чат заявок вимикається, його об’єкти переходять на «Офіс — усі заявки», а персональні посилання закритих показів, які він видав у кабінеті, відкликаються. Посилання без позначки «Хто видав» (видані ключем API чи раніше) працюють і далі — перевірте їх і відкличте. І приберіть його з робочої групи в Telegram.
• Зміна власника: на тарифі з API — «Тариф» → «Вхід»: спершу «Створити ключ» у блоці «Ключі API», потім «Відв’язати». Новий власник входить цим ключем і натискає «Прив’язати Telegram» зі свого Telegram. Сесії й особистий чат заявок старого власника закриваються, його об’єкти переходять на «Офіс — усі заявки». Ключі, створені раніше, кабінет позначає «до нинішнього власника» — відкличте їх: ключ має права власника. Без API — через підтримку на hello@budvid.com, з підтвердженням, що ви власник. Зробити власником чинного менеджера можна, спершу прибравши його з команди.

Перенесення бази

Фід DIM.RIA — уся база за один захід

Якщо ваша CRM уже вивантажує оголошення на DIM.RIA, той самий XML-фід завантажує їх у Budvid. Робить це власник кабінету: «Об’єкти» → «Імпорт бази з фіда» → посилання на фід або XML-файл → «Перевірити» (нічого не записується) → «Імпортувати».

Імпорт запускається вручну — розкладу автоматичної синхронізації поки немає. Імпорту з OLX, ЛУН та інших порталів немає.

Плани квартир і будинків

• Приймаємо JPG, PNG, WebP, PDF (зокрема багатосторінковий) і DXF — масштаб береться з файла. HEIC — там, де його відкриває браузер (Safari); інакше збережіть як JPG.
• DWG не приймається — збережіть креслення як DXF.
• Готова 3D-модель архітектора: .glb, .gltf або .obj із текстурами, до 20 МБ.

Шахматка — для новобудов

У кабінеті агенції ця вкладка називається «Ціна й статус», у забудовника — «Шахматка». Ціни й статуси не обов’язково вносити вручну:

• Файлом — «Імпорт з Excel чи CSV»: .xlsx або .csv (роздільник ;, , або Tab; UTF-8 чи Windows-1251; шапки на кшталт «№ кв.», «Площа, м²», «Вартість, $»). Паркінг і комори розпізнаються окремо. Імпорт оновлює квартири, які вже є в 3D, — нових не створює. Старий формат .xls не підтримується: збережіть як .xlsx або CSV.
• Google Таблицею — «Синхронізація з Google Таблицею»: аркуш, опублікований як CSV (Файл → Поділитися → Опублікувати в інтернеті), оновлюється щогодини або кнопкою. Опублікований аркуш доступний будь-кому за посиланням — пам’ятайте, що це ваш прайс.
• З CRM через API — див. Budvid і ваша CRM.

Об’єкт: від плану до публікації

Так менеджер веде одну квартиру на вторинці. Для будинку кроки ті самі, плюс ділянка й поповерхові плани.

1. Створіть об’єкт: «Об’єкти» → «Новий об’єкт» або відкрийте чернетку з імпорту. Тип — «Квартира» чи «Будинок»; далі угода, назва, адреса, поверх і ціна.
2. Завантажте план із техпаспорта — PDF, фото, скан чи DXF. ШІ читає план за кілька хвилин — ви звіряєте площі з експлікацією й за потреби правите вручну. Назви кімнат — як у документах. Кожне читання плану — одна ШІ-дія тарифу (на «Тест-драйв» — одна на весь тест-драйв).
3. Вкажіть поверх — «поверх 7 з 9»: квартира стає на свою висоту, з видом з вікна саме цього поверху.
4. Оточення й меблі. Навколо — будинки й дерева; де мапа застаріла, агент править сам: «Ще» → «Оточення». Меблі розставляються автоматично, їх можна переставити.
5. Заповніть «Про об’єкт»: ціна, поверх, кухня, балкон, стан, опалення; у будинку — ділянка, спальні, санвузли, гараж, басейн, комунікації. Покупцеві показується лише заповнене.
6. Оберіть, що показувати з адреси — «Показувати адресу»: «Точну адресу», «Лише вулицю» чи «Лише район». У нової квартири за замовчуванням «Лише вулицю», у нового будинку й імпортованого з фіда об’єкта — «Лише район». З «Лише район» будинки й дерева довкола не показуються — ні на мапі, ні у виді з вікна.
7. Додайте фото й панорами 360° — «Галерея»: до 30 фото й 10 панорам на об’єкт на тарифах агенцій. Фото з телефона стискаються в браузері, дані про місце зйомки видаляються. На фото, які ви завантажуєте з кабінету, за замовчуванням ставиться водяний знак агенції — вимикається в «Водяний знак на фото» у формі «Каталог об’єктів»; на панорами й фото з фіда — ні.
8. Підтвердьте згоду власника — «Маю згоду власника на показ цієї квартири» (для будинку — «Маю згоду власника на показ цього будинку»). Без неї вторинка не публікується; кабінет запам’ятовує, хто й коли це підтвердив.
9. Опублікуйте. Об’єкт з’являється в каталозі агенції, отримує посилання budvid.com/p/… і код для сайту («Ще» → «Код для сайту»). Сторінки вторинки закриті від пошукових систем — заради приватності власника.
10. Тексти оголошень: «Ще» → «✦ Опис для оголошення» — готові тексти для OLX і DIM.RIA, для Instagram і для сайту. Кожен запуск — одна ШІ-дія тарифу.

Будинок, створений майстром, за замовчуванням позначено як «Закритий показ — лише за персональним посиланням». У каталог він потрапить, коли ви знімете цю галочку.

Продано — в архів

Проданий об’єкт у кабінеті агенції — «Ще» → «В архів»: зникає з каталогу, звільняє місце в тарифі, його посилання перестає відкриватися й нові заявки не приймаються, а дані лишаються в кабінеті. Видалити об’єкт назавжди може лише власник — разом із заявками, статистикою й файлами. Видаляють з архіву: спершу кабінет пропонує зберегти заявки об’єкта в CSV, а якщо їх не вдалося прочитати — видалення зупиняється.

Що бачить покупець

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

• 3D-квартира з меблями — крутиться пальцем на телефоні; вид згори й автотур «▶ Тур».
• Вид з вікна з реального поверху й оточення будинку; сонце за часом доби.
• Поповерхові плани з площами; у будинку — окрема вкладка цоколя.
• «Варіанти ремонту» — та сама квартира в кількох стилях. Їх вмикає агент у «Про об’єкт».
• «Дизайн-проєкт квартири» — по кожній кімнаті: на порожню квартиру або «Оновити те, що є», з PDF-концепцією й списком покупок і перемикачем «Як є» ↔ «Після». Гроші рахуються лише за цінами, які вводить сам покупець або дизайнер.
• Фото й панорами 360° агенції.
• «Паспорт квартири» — 2 сторінки A4, які покупець зберігає як PDF через друк браузера.
• ШІ-помічник відповідає на запитання про квартиру простими словами — за даними об’єкта й мовою покупця, у межах місячної квоти тарифу.
• Форма заявки: ім’я, телефон, зручний час і спосіб зв’язку — дзвінок, Telegram чи Viber.

Каталог агенції

• Адреса — budvid.com/a/<ваша-назва>: 3–40 символів, латиниця, цифри, дефіс.
• Бренд: назва, телефон, сайт, адреса, логотип і колір акценту.
• Усі опубліковані об’єкти в одному місці: квартири, будинки, таунхауси, новобудови.
• Фільтри: тип, кімнати, ціна, площа; у будинків — ділянка. Картка каже прямо: «поверх 7 з 9», «Студія», площа як у документах.
• «Підберіть мені» — заявка без конкретного об’єкта: угода, бюджет і валюта, кімнати, район.
• Закриті об’єкти — анонімною карткою «Ціна за запитом», якщо це ввімкнути (див. закриті продажі).

Демо-каталог, який можна відкрити просто зараз: budvid.com/a/demo.

Закриті продажі (off-market)

Для дорогих об’єктів, які не публікуються відкрито. Є на тарифах «Агенція 30», «Агенція 100», «Агенція 300», «Девелопер» і «Преміум».

1. Увімкніть закритий показ: «Ще» → «Закритий показ» і позначте «Приховати об’єкт з каталогу й загальної адреси /p/ — лише за персональними посиланнями». Об’єкт зникає з каталогу, його звичайне посилання, фото й файли перестають відкриватися.
2. Видайте персональне посилання на ім’я конкретного покупця. Строк — 3, 7, 14 (за замовчуванням) чи 30 днів або без строку. До 200 посилань на об’єкт, відкликані теж рахуються. До посилання є короткий код — його можна продиктувати телефоном.
3. Покупець відкриває й підтверджує: «Персональний показ · отримувач: {ім’я}. Не пересилайте посилання.» Його ім’я стоїть водяним знаком поверх 3D і на кожній сторінці PDF — на будь-якому скриншоті видно, чий це показ.
4. Агент бачить, коли й скільки разів відкривали посилання, а біля кожного посилання — хто його видав. Відкриття кнопкою з кабінету не рахуються. Коли власник відключає співробітника, видані ним посилання відкликаються автоматично.
5. Відкликати посилання можна миттєво. Прострочене посилання показує кнопку «Попросити нове посилання» — це приходить агентові заявкою.

Що не витікає

• Адреса — лише район і місто: ні вулиці, ні точки на мапі, ні в PDF, ні в прев’ю посилання. Назву й опис об’єкта ми не знеособлюємо — не пишіть у них вулицю.
• Прев’ю посилання в месенджерах — просто «Budvid», без фото й опису; сторінка закрита від пошукових систем.
• Підтримка Budvid не може відкрити розділ закритих показів навіть із наданим доступом.

Анонімна картка в каталозі

За бажанням закритий об’єкт показується в каталозі без назви, адреси й фото: тип, район, площа (округлено), ділянка, кімнати, «Ціна за запитом» і кнопка «Запросити доступ». Покупець залишає ім’я й телефон, агент однією кнопкою видає йому персональне посилання — або не видає.

Заявки

Звідки приходять

Обов’язкові ім’я, телефон і галочка згоди на обробку даних — без неї заявку не буде прийнято. Друга галочка (за замовчуванням вимкнена) додає «бриф візиту»: що покупець дивився, що додав в обране, що питав у помічника, — щоб менеджер підготувався до розмови. Бриф приходить у Telegram і CRM; у вкладці «Заявки» і в CSV його немає.

Куди потрапляють

• Повідомлення в Telegram — українською, з кнопками «Відкрити об’єкт», «Поставити «Бронь»» (заявка на квартиру з шахматки) і «Видати посилання» (запит доступу).
• Кожен чат рахується в ліміт тарифу «Чати Telegram».
• Якщо тариф закінчився, заявки однаково доставляються — з нагадуванням про продовження.

Вивантаження й видалення

• «Експорт CSV» у вкладці «Заявки» — увесь список, а не лише показана сторінка: дата за київським часом, об’єкт, квартира, ім’я, телефон, коментар, мова, тип, зручний час і уточнення, спосіб зв’язку, угода, бюджет, валюта, кімнати, район. Файл відкривається в Excel подвійним кліком: роздільник — крапка з комою, кирилиця не ламається, телефон лишається текстом із «+». Якщо частину заявок завантажити не вдалося, кабінет скаже про це й запропонує зберегти лише показані — такий файл позначено «partial».
• JSON через API — GET /v1/leads з посторінковою видачею, на тарифах з API.
• Видалити заявку на прохання покупця може лише власник — кнопкою «Видалити» у рядку заявки у вкладці «Заявки» або через API. Копії в Telegram і CRM лишаються там.

Інтеграції

Повний опис вебхука й API з прикладами запитів і перевіркою підпису — на сторінці Budvid і ваша CRM. Тут — коротко, що де.

Заявки у вашу CRM

1. Кабінет → «Telegram і CRM» → «Свій бот, робоча група або CRM» → «HTTP (CRM)» → «Адреса (https)» → «Створити».
2. Збережіть секрет підпису — він показується один раз.
3. Кнопка «Тест» надсилає тестову подію; код відповіді вашого сервера видно у вкладці «Журнал відправок».

Готових модулів під конкретні CRM немає: вебхук універсальний — JSON із підписом HMAC у заголовку X-Budvid-Signature. Для Bitrix24, KeyCRM, Binotel чи своєї системи потрібен невеликий обробник або проміжний сервіс.

API

Що можна: передавати ціни й статуси новобудови з CRM у шахматку й забирати заявки в JSON. Приклади — на сторінці Budvid і ваша CRM.

Презентація на вашому сайті

Готовий код — у кабінеті: «Ще» → «Код для сайту» в опублікованого об’єкта (у закритих об’єктів його немає). Він має такий вигляд:

<iframe src="https://budvid.com/p/<slug>" width="100%" height="640" style="border:0;border-radius:12px" allow="fullscreen" loading="lazy" title="3D"></iframe>

• Заявки з вбудованої презентації йдуть тим самим шляхом, що й з budvid.com.
• Вбудовувати можна лише презентації; кабінет у чужому iframe не відкривається.

Події для Google Tag Manager

Вбудована презентація повідомляє сторінку вашого сайту про дії покупця — без імені й телефону. Події: view (перегляд), unit_open (відкрив квартиру), fav_add (додав в обране), compare_open (порівняння), pdf, share, lead_sent (надіслав заявку), reno_style (обрав стиль ремонту). Готовий код — у кабінеті там само, «Ще» → «Код для сайту», і для агенцій, і для забудовників. На сторінці з презентацією він передає їх у GTM як budvid_<подія> з полями budvid_unit, budvid_project, budvid_style:

<script>
window.addEventListener('message', function (e) {
  if (e.origin !== 'https://budvid.com' || !e.data || e.data.source !== 'budvid') return;
  window.dataLayer = window.dataLayer || [];
  window.dataLayer.push({ event: 'budvid_' + e.data.event, budvid_unit: e.data.unit, budvid_project: e.data.project, budvid_style: e.data.style || null });
});
</script>

Як використовувати ці події, визначають правила згоди на cookie вашого сайту.

Дані й безпека

Ролі за законом про персональні дані

Агенція — володілець персональних даних покупців, Budvid — розпорядник: обробляє їх за дорученням агенції (розділ 7 публічного договору). Згода покупця фіксується на формі разом із версією тексту.

Зберігання й захист

• Сервери й база — у Східній Європі; постачальників інфраструктури названо в Політиці конфіденційності. Файли — у закритому сховищі без публічної адреси, їх віддає сервер Budvid; файли закритих показів — лише після перевірки прав.
• Завантажені файли перевіряються за вмістом; GPS-мітки з фото видаляються.
• IP-адреси в базі не зберігаються — лише їхній хеш. Сесії, ключі API й запрошення теж зберігаються як хеші.
• Заголовки безпеки: CSP, заборона підміни типу файлу, політика referrer, що не передає іншим сайтам повну адресу сторінки; кабінет не можна вбудувати в чужий сайт.
• Про інцидент безпеки повідомляємо клієнта протягом 72 годин.

Доступ Budvid до вашого кабінету

• Без вашої згоди підтримка бачить службову картку: тариф, ліміти, список об’єктів, оплати, час входів, помилки. Покупців — лише кількістю.
• Увійти в кабінет підтримка може лише за згодою власника — «Відкрити на 24 години» або «Відкрити на 72 години» у вкладці «Команда»; закрити доступ можна будь-коли. Менеджер такого доступу дати не може.
• Кожна дія підтримки записується в журнал до виконання; журнал власник бачить у кабінеті, він зберігається рік.
• Навіть із доступом підтримка не може платити чи змінювати тариф, нічого не може видалити, не створює й не змінює ключі API, вебхуки й чати Telegram, команду, контакти й бренд, не витрачає ваші ШІ-дії і не бачить закритих показів. Покупці видні замасковано: перша літера імені й дві останні цифри телефону.

Строки зберігання

Видалити кабінет повністю — листом на hello@budvid.com.

Аналітика без трекерів

Статистика відвідувань — без cookie й без IP-адрес; сторінка зберігає в браузері лише випадковий ключ пристрою. Рекламних трекерів (Google Analytics, Meta Pixel тощо) на сторінках немає. Сторінки вторинки, закриті покази й чернетки закриті від пошукових систем.

Детально — у Політиці конфіденційності й публічному договорі.

Тарифи

Ціни й ліміти — на сторінці тарифів. Тут — як вони влаштовані.

• Агенціям — «Агенція 30», «Агенція 100», «Агенція 300»: різняться кількістю об’єктів, розміром команди, чатами, вебхуками й ШІ-діями. API — з «Агенція 100».
• Забудовникам — «Будинок», «ЖК», «Девелопер», «Преміум». Закриті покази — на «Девелопер» і «Преміум».
• Тариф не обмежує кількість заявок (є лише захист від спаму). Тест-драйв — 7 днів, один раз на клієнта: «Тест-драйв» — на один об’єкт, «Тест-драйв ШІ» — на кілька об’єктів і з більшою кількістю ШІ-дій.
• Оплата карткою (Visa, Mastercard, Apple Pay, Google Pay) у гривнях — доступ одразу. За рахунком — юрособі чи ФОП; доступ — не пізніше робочого дня після зарахування.
• Автопродовження немає: кожен період оплачується окремо. Договір — публічна оферта, акцепт оплатою; акт — на запит поштою.
• Якщо тариф закінчився, презентації працюють і заявки доставляються; редагування, нові об’єкти, ціни й статуси, запрошення й ШІ блокуються до продовження, ШІ-помічник покупця вимикається, а ключі API тільки читають.
• Повернення — протягом 14 днів після першої оплати; умови й винятки — у публічному договорі.

Обмеження поточної версії

Цього в Budvid зараз немає. Пишемо заздалегідь, щоб ви планували впровадження на реальних можливостях. Якщо щось критично — напишіть: прохання перших агенцій ідуть у роботу першими, строк називаємо чесно.

Часті запитання