Pomoc
Jak działa Budvid
Wszystko, co agencja nieruchomości lub deweloper powinni wiedzieć: od czego zacząć, jak przenieść swoje oferty, przeprowadzić nieruchomość od rzutu do publikacji, odbierać zapytania kupujących i podłączyć CRM. Ze zrzutami ekranu panelu — i uczciwie o tym, czego obecna wersja jeszcze nie ma.
Zrzuty ekranu pokazują panel w języku ukraińskim; jest on dostępny także po polsku. Nazwy przycisków podajemy w tej pomocy tak, jak brzmią w polskiej wersji panelu.
Spis treści
Czym jest Budvid
Usługa online, która z rzutu mieszkania lub domu tworzy prezentację 3D — kupujący otwiera ją z linku na telefonie. Agencja dostaje katalog wszystkich swoich ofert pod własną marką, deweloper — tabelę mieszkań na budynku w 3D. Niczego nie trzeba instalować: panel i prezentacje działają w przeglądarce, a pracownicy logują się przez własny Telegram — bez haseł.
| Część | Adres | Kto korzysta |
|---|---|---|
| Panel | budvid.com/cabinet | Właściciel i menedżerowie: nieruchomości, ceny i statusy, zapytania, zespół, integracje, płatności |
| Prezentacja nieruchomości | budvid.com/p/… | Kupujący: 3D, rzuty, zdjęcia, widok z okna, formularz zapytania |
| Katalog agencji | budvid.com/a/… | Kupujący: wszystkie opublikowane oferty agencji, z filtrami |
| Pokaz prywatny | budvid.com/s/… | Jeden konkretny kupujący, przez osobisty link |
Od rzutu do zapytania
- OfertyImport feedu DIM.RIA lub nieruchomość dodana ręcznie
- 3DRzut z PDF, zdjęcia lub DXF — 3D w kilka minut
- PublikacjaZgoda właściciela, link, katalog
- KupującyOgląda na telefonie i wysyła zapytanie
- ZapytaniePanel, Telegram agenta, Państwa CRM

Jak zacząć
Realistyczny plan dla agencji z 50–300 ofertami. Pierwsze nieruchomości możemy przygotować za Państwa — usługa „pod klucz”, cena w cenniku.
| Kiedy | Co się dzieje | Kto |
|---|---|---|
| Dzień 0 | Wybór pakietu. Można zacząć od okresu próbnego na 7 dni: „Okres próbny” — na jednej nieruchomości, „Okres próbny AI” — na kilku. Przy płatności kartą dostęp jest od razu; przy przelewie na fakturę — najpóźniej następnego dnia roboczego po zaksięgowaniu środków. | Dyrektor |
| Dzień 1 | Właściciel loguje się przez Telegram i przechodzi przez kartę „Pierwsze kroki do zapytań”. | Właściciel panelu |
| Dzień 1 | Import ofert z feedu XML DIM.RIA (jak to działa). Trafiają do panelu jako szkice i nie zajmują miejsca w pakiecie, dopóki nie zostaną opublikowane. | Właściciel + IT |
| Dni 1–3 | Pierwsze 3–5 nieruchomości w 3D: rzut z paszportu technicznego → sprawdzenie powierzchni → piętro, meble, otoczenie → publikacja. | Menedżer lub my (usługa „pod klucz”) |
| Dzień 2 | Zespół: zaproszenia dla menedżerów. Każdy loguje się własnym Telegramem i podłącza własny czat na zapytania. | Właściciel |
| Dni 2–4 | Integracje: webhook do CRM, prezentacje na stronie agencji, a w razie potrzeby grupa robocza zespołu przez własnego bota agencji. | IT |
| Tydzień 1 | Szkolenie menedżerów, pierwsze pokazy prywatne, linki dla kupujących. | Kierownik sprzedaży |
| Tydzień 2+ | Pozostałe oferty przechodzą do 3D w miarę pracy nad nimi; raport z zapytań i wyświetleń. | Menedżerowie |
Okres próbny służy do wypróbowania Budvid: „Okres próbny” — na jednej nieruchomości, „Okres próbny AI” — na kilku i z większą liczbą działań AI. W okresach próbnych nie ma API, galerii zdjęć ani pokazów prywatnych; webhook do CRM — tylko jeden i tylko w „Okres próbny AI”; zespół jest ograniczony do 2 osób. Pełne wdrożenie opisane powyżej odbywa się w płatnym pakiecie.
„Pierwsze kroki do zapytań”
Karta nad zakładkami panelu prowadzi do pierwszego zapytania w pięciu krokach: „Jazda próbna lub plan” → „Pierwsza nieruchomość” → „Katalog agencji” → „Zapytania w Telegramie” → „Pierwsze zapytanie”. Markę katalogu — nazwę, telefon, stronę, logo i kolor — uzupełnia się w formularzu „Katalog”: przycisk „Skonfiguruj” w kroku „Katalog agencji”.

