Kvadrum

Create a saved search for the realtor: Kvadrum alerts them about NEW public active listings that match (not about their own private ones, not about listings already on the market). Conditions use the find_properties names, but only these: deal_type, property_type, building_type, condition, renovation, city, district(s), country_code, price_min/price_max + currency, rooms, cats/dogs/children_policy, state_programs — any other condition is refused, tell the person it cannot be watched. At least one condition is required. The reply says where alerts will arrive; if only the in-app bell, suggest connecting Telegram.

create_saved_search

Delete one of the realtor's saved searches (id from list_saved_searches). Two steps: the first call returns a summary and a confirmation_token and deletes nothing; read the summary to the person and call again with the token only after they say yes. To pause alerts instead, use update_saved_search with alerts_enabled=false.

delete_saved_search

What the agency's live OLX advert of a listing says differently from the listing card, field by field (title, description, price, areas, rooms, floor, characteristics, district, photo count) — for when the realtor edited the advert right on OLX. It reads the advert from the OLX API and also refreshes the advert status stored on the card (if the listing is already sold or archived, a still-live advert is taken down on OLX). It never changes the listing's own fields. To take a value, call update_property with that field after the person confirms; photos and the final «keep the rest ours» are done with the «Синхронізувати з OLX» button on the card.

get_olx_differences

Recommended price orientation from comparable listings / deals: median estimate, the comparison level used and the sample size. Refuses honestly when there is too little data. A recommendation, not an appraisal.

estimate_price

Find the realtor's clients by (part of) the name. Phone numbers and e-mails are not searchable and not returned. Returns names, notes and Kvadrum links.

find_clients

Search listings visible to the realtor with the catalogue's own filters: own agency, public listings of other agencies (foreign) and listings from boards such as OLX / DOM.RIA (origin "market"). Filters: place (city, districts, streets, complex, radius), deal/property/building type, rooms, renovation, price ranges in any currency, price per m², areas, floors, state programmes (e.g. єОселя), characteristics (balcony, heating, parking…), rental policies, co-broking, tags, dates, text, notes. Keys and values of characteristics and enums: property_search_options. Cards carry every object field — prices in USD/UAH/EUR (native currency exact, others ≈ at the NBU rate on fxAsOf), characteristics as a {key: value} map; get_property gives names, description, price history and nearby places. No contact details. If a reply says truncated, repeat with the suggested limit and page.

find_properties

Search the official Kvadrum Help Center (FAQ and step-by-step guides) for how to do something in Kvadrum. ALWAYS call this before explaining how to use any Kvadrum screen, button, setting or feature — never describe the interface from memory. Pass 2–6 keywords in the person's language (e.g. "add photos property", "connect Telegram alerts"), not a whole sentence. Answer only from the returned entries, keep their steps in order, and give the link. If nothing is found, try once more with shorter or different keywords; if still nothing, say the Help Center has no answer and suggest the «Support» item in the Kvadrum menu. Never invent buttons or menu paths.

how_to

Card of one deal: stage, client name, need, viewing / call dates, linked listing, amounts, Kvadrum link. No contacts and no message texts. `messaging` tells where a message to the client can go (send_client_message). `selection` — listings sent for this client on this deal, with the realtor's internal notes (set_selection_note).

get_lead

Deal funnel for a period (deals created in it): count per stage, conversion between stages, average times, loss reasons, lead sources, stale deals. A realtor sees their own deals; the owner and a manager see the agency and may narrow it to one realtor. Money appears only for the owner, a manager or an independent realtor.

pipeline_report

Link a listing to a deal (replaces the previously linked listing). Returns the deal as saved.

link_lead_property

List the realtor's deals. Filters: stage, "cold" (no contact for a long time), unassigned; the agency owner / manager may also filter by realtor (name or id). Lost deals are hidden unless the stage is given. Returns deal cards with client name, who runs the deal and links; no contacts.

list_leads

Full card of one listing the realtor may see — everything the catalogue shows about the object: all characteristics with names and units, state programmes, complex, renovation, rental policies, prices in USD/UAH/EUR (NBU rate), price history, nearby places, description, number of photos and the photos by number (photoId, position, isCover, processed = already cleaned in Kvadrum; no links), a summary of its translations (texts via get_property_translations), for your own listings the OLX filter fields still empty (olxReadiness) and the real state of its OLX advert (olxAdvertStatus: moderation = OLX is checking it and will show it to everybody, active, removed_on_olx, expired_on_olx, olx_payment_required = OLX asks for payment in its cabinet, rejected_by_olx, or a take-down/publication state; olxStatusCheckedAt = when OLX was last asked) and a Kvadrum link. Contacts of the owner or the realtor are never included — open the link for them.

