Budvid поверх вашої CRM

Сценарій 1 · без програміста

Google Таблиця → шахматка щогодини

Менеджери й далі працюють у своїй таблиці. Budvid раз на годину читає опублікований аркуш і оновлює статуси й ціни квартир у презентації.

Сценарій 2 · для вашого програміста

Ваша CRM оновлює статуси й ціни через API

Квартиру продали чи забронювали в CRM — CRM одним запитом передає шахматку в Budvid, і покупці бачать зміни в презентації за ~15 секунд.

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}
      ]}'

Відповідь: {"saved": 3}. Поточну шахматку віддає та сама адреса методом GET.

Список замінює шахматку цілком: передавайте всі квартири разом, до 3000 в одному запиті. Квартира, якої в списку немає, показується вільною.

Сценарій 3 · заявки

Заявки з презентації → ваша CRM

Покупець залишив заявку в 3D-презентації — Budvid одразу надсилає її на вашу адресу. Приклад: вхідний вебхук у вашій CRM — Bitrix24, KeyCRM, Binotel чи власна система.

1. Створіть вебхук. Кабінет → «Вебхуки» → «Новий вебхук» → «HTTP (CRM)», адреса — https.
2. Збережіть секрет. Його показуємо один раз; ним ваша сторона перевіряє підпис.
3. Перевірте. Кнопка «Тест» надсилає подію webhook.test, а вкладка «Доставки» показує код відповіді вашого сервера.

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": "Олена",
    "phone": "+380 67 123 45 67",
    "note": null,
    "lang": "uk",
    "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']);