Co przygotować
- Prywatne konto Telegram dla każdej osoby, która będzie pracować w panelu.
- Adres feedu XML, który Państwa CRM wysyła do DIM.RIA, albo sam plik XML.
- Rzuty: PDF, zdjęcie lub skan paszportu technicznego (ukraińskiego dokumentu inwentaryzacyjnego z rzutem i zestawieniem pomieszczeń) albo DXF. Pliki DWG należy zapisać jako DXF.
- Logo (PNG, JPEG lub WebP), kolor firmowy, telefon i strona internetowa agencji.
- Dla CRM: publiczny adres https, który przyjmuje webhook.
Jest też jednorazowa konfiguracja: na podstawie rzutów przygotujemy Państwa nieruchomości — prezentacje 3D, rzuty i katalog agencji. Jej cena jest w cenniku.
Logowanie, role i uprawnienia
Logowanie
- Przez Telegram. W Budvid nie wpisuje się ani nie przechowuje żadnego hasła: tożsamość potwierdza Telegram.
- Zapasowy sposób logowania to klucz API, w pakietach z API. Klucz ma uprawnienia właściciela i omija Telegram, dlatego należy go chronić jak hasło administratora. Kluczem można zmieniać dane tylko wtedy, gdy obowiązuje pakiet z API; w przeciwnym razie klucz tylko odczytuje — i nadal pozwala opłacić pakiet, unieważnić klucze i powiązać Telegram.
- Budvid nie ma własnego uwierzytelniania dwuskładnikowego: logowanie chronią ustawienia Telegrama każdej osoby. Dlatego każdy, kto pracuje w panelu, powinien włączyć w Telegramie hasło w chmurze (weryfikację dwuetapową).
Dwie role: właściciel i menedżer
| Działanie | Właściciel | Menedżer |
|---|---|---|
| Tworzenie nieruchomości; praca z 3D, zdjęciami, cenami, statusami, archiwum | tak | tak |
| Wgląd we wszystkie zapytania panelu i ich eksport | tak | tak |
| Pokazy prywatne: wydanie, przedłużenie, odwołanie linku | tak | tak |
| Potwierdzenie zgody właściciela na publikację | tak | tak |
| Własny Telegram na zapytania o własne nieruchomości, własna karta agenta | tak | tak |
| Usuwanie nieruchomości i zapytań | tak | nie |
| Import feedu DIM.RIA | tak | nie |
| Kontakty nieruchomości (telefon, strona) | tak | nie |
| Przekazanie nieruchomości innemu pracownikowi | tak | tylko przejęcie dla siebie |
| Zespół, zaproszenia, odłączanie osób | tak | nie |
| Pakiet i płatności, klucze API, webhooki i czaty, dziennik wysyłek | tak | nie |
| Profil katalogu, dostęp wsparcia Budvid | tak | nie |
Wszyscy menedżerowie mają tę samą rolę: w obecnej wersji nie można ograniczyć menedżera tylko do jego nieruchomości.
Zespół
- Zaproszenia: zakładka „Zespół” → „Zaproś menedżera”. Link jest ważny 7 dni i działa jednorazowo. Można go utworzyć przy aktywnym pakiecie, gdy w zespole jest wolne miejsce. Do zespołu wlicza się też właściciel: do 5 osób w pakiecie „Agencja 30”, 10 w „Agencja 100”, 30 w „Agencja 300”.
- Konto Telegram, które ma już własny panel, nie może dołączyć do cudzego zespołu. Dlatego menedżer nie rejestruje się sam — po prostu otwiera link z zaproszeniem.
- Odłączenie osoby: przycisk „Odłącz” obok niej. Jej logowanie i wszystkie sesje kończą się od razu, osobisty czat na zapytania zostaje wyłączony, jej nieruchomości przechodzą na „Biuro — wszystkie zapytania”, a osobiste linki do pokazów prywatnych, które wydała w panelu, zostają odwołane. Linki bez dopisku „Kto wydał” (wydane kluczem API lub wcześniej) nadal działają — należy je sprawdzić i odwołać. I usunąć tę osobę z grupy roboczej zespołu w Telegramie.
- Zmiana właściciela: w pakiecie z API — „Pakiet” → „Logowanie”: najpierw „Utwórz klucz” w bloku „Klucze API”, potem „Odłącz”. Nowy właściciel loguje się tym kluczem i naciska „Połącz Telegram” ze swojego Telegrama. Sesje i osobisty czat na zapytania dotychczasowego właściciela zostają zamknięte, a jego nieruchomości przechodzą na „Biuro — wszystkie zapytania”. Klucze utworzone wcześniej panel oznacza jako „sprzed obecnego właściciela” — należy je unieważnić: klucz ma uprawnienia właściciela. Bez API — przez wsparcie pod adresem hello@budvid.com, z potwierdzeniem, że są Państwo właścicielem. Aby właścicielem został obecny menedżer, należy najpierw usunąć go z zespołu.

Przeniesienie ofert
Feed DIM.RIA — wszystkie oferty za jednym razem
Jeśli Państwa CRM już wysyła oferty do DIM.RIA, ten sam feed XML wczyta je do Budvid. Robi to właściciel panelu: „Nieruchomości” → „Import bazy z feedu” → adres feedu lub plik XML → „Sprawdź” (nic nie zostaje zapisane) → „Importuj”.