get_property

Reference for find_properties and saved searches: every characteristic (key, name in the realtor's language, type, options with labels, unit), state programme codes with names, renovation grades and the allowed values of every list filter, and the countries present in the catalogue (code + name). Call it before filtering by a characteristic you do not know the key of.

property_search_options

Title and description of one listing in each of the 14 content languages, with where each text came from (original / machine / assistant / realtor), status (ready / pending / missing) and whether it is outdated (the original changed after it was translated). Pass locales to get only some languages; es-AR is served by es.

get_property_translations

Listings that match a client's need, best first, from the matching Kvadrum keeps for the client's open deal. Pass client_id (one open deal) or lead_id. Returns match percent and short cards with links; no contacts. only_new=true leaves out everything this client was already sent or shown and anything that appeared before the last message to them (lastSentAt) — for a «fresh selection».

match_for_client

Read-only report on your active exclusive listings: how many are active, outdated, or missing photos, a price or an address; exclusive contracts ending within exclusive_days or already ended; possible duplicate pairs; OLX adverts that wait for your own decision in Kvadrum (the reason is given for each) and how many adverts Kvadrum renewed automatically in the last 7 days. Up to 20 example listings per section, with links. The agency owner and managers see the whole agency; a realtor sees their own listings. Changes nothing.

listings_health

Move a deal to another stage. Closing as "won" or "lost" requires a confirmation step: the first call returns a summary and a token. For "won" ask the person for the closing price and commission; if they say "later", call without them — nothing is filled in automatically. Closing cannot be undone back to the previous stage, and closing as "lost" cancels every scheduled or waiting message to the client. An optional comment is stored in the deal history.

transition_lead

Where the realtor's notifications arrive: Telegram bot, mobile app (push), in-app bell, e-mail — connected or not, switched on or not; which work events are on; and where saved-search alerts go right now. If Telegram is not connected, give the person the steps and the screen link from the reply — you cannot connect it or change settings yourself.

my_notification_channels

Listings near a point of a viewing: around a listing (property_id) or around coordinates. Sorted by distance. Also reports how many listings in the same city have no coordinates and so cannot be placed by distance — mention them to the person.

nearby_for_showing

New listings that matched the realtor's own saved searches (with alerts on) over the last days, newest first, with the name of the search that caught each one.

saved_search_updates

Set, replace or clear the realtor's internal note on ONE listing in a deal's selection — the list of listings sent for this client (send_listings_to_me with lead_id, or the Telegram button). The client never sees it; the agency owner and manager reading the deal do. Use it for remarks about that listing («owner will go to 85k», «client said too far»). A remark about the whole deal goes to add_note instead. Take property_id from get_lead → selection. Replaces the previous note (it is returned as previousNote); an empty note clears it. Up to 500 characters.

set_selection_note

Get a temporary link for adding photos to one of the realtor's listings. Use it whenever the person wants to add photos that are on their phone or computer or were attached to this chat: give them the link, they open it and pick the photos. The link works for 30 minutes, for up to 30 photos, for this listing only; it works without signing in, so anyone holding it can add photos to this listing. A new link for the same listing replaces (switches off) the previous one.

photo_upload_link

The realtor's own viewings and scheduled calls for one day (default: tomorrow, in the user's timezone — returned as `timezone`), grouped by city and district so a route can be planned. Each stop has the deal and listing links. Agency owner / manager: team=true gives the whole team's day, grouped by realtor.

day_plan

List recent publication requests and their state: pending (waits for a person), sending, published, rejected, expired, failed (failureReason says why, e.g. "olx_refused:district — …" = OLX refused the district), or unknown (no answer from the platform — being checked, do not request again).

get_pending_publications

Prepare one of your agency's listings for publication on OLX or in the agency Telegram channel. This does NOT publish: it creates a request that a person must approve in Kvadrum; nothing leaves before that. After approval an OLX advert goes through OLX moderation (usually seconds) and becomes visible to everybody; an advert taken down earlier is switched back on, not duplicated. Calling it again for the same listing and platform updates the waiting request. For OLX the answer lists the filter fields still empty (olxReadiness) — offer to fill them with update_property. Tell the person to open the approval link (section "Publications to approve" in Kvadrum) or to press "Publish" under the Telegram notification.

request_publish

Save your own translations of one of the realtor's listings (title and/or description, up to 13 languages in one call) instead of the machine translation. Translate the WHOLE original from get_property_translations: keep every number, price and currency exactly, add no phone numbers, links or contacts. Each language is answered saved / unchanged / refused (with the reason — fix it and send that language again). The original language itself is changed with update_property. Machine translation never overwrites a saved language. es-AR is saved as es.

