Усі інтеграції

Вебхуки та API для власних систем

Кожна нова заявка йде POST-запитом на вашу адресу. Статус замовлення та суму продажу можна повернути назад через API.

Створити акаунт Живе демо

Вебхуки та API-ключі доступні з тарифу Flow.

Що йде на вашу адресу

Запит надсилається одразу після заявки. Спам не надсилається.

eventЗавжди lead.created.
leadНомер заявки, імʼя, телефон, статус, варіант A/B-тесту, UTM-мітки та час.
siteНомер сайту, його назва й адреса.
X-Tersby-SignatureПідпис тіла запиту HMAC-SHA256, якщо ви задали секрет.

Так виглядає запит

Перевірте підпис своїм секретом, щоб приймати заявки лише від Tersby.

POST https://crm.example.com/tersby
X-Tersby-Signature: 5f2a9c…

{
  "event": "lead.created",
  "lead": {
    "id": "cm8f3a2k…",
    "name": "Марина Петренко",
    "phone": "+380 67 482 19 03",
    "status": "new",
    "variant": "a",
    "utm": { "utm_source": "facebook", "utm_campaign": "bosch_x4" },
    "createdAt": "2026-09-30T11:32:08.000Z"
  },
  "site": { "id": "cm7x…", "name": "Дриль Bosch Pro X4", "address": "drill.tersby.app" }
}

Як підключити

Адреса додається в розділі «Вебхуки».

Додайте адресу
Вкажіть URL і, за бажанням, секрет для підпису. Без вибору сайту заявки підуть з усіх сайтів.
Надішліть тест
Тестова заявка покаже, що ваш сервер відповідає. Результат видно в історії надсилань.
Створіть API-ключ
Ключ показується один раз. З ним зовнішня система може змінювати заявки.
Поверніть статус
PATCH /api/external/leads/{id} із заголовком Authorization: Bearer ключ і тілом { "status": "bought", "saleAmount": 1190 }.

Корисно знати

ПовториЯкщо ваш сервер не відповів або повернув помилку 5xx, Tersby повторить надсилання ще двічі: через 3 і через 10 секунд.
Історія надсиланьПо кожній адресі видно, коли було надсилання, з яким кодом відповіді та якою помилкою. У разі збою прийде тривога в Telegram.
Статус за посиланнямЯкщо ваша система вміє лише викликати посилання при зміні статусу, створіть таке посилання на вкладці «Статуси з CRM».
ЗахистАдреси у внутрішній мережі відхиляються, перенаправлення не виконуються.