| Co | Jak to działa |
|---|---|
| Format | Feed XML DIM.RIA w kodowaniu UTF-8. Nieruchomość jest rozpoznawana po local_realty_id. |
| Rozmiar | Feed z linku lub jako plik — do 20 MB. Do 3000 ofert naraz i 30 zdjęć na ofertę; do 2000 szkiców w panelu; do 1000 zdjęć z feedu na dobę. To, co uniemożliwiło odczytanie części feedu (oferty bez local_realty_id, powtórzenia, ponad 3000), panel wymienia po sprawdzeniu. |
| Co pobieramy | Mieszkania i domy (domy jednorodzinne, szeregowce, bliźniaki, domki letniskowe) na sprzedaż i wynajem długoterminowy: rodzaj transakcji, cenę i walutę, powierzchnie, piętro i liczbę pięter, typ budynku, ściany, rok budowy, ogrzewanie, stan, łazienkę, balkon; dla domów — działkę, garaż, saunę, media, ochronę, schron. A także opis. |
| Tytuł | Nie jest pobierany z feedu — powstaje z szablonu, np. „Mieszkanie 2-pokojowe, 54,5 m² · dzielnica”. Agent może go zmienić. |
| Co pomijamy | Wynajem na doby, oferty bez ceny, pojedyncze pokoje, nieruchomości komercyjne, działki. |
| Czego celowo nie pobieramy | Współrzędnych, numeru katastralnego, dokumentów i paszportu technicznego, kontaktów użytkowników CRM. |
| Adres | Jest zapisywany w profilu nieruchomości; domyślnie kupujący widzi tylko dzielnicę. Ulicę lub dokładny adres można odsłonić w „O nieruchomości” → „Pokazuj adres”. |
| Zdjęcia | JPEG i WebP z bezpośrednich linków, 800–4096 px, do 2 MB; zdjęcia PNG z feedu nie są przenoszone — sprawdzenie pokaże, ile ich jest. Trafiają do galerii w osobnym kroku — przyciskiem „Pobierz zdjęcia z feedu”, dopóki okno importu jest otwarte — bez znaku wodnego. W okresie próbnym nie ma galerii, więc zdjęcia z feedu nie zostaną pobrane. |
| Agent | Wszystkie szkice z feedu mają początkowo jako agenta „Biuro — wszystkie zapytania”; konkretnego agenta przypisuje się w panelu. |
| Ponowny import | Szkice są aktualizowane: tytuł pozostaje taki, jak w panelu, a reszta profilu szkicu — dane, adres, zdjęcia — jest pobierana z feedu na nowo. Opublikowane nieruchomości pozostają nietknięte. Oferty, które zniknęły z feedu, są jedynie wskazywane na liście, nigdy nie są usuwane. |
| Pakiet | Szkice nie zajmują miejsca. Liczą się tylko opublikowane nieruchomości spoza archiwum. |
Import uruchamia się ręcznie — automatycznej synchronizacji według harmonogramu jeszcze nie ma. Nie ma importu z OLX, LUN ani innych portali.
Rzuty mieszkań i domów
- Przyjmujemy JPG, PNG, WebP, PDF (także wielostronicowy) i DXF — skala jest pobierana z pliku. HEIC tam, gdzie otwiera go przeglądarka (Safari); w przeciwnym razie należy zapisać go jako JPG.
- DWG nie jest przyjmowany — rysunek należy zapisać jako DXF.
- Gotowy model 3D od architekta: .glb, .gltf lub .obj z teksturami, do 20 MB.
Tabela mieszkań — dla rynku pierwotnego
W panelu agencji ta zakładka nazywa się „Cena i status”, w panelu dewelopera — „Tabela mieszkań”. Cen i statusów nie trzeba wpisywać ręcznie:
- Z pliku — „Wczytaj z Excela lub CSV”: .xlsx lub .csv (separator
;,,lub tabulator; UTF-8 lub Windows-1251; nagłówki takie jak „№ кв.”, „Площа, м²”, „Вартість, $”). Miejsca postojowe i komórki lokatorskie są rozpoznawane osobno. Import aktualizuje mieszkania, które już istnieją w 3D — nie tworzy nowych. Stary format .xls nie jest obsługiwany: należy zapisać plik jako .xlsx lub CSV. - Z Arkusza Google — „Synchronizacja z Arkuszem Google”: arkusz opublikowany jako CSV (Plik → Udostępnij → Opublikuj w internecie), aktualizowany co godzinę lub przyciskiem. Opublikowany arkusz jest dostępny dla każdego, kto ma link — proszę pamiętać, że to Państwa cennik.
- Z CRM przez API — zob. Budvid i Państwa CRM.

Nieruchomość: od rzutu do publikacji
Tak menedżer prowadzi w Budvid jedno mieszkanie z rynku wtórnego. W przypadku domu kroki są takie same, a dochodzą działka i rzuty poszczególnych kondygnacji.