save_translations

The realtor's own saved searches (subscriptions to new listings): id, name, conditions in find_properties names, whether alerts are on, how many listings each has brought and when the last one came. Newest first.

list_saved_searches

Set the viewing date and time of a deal. "at" is "YYYY-MM-DD HH:MM" in the user's timezone (see `timezone` in day_plan; or ISO-8601 with an offset). The reply spells the date out in words — read it back to the person.

set_viewing

The realtor's messages to clients: the ones waiting for the realtor's approval (status awaiting_approval), the scheduled ones and the recently sent / handed over / failed. Filters: lead_id, client_id, status. Each has an id for cancel_scheduled_message. Approving is the realtor's own press in Kvadrum — it cannot be done from here.

list_scheduled_messages

Send a message to the realtor's client on the realtor's behalf, now or at send_at, into the chat where the client wrote first (Telegram or OLX) — never to a phone or e-mail. Recipient: lead_id, or client_id (one open deal), or dialog_id from list_client_dialogs. If two people could match the name, ask the person which one before calling. kind: text · listings (property_ids, up to 10; Kvadrum adds cards with prices from the database and a guest link — never put links in text) · document (document_filename + document_base64: PDF, DOCX, JPEG, PNG up to 10 MB; Telegram only) · nudge (a reminder to a client who went quiet). send_at: ISO 8601; without a zone it is the realtor's local time; no messages are scheduled into the client's night (21:00–09:00). When Telegram's 24-hour window is closed, the message is handed to the realtor in their chat with the Kvadrum bot to send by hand. In the realtor's «ask» mode (the default) the message is NOT sent: it waits for the realtor's approval in Kvadrum and in Telegram, and the reply carries a summary and a token in case the person agrees right here. To correct a waiting message, call again (without the token) with the new text for the same client and kind within 15 minutes: it REPLACES the earlier one. To withdraw one without a replacement, use cancel_scheduled_message with its id.

send_client_message

Send a short test message to the realtor's own Telegram bot or mobile app (push) — like the «test» button on the Notifications screen — and report sent / not_connected / disabled / failed. Ask the person whether it arrived.

send_test_notification

Send up to 10 listings to the realtor's OWN chat with the Kvadrum notification bot in Telegram, as the same cards as the «send to my Telegram» button (photos, price, address, description, the realtor's own phone) — ready to forward to a client. Take ids from find_properties / match_for_client / competitors_for_property. Optionally say who the selection is for: client_id (from find_clients) or lead_id files the delivered listings into that client's deal selection; label is a short free-text note («for Olena, Saturday») that is not stored. A service note «do not forward» with the list comes last. This never writes to the client — that is send_client_message. If the client has several open deals, ask the person which one and pass lead_id. To leave a remark on a delivered listing, call set_selection_note afterwards; label is not stored.

send_listings_to_me

Send short messages to several clients at once (up to 20), each with their own text — typically reminders (kind "nudge") to deals from list_leads cold=true. One summary lists who gets it, who is handed to the realtor and who is left out and why; to remove somebody, call again (without the token) with a shorter list. Same rules as send_client_message; a batch never goes out at the client's night. In the realtor's «ask» mode nothing is sent: the batch waits for the realtor's approval in Kvadrum and in Telegram, and a new batch from you that touches any of the same clients within 15 minutes REPLACES the earlier waiting batch whole.

send_client_messages_batch

Draft listings waiting to be finished (from the bot, voice or video) and listings waiting for the agency's review. kind = drafts | reviews | all. The owner and a manager see the team and may filter by author; others see their own. Each card has a link; approving or returning is done in Kvadrum.

list_drafts

Update the need of a client's open deal: rooms, area, maximum price, state programmes the client buys under (єОселя, єВідновлення, housing voucher …), free-text wishes. Pass client_id (one open deal) or lead_id. Only the given fields change. Use state_programs for programmes — they are checkboxes on the deal and drive the matching; do not put them into notes. Returns the updated deal.

update_client_need

Change characteristics of one of the realtor's listings. Only the given fields change; the old values are overwritten. If the listing is already published, the change also reaches its live OLX advert and the agency Telegram channel card (a price cut is announced under the card). Changing a price requires a confirmation step: the first call returns a summary and a token.

update_property

Change one of the realtor's saved searches (id from list_saved_searches): name, alerts on/off, or conditions. Conditions REPLACE the whole set — send every condition the search should keep, not only the changed one. Same conditions as create_saved_search; the reply shows the result.

update_saved_search