Вебхук надсилає кожне замовлення з Live-cart тієї ж миті, коли воно з’являється, — на будь-яку адресу, яку ви вкажете. Це може бути Zapier, n8n, Make, CRM, для якої в нас немає готової інтеграції, або ваша власна програма. Це універсальний спосіб з’єднати Live-cart з рештою вашого бізнесу — і він доступний на всіх тарифах.
Відкрити вебхукиЩо таке вебхук
Зазвичай, щоб дізнатися про ваші замовлення, інша система має раз у раз запитувати нас: «є щось нове?». Вебхук перевертає це: ми повідомляємо самі, щойно щось стається. Ви даєте нам вебадресу, і з кожним новим замовленням ми надсилаємо на неї повне замовлення одним повідомленням.
Щоб цим користуватися, не потрібно бути програмістом. Zapier, n8n і Make дають готову адресу, яку досить вставити, а далі ви самі обираєте, що відбувається: додати рядок у Google Таблицю, створити угоду в CRM, надіслати собі повідомлення в Telegram, роздрукувати наклейку.
Як налаштувати
- Відкрийте Інтеграції → Вебхуки в кабінеті й натисніть Додати адресу.
- Вставте адресу, яка має отримувати замовлення. Вона повинна починатися з https://.
- Скопіюйте ключ підпису, який ми покажемо. Він показується один раз і більше ніколи — якщо втратили, натисніть Новий ключ, і ми видамо інший.
- Натисніть Надіслати тестову подію. Сервіси автоматизації будують відповідність полів, дивлячись на справжнє повідомлення, тож зазвичай це обов’язковий крок і з їхнього боку.
Можна додати до п’яти адрес, і кожну з них можна вимикати та вмикати, не видаляючи.
Що ми надсилаємо і коли
| Подія | Коли надсилається |
|---|---|
| order.created | Покупець оформив замовлення. Надсилається для кожного замовлення, зокрема з післяплатою. У цей момент замовлення ще не оплачене. |
| payment.confirmed | Платіжний провайдер підтвердив, що гроші справді надійшли. Саме на цю подію варто реагувати, якщо ви відправляєте лише оплачені замовлення. |
| test.ping | Надсилається лише тоді, коли ви натискаєте «Надіслати тестову подію». Містить ті самі поля, що й справжнє замовлення, плюс позначку "test": true. |
Кожна адреса може підписатися лише на ті події, які їй потрібні. Найпоширеніший варіант — слухати тільки payment.confirmed, щоб до збирання замовлень нічого не потрапляло, доки гроші справді не надійшли.
Як виглядає повідомлення
Ми надсилаємо все замовлення повністю, щоб вашій автоматизації не доводилося ні про що нас додатково запитувати. Повідомлення надходить у форматі JSON:
Основні блоки
| Блок | Що всередині |
|---|---|
| order | Номер замовлення, статус, статус оплати, статус виконання та суми (проміжна, доставка, податок, разом). |
| contact | Покупець: ім’я, прізвище, по батькові, телефон, пошта та позначка «не телефонувати». |
| delivery | Перевізник і його назва, місто, відділення чи адреса, а також refs — внутрішні ідентифікатори перевізника, потрібні для автоматичного створення накладної. |
| payment | Який спосіб оплати обрав покупець, його назва та чи оплачено. |
| items | По одному запису на позицію: назва, SKU, кількість, ціна за одиницю, сума рядка та фото. |
| shop | До якого з ваших магазинів належить замовлення — знадобиться, якщо кілька магазинів надсилають дані на одну адресу. |
Як правильно читати суми
Саме тут помиляються найчастіше, тому кожну суму ми надсилаємо одразу трьома способами:
- amount — у копійках, лише цілі числа, тож нічого не втрачається на округленні.
- decimal — та сама сума у звичному вигляді: 1299.00.
- У сервісах без коду беріть decimal. Якщо підставити amount просто в рахунок, ви надрукуєте ₴129900 замість ₴1299.
Як перевірити, що повідомлення справді від нас
Кожен запит несе заголовок Lc-Signature, створений тим ключем підпису, який ви скопіювали під час створення адреси. Якщо замовлення надходять у вашу власну програму — перевіряйте його: саме це не дає тому, хто вгадав вашу адресу, надсилати вам фальшиві замовлення.
- Беріть тіло запиту рівно таким, як воно надійшло. Якщо розібрати JSON і зібрати його заново, пробіли й порядок ключів можуть змінитися — і підпис перестане збігатися.
- Відхиляйте все, що старше за п’ять хвилин. Час є частиною підпису — саме тому перехоплений запит неможливо надіслати повторно пізніше.
- У Zapier, n8n чи Make перевірити підпис зазвичай неможливо — тоді вас захищає лише таємність самої адреси вебхука, тож ніде її не публікуйте.
Повтори, дублікати та журнал доставлень
Ваша адреса має відповісти будь-яким статусом 2xx. Будь-що інше — або відсутність відповіді протягом десяти секунд — вважається невдачею, і ми пробуємо знову зі зростаючими проміжками: приблизно через хвилину, потім через п’ять, тридцять, далі години — загалом близько двох діб.
- Те саме замовлення може надійти двічі. Якщо ваша система прийняла замовлення, але її відповідь загубилася дорогою до нас, ми надішлемо його ще раз. Використовуйте поле id, щоб упізнати вже оброблене повідомлення й пропустити повтор.
- Порядок не гарантований. Під час повторів payment.confirmed може прийти раніше за order.created. Орієнтуйтеся на номер замовлення, а не на послідовність подій.
- Адреси, які постійно не відповідають, ми вимикаємо й позначаємо в кабінеті, щоб мертва адреса не повторювала спроби нескінченно. Полагодьте її й натисніть Увімкнути.
- Журнал доставлень на сторінці вебхуків зберігає 30 днів спроб разом із відповіддю, яку ми отримали, і кнопку Надіслати ще раз для тих, що не дійшли.
Вимоги до адреси
- Лише https://. У замовленнях є імена, телефони й адреси ваших покупців, тому без шифрування ми їх не надсилаємо.
- Адреса має бути доступна з інтернету. Адреси у внутрішній або локальній мережі відхиляються.
- Переадресації не виконуються — вказуйте кінцеву адресу одразу.
- Одну й ту саму адресу можна додати лише раз на магазин.
Якщо у вас уже налаштована CRM
Live-cart уміє передавати замовлення напряму в KeyCRM і SalesDrive зі сторінки інтеграцій з CRM. Ці інтеграції працюють окремо від вебхуків — тож якщо там підключено KeyCRM і водночас вебхук передає дані в ту саму KeyCRM через Zapier, кожне замовлення створиться двічі.
Оберіть один шлях для кожного отримувача. Там, де в нас є вбудована інтеграція, користуйтеся нею, а вебхуками — для всього іншого.
Що з цим роблять
- Кожне замовлення додається рядком у Google Таблицю для бухгалтера.
- Повідомлення в Telegram чи Viber команді пакування, щойно проходить оплата.
- Замовлення потрапляють у CRM, якої в нас немає серед інтеграцій — у будь-яку, через Zapier або Make.
- Накладна Нової Пошти, яка створюється автоматично в n8n за ідентифікаторами перевізника з блоку delivery.
- Ваша власна складська чи бухгалтерська програма — напряму.
Стаття не допомогла?
Напишіть нам — розберемося з вашим випадком особисто.