- Utworzenie nieruchomości: „Nieruchomości” → „Nowa nieruchomość” lub otwarcie szkicu z importu. Typ: „Mieszkanie” albo „Dom”; dalej rodzaj transakcji, tytuł, adres, piętro i cena.
- Wgranie rzutu z paszportu technicznego — PDF, zdjęcie, skan lub DXF. AI odczytuje rzut w kilka minut — Państwo porównują powierzchnie z zestawieniem pomieszczeń i w razie potrzeby poprawiają je ręcznie. Nazwy pomieszczeń — jak w dokumentach. Każde odczytanie rzutu to jedno działanie AI z pakietu (w pakiecie „Okres próbny” — jedno na cały okres próbny).
- Wskazanie piętra — „piętro 7 z 9”: mieszkanie stoi na swojej rzeczywistej wysokości, z widokiem z okna dokładnie z tego piętra.
- Otoczenie i meble. Wokół — budynki i drzewa; tam, gdzie mapa jest nieaktualna, agent poprawia ją sam: „Więcej” → „Otoczenie”. Meble są rozstawiane automatycznie i można je przesuwać.
- Uzupełnienie „O nieruchomości”: cena, piętro, kuchnia, balkon, stan, ogrzewanie; dla domu — działka, sypialnie, łazienki, garaż, basen, media. Kupujący widzi tylko to, co zostało uzupełnione.
- Wybór, jaką część adresu pokazać — „Pokazuj adres”: „Dokładny adres”, „Tylko ulica” lub „Tylko dzielnica”. Nowe mieszkanie ma domyślnie „Tylko ulica”; nowy dom i nieruchomość zaimportowana z feedu — „Tylko dzielnica”. Przy opcji „Tylko dzielnica” budynki i drzewa wokół nie są pokazywane — ani na mapie, ani w widoku z okna.
- Zdjęcia i panoramy 360° — „Galeria”: do 30 zdjęć i 10 panoram na nieruchomość w pakietach dla agencji. Zdjęcia z telefonu są kompresowane w przeglądarce, a dane o miejscu ich wykonania — usuwane. Na zdjęcia wgrywane z panelu domyślnie nakładany jest znak wodny agencji — wyłącza się go w „Znak wodny na zdjęciach” w formularzu „Katalog”; na panoramy i zdjęcia z feedu — nie.
- Potwierdzenie zgody właściciela — „Mam zgodę właściciela na pokazanie tego mieszkania” (dla domu — „Mam zgodę właściciela na pokazanie tego domu”). Bez niej nieruchomość z rynku wtórnego nie zostanie opublikowana; panel zapisuje, kto i kiedy ją potwierdził.
- Publikacja. Nieruchomość pojawia się w katalogu agencji i dostaje link
budvid.com/p/…oraz kod na stronę internetową („Więcej” → „Kod do osadzenia”). Strony ofert z rynku wtórnego są zamknięte dla wyszukiwarek — ze względu na prywatność właściciela. - Teksty ogłoszeń: „Więcej” → „✦ Tekst ogłoszenia” — gotowe teksty na OLX i DIM.RIA, na Instagram i na stronę agencji. Każde uruchomienie to jedno działanie AI z pakietu.


Dom utworzony w kreatorze jest domyślnie oznaczony jako „Pokaz zamknięty — tylko przez osobisty link”. Pojawi się w katalogu po odznaczeniu tego pola.


Sprzedane — do archiwum
W panelu agencji sprzedaną nieruchomość przenosi się przez „Więcej” → „Do archiwum”: znika z katalogu, zwalnia miejsce w pakiecie, jej link przestaje się otwierać i nowe zapytania nie są przyjmowane, a dane zostają w panelu. Trwale usunąć nieruchomość — razem z jej zapytaniami, statystykami i plikami — może tylko właściciel. Usuwa się ją z archiwum: panel najpierw proponuje zapisać zapytania tej nieruchomości do CSV, a jeśli nie udało się ich odczytać — usuwanie zostaje przerwane.
Co widzi kupujący
Kupujący dostaje link w komunikatorze albo znajduje nieruchomość w katalogu. Niczego nie instaluje i nie musi się rejestrować.


- Mieszkanie w 3D z meblami — na telefonie obraca się je palcem; widok z góry i automatyczny „▶ Spacer”.
- Widok z okna z rzeczywistego piętra i otoczenie budynku; słońce zależnie od pory dnia.
- Rzuty kondygnacji z powierzchniami; dom ma osobną zakładkę piwnicy.
- „Warianty remontu” — to samo mieszkanie w kilku stylach. Agent włącza je w „O nieruchomości”.
- „Projekt wnętrza mieszkania” — pokój po pokoju: dla pustego mieszkania lub w wariancie „Odśwież to, co jest”, z koncepcją w PDF, listą zakupów i przełącznikiem „Bez zmian” ↔ „Po”. Kwoty są liczone wyłącznie na podstawie cen wpisanych przez kupującego lub projektanta.
- Zdjęcia i panoramy 360° od agencji.
- „Karta mieszkania” — 2 strony A4, które kupujący zapisuje jako PDF przez funkcję drukowania w przeglądarce.
- Asystent AI odpowiada na pytania o mieszkanie prostym językiem — na podstawie danych nieruchomości i w języku kupującego, w ramach miesięcznego limitu pakietu.
- Formularz zapytania: imię, telefon, dogodny termin i sposób kontaktu — telefon, Telegram lub Viber.






Katalog agencji
- Adres ma postać
budvid.com/a/<nazwa-agencji>: 3–40 znaków, litery łacińskie, cyfry, myślniki. - Marka: nazwa, telefon, strona internetowa, adres, logo i kolor akcentu.
- Wszystkie opublikowane nieruchomości w jednym miejscu: mieszkania, domy, szeregowce, nowe inwestycje.
- Filtry: typ, pokoje, cena, powierzchnia; dla domów — działka. Karta mówi wprost: „piętro 7 z 9”, „Kawalerka”, powierzchnia jak w dokumentach.
- „Dobierzcie mi coś” — zapytanie bez konkretnej nieruchomości: rodzaj transakcji, budżet i waluta, pokoje, dzielnica.
- Nieruchomości prywatne — jako anonimowa karta „Cena na zapytanie”, jeśli włączą Państwo tę opcję (zob. sprzedaż prywatna).
Katalog demonstracyjny, który można otworzyć od razu: budvid.com/a/demo.


