Budvid on top of your CRM

Way 1 · no developer needed

Google Sheet → sales chart every hour

Your sales team keeps working in its own sheet. Once an hour Budvid reads the published sheet and updates the units’ statuses and prices in the presentation.

Way 2 · for your developer

Your CRM updates statuses and prices over the API

A unit is sold or reserved in the CRM — the CRM sends the chart to Budvid in one request, and buyers see the change in the presentation within ~15 seconds.

curl -X PUT "<API_URL>/v1/projects/<slug>/sales" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"sales": [
        {"id": "flat-12", "status": "sold",      "price": 81000},
        {"id": "flat-13", "status": "reserved",  "price": 79500, "area": 57.6},
        {"id": "flat-14", "status": "available", "price": 84000}
      ]}'

Answer: {"saved": 3}. A GET to the same address returns the current chart.

The list replaces the whole chart: send all units together, up to 3000 in one request. A unit missing from the list shows as available.

Way 3 · requests

Requests from the presentation → your CRM

A buyer leaves a request in the 3D presentation — Budvid sends it to your address at once. For example: an incoming webhook in your CRM — Bitrix24, KeyCRM, Binotel or your own system.

1. Create a webhook. Cabinet → “Webhooks” → “New webhook” → “HTTP (CRM)”, an https address.
2. Store the secret. It is shown once; your side checks the signature with it.
3. Check it. The “Test” button sends a webhook.test event, and the “Deliveries” tab shows your server’s response code.

POST https://crm.example.com/hooks/budvid
Content-Type: application/json
X-Archviz-Event: lead.created
X-Archviz-Delivery: dlv_…
X-Archviz-Signature: t=1761400000,v1=5f2c…

{
  "id": "evt_…",
  "event": "lead.created",
  "created": 1761400000,
  "data": {
    "id": "lead_…",
    "project": "<slug>",
    "unit": "flat-12",
    "name": "Olena",
    "phone": "+380 67 123 45 67",
    "note": null,
    "lang": "en",
    "created": 1761400000
  }
}

// Node.js
import { createHmac, timingSafeEqual } from 'node:crypto';

function verify(rawBody, header, secret) {
  const p = Object.fromEntries(
    header.split(',').map((s) => s.split('=')));
  const age = Math.abs(Date.now() / 1000 - Number(p.t));
  if (!p.t || !p.v1 || age > 300) return false;
  const expected = createHmac('sha256', secret)
    .update(`${p.t}.${rawBody}`).digest('hex');
  return expected.length === p.v1.length &&
    timingSafeEqual(Buffer.from(expected), Buffer.from(p.v1));
}

// PHP
$body = file_get_contents('php://input');
$header = $_SERVER['HTTP_X_ARCHVIZ_SIGNATURE'] ?? '';
parse_str(str_replace(',', '&', $header), $p);
$ok = isset($p['t'], $p['v1'])
  && abs(time() - (int) $p['t']) <= 300
  && hash_equals(
       hash_hmac('sha256', $p['t'] . '.' . $body, $secret),
       $p['v1']);