Вебхуки и 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».
- ЗащитаАдреса во внутренней сети отклоняются, перенаправления не выполняются.
Другие интеграции
Все интеграцииTelegram
Заявки с кнопками «Беру» и «Спам», тревоги и утренняя сводка: в личный чат и в группы.
Как это работаетMeta
Пиксель и Conversions API для Facebook и Instagram, расход и статус кабинета из Marketing API.
Как это работаетTikTok
TikTok Pixel и Events API: просмотр товара, нажатие «Заказать», заявка и покупка.
Как это работаетПервый сайт можно запустить сегодня
Регистрация бесплатная. Разделы и шаблоны можно посмотреть до выбора тарифа.