Sprzedaż prywatna (off-market)
Dla drogich nieruchomości, które nie są publikowane otwarcie. Dostępna w pakietach „Agencja 30”, „Agencja 100”, „Agencja 300”, „Deweloper” i „Premium”.
- Włączenie pokazu prywatnego: „Więcej” → „Pokaz prywatny” i zaznaczenie „Ukryj obiekt w katalogu i pod publicznym adresem /p/ — tylko przez osobiste linki”. Nieruchomość znika z katalogu, a jej zwykły link, zdjęcia i pliki przestają się otwierać.
- Wydanie osobistego linku dla konkretnego kupującego, z jego imieniem. Link jest ważny 3, 7, 14 (domyślnie) lub 30 dni albo bezterminowo. Do 200 linków na nieruchomość, wliczając odwołane. Każdy link ma krótki kod, który można podyktować przez telefon.
- Kupujący otwiera link i potwierdza: „Pokaz osobisty · odbiorca: {imię}. Nie przekazuj linku dalej.” Jego imię widnieje jako znak wodny na obrazie 3D i na każdej stronie PDF — każdy zrzut ekranu pokazuje, czyj to pokaz.
- Agent widzi, kiedy i ile razy link był otwierany, a przy każdym linku — kto go wydał. Otwarcie przyciskiem z panelu nie jest liczone. Gdy właściciel odłącza współpracownika, wydane przez niego linki są odwoływane automatycznie.
- Odwołanie linku działa natychmiast. Wygasły link pokazuje przycisk „Poproś o nowy link” — jego naciśnięcie trafia do agenta jako zapytanie.



Co nie wycieka
- Adres — tylko dzielnica i miasto: bez ulicy i bez punktu na mapie, ani w PDF, ani w podglądzie linku. Tytułu i opisu nieruchomości nie anonimizujemy — proszę nie wpisywać w nich ulicy.
- Podgląd linku w komunikatorach to po prostu „Budvid”, bez zdjęcia i opisu; strona jest zamknięta dla wyszukiwarek.
- Wsparcie Budvid nie może otworzyć sekcji pokazów prywatnych nawet przy udzielonym dostępie.
Anonimowa karta w katalogu
Na życzenie nieruchomość prywatna jest pokazywana w katalogu bez tytułu, adresu i zdjęć: typ, dzielnica, powierzchnia (zaokrąglona), działka, pokoje, „Cena na zapytanie” i przycisk „Poproś o dostęp”. Kupujący zostawia imię i telefon; agent jednym przyciskiem wydaje mu osobisty link — albo nie.

Zapytania
Skąd przychodzą
| Źródło | Co zawiera zapytanie |
|---|---|
| Formularz w prezentacji nieruchomości | Imię, telefon, mieszkanie; dogodny termin i sposób kontaktu |
| „Dobierzcie mi coś” w katalogu | Rodzaj transakcji, budżet i waluta, pokoje, dzielnica |
| „Poproś o dostęp” na anonimowej karcie | Imię i telefon — prośba o pokaz prywatny |
| „Poproś o nowy link” | Ponowna prośba z wygasłego osobistego linku |
| Ekran w biurze sprzedaży | Jak zwykłe zapytanie |
Imię, telefon i zaznaczenie zgody na przetwarzanie danych są obowiązkowe — bez zgody zapytanie nie zostanie przyjęte. Drugie pole (domyślnie niezaznaczone) dodaje „podsumowanie wizyty”: co kupujący oglądał, co zapisał i o co pytał asystenta — żeby menedżer był przygotowany do rozmowy. Podsumowanie trafia do Telegrama i CRM; nie ma go w zakładce „Zapytania” ani w CSV.
Dokąd trafiają
| Dokąd | Jak |
|---|---|
| Panel, zakładka „Zapytania” | Zawsze |
| Telegram właściciela | Przez bota Budvid, bez konfiguracji — „Podłącz Telegram” |
| Telegram agenta | Tylko zapytania o jego nieruchomości |
| Grupa robocza zespołu | Przez własnego bota agencji: „Telegram i CRM” → „Własny bot, grupa robocza lub CRM” |
| CRM | Webhook na Państwa adres — zob. integracje |
- Wiadomości w Telegramie są po ukraińsku, z przyciskami do otwarcia nieruchomości, zarezerwowania mieszkania z tabeli mieszkań i wydania linku w odpowiedzi na prośbę o dostęp.
- Każdy czat wlicza się do limitu pakietu „Czaty Telegram”.
- Jeśli pakiet wygasł, zapytania nadal są dostarczane — z przypomnieniem o przedłużeniu.

Eksport i usuwanie
- „Pobierz CSV” w zakładce „Zapytania” — cała lista, a nie tylko pokazana strona, w CSV (UTF-8): data według czasu kijowskiego, nieruchomość, mieszkanie, imię, telefon, komentarz, język, typ, dogodny termin i jego szczegóły, sposób kontaktu, rodzaj transakcji, budżet, waluta, pokoje, dzielnica. Kolumny są rozdzielone średnikiem, a telefon pozostaje tekstem ze znakiem „+”. Jeśli Excel umieści wszystko w jednej kolumnie, należy otworzyć plik przez Dane → Z pliku tekstowego/CSV. Jeśli części zapytań nie udało się wczytać, panel o tym poinformuje i zaproponuje zapisanie tylko pokazanych — taki plik jest oznaczony „partial”.
- JSON przez API —
GET /v1/leads, strona po stronie, w pakietach z API. - Tylko właściciel może usunąć zapytanie na życzenie kupującego — przyciskiem „Usuń” w wierszu zapytania w zakładce „Zapytania” lub przez API. Kopie w Telegramie i CRM pozostają tam.

Integracje
Pełny opis webhooka i API, z przykładowymi żądaniami i weryfikacją podpisu, znajduje się na stronie Budvid i Państwa CRM. Tutaj — w skrócie, co gdzie jest.
Zapytania do Państwa CRM
- Panel → „Telegram i CRM” → „Własny bot, grupa robocza lub CRM” → „HTTP (CRM)” → „Adres (https)” → „Utwórz”.
- Proszę zapisać sekret podpisu — jest pokazywany tylko raz.
- Przycisk „Test” wysyła zdarzenie testowe; kod odpowiedzi Państwa serwera widać w zakładce „Dziennik wysyłek”.
Nie ma gotowych modułów dla konkretnych systemów CRM: webhook jest uniwersalny — JSON z podpisem HMAC w nagłówku X-Budvid-Signature. Bitrix24, KeyCRM, Binotel lub własny system wymagają niewielkiego handlera albo usługi pośredniczącej.
API
| Co | Jak |
|---|---|
| Gdzie | „Agencja 100”, „Agencja 300”, „Osiedle”, „Deweloper”, „Premium”. Pakiet „Agencja 30” nie ma API. |
| Adres usługi | Na ekranie logowania do panelu: „Lub kluczem API” → pole „Adres usługi”. Pole jest już wypełnione — prosimy niczego w nim nie zmieniać. |
| Klucz | Tworzy go właściciel: „Pakiet” → „Klucze API”. Do 5 aktywnych; pokazywany tylko raz. Klucz ma uprawnienia właściciela: należy go trzymać na serwerze, nigdy w przeglądarce. Kluczem można zapisywać dane tylko wtedy, gdy obowiązuje pakiet z API — w przeciwnym razie odpowiedź to 402; odczyt nadal działa. Jeśli panel przeszedł do nowego właściciela, klucze utworzone wcześniej są oznaczone „sprzed obecnego właściciela” — należy je unieważnić. |
| Limit | 300 żądań na minutę łącznie dla wszystkich kluczy panelu. |
Do czego służy: przesyłanie cen i statusów nowej inwestycji z Państwa CRM do tabeli mieszkań oraz pobieranie zapytań w formacie JSON. Przykłady są na stronie Budvid i Państwa CRM.
Prezentacja na Państwa stronie
Gotowy kod jest w panelu: „Więcej” → „Kod do osadzenia” przy opublikowanej nieruchomości (nieruchomości prywatne go nie mają). Wygląda tak:
<iframe src="https://budvid.com/p/<slug>" width="100%" height="640" style="border:0;border-radius:12px" allow="fullscreen" loading="lazy" title="3D"></iframe>
- Zapytania z osadzonej prezentacji trafiają tą samą drogą co z budvid.com.
- Osadzać można tylko prezentacje; panel nie otwiera się w cudzym elemencie iframe.
Zdarzenia dla Google Tag Manager
Osadzona prezentacja informuje Państwa stronę o działaniach kupującego — bez imienia i telefonu. Zdarzenia: view, unit_open (otworzył lokal), fav_add (zapisał go), compare_open (porównał), pdf, share, lead_sent (wysłał zapytanie), reno_style (wybrał styl remontu). Gotowy kod jest w panelu w tym samym miejscu, „Więcej” → „Kod do osadzenia”, zarówno dla agencji, jak i dla deweloperów. Na stronie z prezentacją przekazuje je do GTM jako budvid_<zdarzenie> z polami budvid_unit, budvid_project i 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>
Sposób wykorzystania tych zdarzeń określają zasady zgody na pliki cookie obowiązujące na Państwa stronie.
Dane i bezpieczeństwo
Role w świetle przepisów o ochronie danych osobowych
Agencja jest administratorem danych osobowych kupujących; Budvid jest podmiotem przetwarzającym i przetwarza je na polecenie agencji (sekcja 7 regulaminu). Zgoda kupującego jest zapisywana w formularzu wraz z wersją jej treści.
Przechowywanie i ochrona
- Serwery i baza danych znajdują się w Europie Wschodniej; dostawców infrastruktury wymieniono w Polityce prywatności. Pliki leżą w prywatnym magazynie bez publicznego adresu i udostępnia je serwer Budvid; pliki pokazów prywatnych — dopiero po sprawdzeniu uprawnień.
- Wgrywane pliki są sprawdzane pod kątem zawartości; ze zdjęć usuwane są znaczniki GPS.
- Adresy IP nie są przechowywane w bazie — tylko ich hash. Sesje, klucze API i zaproszenia również są przechowywane jako hashe.
- Nagłówki bezpieczeństwa: CSP, zakaz wykrywania typu MIME (MIME sniffing), polityka referrer, która nie przekazuje innym witrynom pełnego adresu strony; panelu nie można osadzić na innej stronie.
- O incydencie bezpieczeństwa powiadamiamy klienta w ciągu 72 godzin.
Dostęp Budvid do Państwa panelu
- Bez Państwa zgody wsparcie widzi kartę serwisową: pakiet, limity, listę nieruchomości, płatności, godziny logowań, błędy. Kupujących — tylko jako liczbę.
- Wsparcie może wejść do panelu wyłącznie za zgodą właściciela — „Otwórz na 24 godziny” lub „Otwórz na 72 godziny” w zakładce „Zespół”; dostęp można zamknąć w każdej chwili. Menedżer nie może udzielić takiego dostępu.
- Każde działanie wsparcia jest zapisywane w dzienniku, zanim zostanie wykonane; właściciel widzi dziennik w panelu, a jest on przechowywany przez rok.
- Nawet mając dostęp, wsparcie nie może płacić ani zmieniać pakietu, nie może niczego usuwać, nie tworzy ani nie zmienia kluczy API, webhooków i czatów Telegrama, zespołu, kontaktów ani marki, nie wykorzystuje Państwa działań AI i nie widzi pokazów prywatnych. Kupujący są widoczni w formie zamaskowanej: pierwsza litera imienia i dwie ostatnie cyfry telefonu.
Jak długo przechowujemy dane
| Dane | Okres przechowywania |
|---|---|
| Zapytania | Dopóki istnieje panel |
| Dziennik wysyłek do CRM i Telegrama | 30 dni |
| Otwarcia pokazów prywatnych | 90 dni |
| Wynik odczytu rzutu przez AI | 30 dni, bez tytułu i adresu |
| Dziennik dostępu wsparcia | 1 rok |
| Panel, za który nigdy nie zapłacono | Usuwany 30 dni po rejestracji lub po zakończeniu okresu próbnego |
| Panel po wygaśnięciu pakietu | Usuwany po 90 dniach; przypomnienia w Telegramie 7 dni i 1 dzień wcześniej |
Aby usunąć cały panel, prosimy napisać na hello@budvid.com.
Analityka bez trackerów
Statystyki odwiedzin nie używają plików cookie ani adresów IP; strona przechowuje w przeglądarce jedynie losowy klucz urządzenia. Na stronach nie ma trackerów reklamowych (Google Analytics, Meta Pixel itp.). Strony ofert z rynku wtórnego, pokazy prywatne i szkice są zamknięte dla wyszukiwarek.
Szczegóły — w Polityce prywatności i regulaminie.
Pakiety
Ceny i limity są w cenniku. Tutaj — jak zbudowane są pakiety.
- Dla agencji — „Agencja 30”, „Agencja 100”, „Agencja 300”: różnią się liczbą nieruchomości, wielkością zespołu, liczbą czatów, webhooków i działań AI. API jest dostępne od pakietu „Agencja 100”.
- Dla deweloperów — „Dom”, „Osiedle”, „Deweloper”, „Premium”. Pokazy prywatne są w pakietach „Deweloper” i „Premium”.
- Pakiet nie ogranicza liczby zapytań (jest jedynie ochrona przed spamem). Okres próbny trwa 7 dni, raz na klienta: „Okres próbny” — dla jednej nieruchomości, „Okres próbny AI” — dla kilku i z większą liczbą działań AI.
- Płatność kartą (Visa, Mastercard, Apple Pay, Google Pay) w hrywnach daje dostęp od razu. Przelewem na fakturę — dla firmy lub jednoosobowej działalności gospodarczej; dostęp najpóźniej następnego dnia roboczego po zaksięgowaniu środków.
- Nie ma automatycznego odnawiania: każdy okres opłaca się osobno. Umowa ma formę oferty publicznej, akceptowanej przez dokonanie płatności; protokół wykonania usług — na prośbę wysłaną e-mailem.
- Po wygaśnięciu pakietu prezentacje działają, a zapytania są dostarczane; edycja, nowe nieruchomości, ceny i statusy, zaproszenia i AI są zablokowane do czasu przedłużenia, asystent AI dla kupujących zostaje wyłączony, a klucze API mogą tylko odczytywać dane.
- Zwrot — w ciągu 14 dni od pierwszej płatności; warunki i wyjątki są w regulaminie.
Ograniczenia obecnej wersji
Tego Budvid obecnie nie ma. Mówimy o tym z góry, żeby mogli Państwo planować wdrożenie w oparciu o rzeczywiste możliwości. Jeśli coś jest krytyczne, prosimy o wiadomość: prośby pierwszych agencji realizujemy w pierwszej kolejności i podajemy uczciwy termin.
| Temat | Jak jest obecnie |
|---|---|
| Logowanie | Tylko prywatny Telegram lub klucz API. Brak SSO (Google Workspace, Microsoft), własnego uwierzytelniania dwuskładnikowego, ograniczenia według IP, listy sesji i opcji „wyloguj wszędzie”. |
| Role | Dwie: właściciel i menedżer. Menedżer widzi wszystkie zapytania i pracuje z każdą nieruchomością w panelu — rzut, ceny, statusy, zdjęcia; kontakty nieruchomości, import feedu, usuwanie, zespół, płatności i integracje należą wyłącznie do właściciela. Nie ma roli „tylko do odczytu”. |
| Dziennik działań pracowników | Brak. Dziennik jest prowadzony tylko dla dostępu wsparcia Budvid. |
| Wielkość zespołu | Do 5 / 10 / 30 osób w pakietach „Agencja 30” / „Agencja 100” / „Agencja 300”, łącznie z właścicielem. |
| Własna domena, white-label | Nie: adresy są w domenie budvid.com, a marka Budvid jest widoczna. Państwa marka — logo, kolor, kontakty, znak wodny. |
| CRM | Uniwersalny webhook i API; brak gotowych modułów dla konkretnych systemów CRM. Webhook jest wysyłany tylko przy zdarzeniu „nowe zapytanie”. |
| Dokumentacja API | Na stronie Budvid i Państwa CRM; brak specyfikacji OpenAPI i kluczy o ograniczonych uprawnieniach. |
| Feed DIM.RIA | Import ręczny, bez harmonogramu. Brak eksportu nieruchomości na portale — zamiast tego gotowe teksty ogłoszeń. |
| Powiadomienia | O zapytaniach — w panelu, Telegramie i CRM; bez e-maili. Wiadomości w Telegramie są po ukraińsku. |
| Dane | Baza danych jest w Europie Wschodniej; nie można wybrać Ukrainy. Brak certyfikatów (SOC 2, ISO 27001) i gwarantowanego SLA. |
| Eksport i usuwanie | Zapytania — CSV i JSON; brak jednego eksportu całego panelu. Zapytanie usuwa właściciel w panelu lub przez API, panel — na prośbę wysłaną e-mailem. |
| Formaty | Brak DWG (potrzebny DXF) i starego .xls (potrzebny .xlsx lub CSV). |
| Płatności | Brak automatycznego odnawiania. |
Najczęstsze pytania
Co musimy zainstalować?
Nic. Panel i prezentacje działają w przeglądarce; do logowania pracownicy potrzebują prywatnego konta Telegram.
Jaka przeglądarka jest potrzebna?
Dowolna nowoczesna z obsługą WebGL: Chrome, Safari, Edge, Firefox. Jeśli WebGL jest wyłączony, strona poprosi o włączenie akceleracji sprzętowej lub o otwarcie jej w Chrome albo Safari. Na telefonach 3D działa w lżejszym trybie, aby poradziły sobie modele ze średniej półki.
W jakich językach działa Budvid?
Strona, prezentacje i panel są dostępne po ukraińsku, angielsku, polsku, niemiecku, hiszpańsku, portugalsku, francusku, włosku i turecku. Asystent AI odpowiada w języku kupującego. Nie ma interfejsu rosyjskiego: przeglądarka ustawiona na rosyjski dostaje wersję ukraińską. Regulamin, polityka prywatności i strona o integracjach są po ukraińsku i angielsku.
Jak podłączyć nasz CRM?
Webhook na Państwa adres https, podpisany HMAC. W drugą stronę — ceny i statusy nowych inwestycji przez API, w pakietach z API. Wszystko z przykładami na stronie Budvid i Państwa CRM.
Pracownik odszedł — co zrobić?
Właściciel naciska „Odłącz” w zakładce „Zespół”: logowanie i sesje kończą się od razu, czat na zapytania tej osoby w Telegramie zostaje wyłączony, wydane przez nią w panelu linki do pokazów prywatnych są odwoływane, a jej nieruchomości przechodzą na „Biuro — wszystkie zapytania”. Należy usunąć ją z grupy roboczej zespołu w Telegramie — ten czat należy do Państwa, Budvid nim nie zarządza.
Właściciel panelu stracił dostęp do Telegrama?
Z kluczem API — należy zalogować się kluczem i powiązać nowy Telegram: dotychczasowe konto opuści panel, jego czat na zapytania zostanie wyłączony, a panel oznaczy klucze utworzone wcześniej i zaproponuje ich unieważnienie. Bez klucza — przez wsparcie pod adresem hello@budvid.com, z potwierdzeniem, że są Państwo właścicielem. W pakietach z API zalecamy od razu utworzyć klucz zapasowy i przechowywać go u dyrektora.
Gdzie fizycznie znajdują się dane?
Baza danych jest w Europie Wschodniej; dane nie są przechowywane na Ukrainie. Więcej w sekcji Dane i bezpieczeństwo.
Czy Budvid widzi naszych kupujących?
Bez Państwa zgody — tylko liczbę zapytań. Za zgodą (na 24 lub 72 godziny) — w formie zamaskowanej, a każde działanie jest zapisywane w dzienniku, który Państwo widzą.
Co, jeśli nie przedłużymy pakietu?
Prezentacje działają, zapytania są dostarczane, edycja jest zablokowana. Po 90 dniach panel zostaje usunięty — wcześniej należy wyeksportować zapytania do CSV.
Czy możemy umieścić prezentację na naszej stronie z własną analityką?
Tak: iframe oraz zdarzenia dla Państwa Google Tag Manager — zob. integracje.
Czy w pakiecie „Agencja 30” jest API?
Nie. API jest dostępne od pakietu „Agencja 100”.
Jakie są limity obciążenia?
API — 300 żądań na minutę łącznie dla wszystkich kluczy panelu. Pakiet nie ogranicza liczby zapytań (jest jedynie ochrona przed spamem).
Mają Państwo pytania?
Prosimy o wiadomość — pomożemy uruchomić Budvid w Państwa agencji lub dziale sprzedaży.