Огляд підготував Антон Литвинов, засновник Lytvynov Production. Факти про KeyCRM взято з їхньої довідки й OpenAPI-документації, про Нову пошту з живих запитів до API, усе перевірено 19.11.2026.
Спершу про те, що стосується вашого часу. KeyCRM сама вміє створювати накладні Нової пошти й підтягувати статуси доставки. Якщо ваші замовлення влаштовані стандартно, інтеграція вже працює, і n8n вам не потрібен. Ця сторінка про інше: що робити, коли замовлення нестандартні, коли після створення ТТН має статися щось своє, і як це зібрати в n8n або Make так, щоб воно не ламалося.
У кінці є готовий сценарій для імпорту в n8n. Ми імпортували його в n8n 2.47.7 і прогнали код вузлів на тестових даних, але з бойовими ключами не запускали, тому перед запуском прогоніть його на тестових замовленнях. Що саме ми перевірили, а що ні, описано в розділі про перевірку.
Що KeyCRM уже вміє сама
Довідка KeyCRM описує створення ТТН Нової пошти прямо в замовленні. Кнопка в один клік працює, коли виконано три умови: адресу отримувача збережено як склад, у товару в каталозі задано габарити, а адміністратор налаштував автозаповнення поля «Опис відправлення» в інтеграції. Тоді KeyCRM сама бере відправника з налаштувань служби доставки, отримувача й телефон із замовлення, оголошену вартість із суми замовлення, а післяплату вмикає, якщо замовлення неоплачене чи оплачене частково. Після створення в замовленні з'являється трек-код.
Статуси теж приходять без вашої участі. У розділі налаштувань доставки є правила переключення статусів: ви зіставляєте статус доставки зі статусом замовлення, і замовлення рухається воронкою само. Статус «Повернено» від Нової пошти KeyCRM теж отримує. За довідкою, є дві межі. Якщо в Нової пошти увімкнено контроль оплати, статус «Доставлено, гроші отримано» до KeyCRM не доходить, і замовлення переходить одразу в «Доставлено». А статус оплати післяплати правилами доставки не змінюється, для цього потрібні тригери автоматизації.
Тому перш ніж щось будувати, перевірте, чи справді вам потрібна власна автоматизація. Ось ситуації, у яких готова інтеграція вже не вистачає:
- замовлення приходять з адресою «двері», а не зі складом, або склад взагалі не вибрано;
- у замовленні кілька товарів: для одного товару габарити беруться з шаблону, для кількох KeyCRM сумує тільки вагу, і габарити вводять руками;
- ТТН треба створювати за вашим правилом, наприклад лише для оплачених замовлень з певного джерела, або одразу пачкою ввечері;
- клієнту й менеджерам треба слати повідомлення у Telegram чи Viber на певних статусах доставки, а не лише міняти статус у CRM;
- у процесі є ще щось: списання зі складу в іншій системі, запис у таблицю бухгалтера, виклик кур'єра;
- вам потрібен контроль збоїв: хтось має дізнатися, що накладну не створено, раніше за клієнта.
Якщо впізнали себе хоча б в одному пункті, читайте далі. Якщо в жодному, налаштуйте інтеграцію KeyCRM і заощадьте гроші. Ми так і радимо клієнтам, і про це ж у нашому порівнянні CRM на замовлення чи готова CRM.
Схема потоку
Сценарій складається з двох частин. Перша створює накладну, коли замовлення переходить у потрібний статус. Друга раз на пів години перевіряє, що з відправленнями.
Замовлення в KeyCRM переходить у статус «Готово до відправки»
|
v тригер автоматизації KeyCRM: «Відправити HTTP запит» (POST)
n8n: вебхук відповідає 200 одразу
|
v
Фільтр статусу -> GET замовлення з KeyCRM (include=buyer,products.offer,shipping,payments)
|
v
ТТН уже є? -> так: зупинка (захист від дубля при повторі вебхука)
| ні
v
Нова пошта: Address/getWarehouses -> місто складу (CityRef)
Нова пошта: Counterparty/save -> отримувач і контактна особа
Нова пошта: InternetDocument/save -> ТТН (IntDocNumber)
| \
v v помилка
PUT замовлення в KeyCRM: Telegram менеджерам: що відхилила Нова пошта
shipping.tracking_code
|
v
Telegram менеджерам: ТТН створено
Окремий сценарій, кожні 30 хвилин:
GET замовлень зі статусом «Відправлено» -> пачки по 100 ТТН
-> Нова пошта: TrackingDocument/getStatusDocuments -> що змінилося -> TelegramСхема статична: потрібні самі кроки, а не анімація.
Крок 1: вебхук з KeyCRM
KeyCRM не отримує вхідних вебхуків, вона лише надсилає вихідні запити через тригери автоматизації. Тригер створюють для замовлень або воронки: подія зміни статусу замовлення, створення, оплата, резерв чи списання товару. Дія називається «Відправити HTTP запит». Обираєте метод (за замовчуванням POST), вказуєте URL вебхука з n8n і за бажанням додаєте до 20 власних заголовків. Адреси localhost і приватних мереж KeyCRM блокує, тому n8n має бути доступний ззовні по https.
Без власних параметрів KeyCRM надсилає JSON з двох полів: event (наприклад order.change_order_status) і context з даними замовлення. Нам цього достатньо: з context.id ми візьмемо номер замовлення, а решту довантажимо запитом, бо вебхук не віддає ні габаритів, ні складу доставки повністю.
Три правила від самої KeyCRM, на яких тримається надійність:
- Сервер-отримувач має відповісти за 10 секунд кодом 2xx. Тому вебхук-нода n8n працює в режимі «відповісти одразу», а весь сценарій виконується після відповіді.
- На 5xx і таймаути KeyCRM повторює запит тричі: через 1, 5 і 15 хвилин. На 3xx і 4xx повторів немає, а менеджер і адміністратори отримують системне сповіщення.
- Повтор надсилає знімок даних з першої спроби. Отже, сценарій має бути ідемпотентним: той самий вебхук двічі не повинен створити дві накладні.
Захистіть вебхук: у ноді Webhook є авторизація заголовком (Header auth), а KeyCRM дозволяє додати власний заголовок з секретом. Без цього ваш URL може викликати будь-хто. У сценарії нижче це вже зроблено.
Крок 2: звернення до API KeyCRM
База API: https://openapi.keycrm.app/v1, авторизація заголовком Authorization: Bearer ВАШ_КЛЮЧ. Ключ створюють у KeyCRM, інструкція в довідці називається «Де взяти API-ключ». Важливі межі з документації OpenAPI:
- до 20 запитів на хвилину по одному ключу;
- у списках максимум 50 записів на сторінку;
- усі дати в UTC;
- фільтри передаються як
filter[поле]=значення, наприкладGET /order?filter[status_id]=1,4.
Двадцять запитів на хвилину мало, якщо не рахувати. Наш основний сценарій робить два запити до KeyCRM на замовлення: прочитати й записати ТТН. Це близько десяти замовлень за хвилину. Для магазину, що відправляє кількасот посилок на день, цього досить, але якщо ви переведете сто замовлень у статус одночасно, частина запитів отримає відмову. Є два способи. Перший: ставити в сценарій вузол Wait і обробляти замовлення чергою. Другий: у n8n увімкнути на HTTP-вузлі «Retry On Fail», що ми й зробили. Для великих обсягів перенесіть створення накладних у нічну пачку.
Замовлення читаємо з параметром include: без нього повертається лише базова сутність. Нам потрібні buyer, products.offer, shipping і payments. У об'єкті shipping KeyCRM зберігає delivery_service_id, tracking_code, warehouse_ref (UUID складу Нової пошти, обов'язково разом з ідентифікатором служби доставки в CRM), а також дані отримувача, якщо він відрізняється від покупця.
Записати ТТН назад можна через PUT /order/{id} з об'єктом shipping: {"shipping": {"delivery_service_id": 1, "tracking_code": "20450000000000"}}. Номер служби доставки в вашій KeyCRM дізнаєтеся запитом GET /order/delivery-service. Після цього KeyCRM сама підхоплює відстеження за цим номером, а правила переключення статусів працюють як зазвичай.
Крок 3: створення ТТН через API Нової пошти
API Нової пошти 2.0 приймає один тип запиту: POST на https://api.novaposhta.ua/v2.0/json/ з тілом, у якому чотири поля: apiKey, modelName, calledMethod і methodProperties. Ключ API створюється в особистому кабінеті Нової пошти на сторінці налаштувань API 2.0. Усі виклики в цій інструкції мають такий самий вигляд, змінюються лише модель, метод і властивості.
Створення накладної потребує більше, ніж здається. Методу InternetDocument/save потрібні посилання (Ref) на відправника, його адресу й контакт, а також на отримувача, його місто, склад і контактну особу. Дані відправника ви дістаєте один раз і кладете в змінні середовища. Отримувача сценарій створює для кожного замовлення. Склад у замовленні KeyCRM зберігає як UUID, місто склада підтягується запитом.
Послідовність викликів така.
Address/getWarehousesзRefскладу з замовлення повертаєCityRef, потрібний для поляCityRecipient. Цей запит працює без ключа, ми перевірили його 19.11.2026 на складі №1 у Києві.Counterparty/saveстворює отримувача:FirstName,LastName,Phone,CounterpartyTypeзі значеннямPrivatePersonіCounterpartyPropertyзі значеннямRecipient. Відповідь міститьRefотримувача іRefйого контактної особи.InternetDocument/saveстворює ТТН. Набір полів, який працює в реальних інтеграціях:Sender,CitySender,SenderAddress,ContactSender,SendersPhone,Recipient,CityRecipient,RecipientAddress,ContactRecipient,RecipientsPhone,DateTimeу форматідд.мм.рррр,CargoType,Weight,SeatsAmount,ServiceType,PayerType,PaymentMethod,Description. Додатково передаємоCost(оголошена вартість) і, якщо замовлення неоплачене,BackwardDeliveryDataз сумою післяплати. У відповідіdata[0].IntDocNumberце номер ТТН, аdata[0].Refідентифікатор документа.
Важливо чесно сказати, що ми бачили. Офіційну документацію developers.novaposhta.ua наш автоматичний інструмент відкрити не зміг (сервер відповів 403), тому склад полів InternetDocument/save ми звіряли з робочим інтеграційним тестом відкритої PHP-бібліотеки для API Нової пошти (проєкт sergeynezbritskiy/nova-poshta-api на GitHub) і з нашим досвідом. Метод Counterparty/save ми описуємо за документацією, яку знаємо, але з бойовим ключем його не запускали. Перед запуском звірте поля з актуальною документацією й прогоніть один тестовий документ з ключем вашого кабінету.
Крок 4: помилки, повтори, дублікати
Ось що ламає такі сценарії на практиці, і що в нашому JSON вже враховано.
Дублікат ТТН. KeyCRM може повторити вебхук. Сценарій після читання замовлення дивиться на shipping.tracking_code: якщо номер є, він зупиняється. Це ключова перевірка, її не можна викидати.
Нова пошта відхилила документ. Відповідь API має поле success. Якщо воно false, масив errors містить текст: не знайдено склад, телефон не в тому форматі, не заповнено обов'язкове поле. Сценарій не пише нічого в замовлення, а надсилає цей текст менеджерам у Telegram з номером замовлення. Мовчазні збої гірші за гучні.
Збої API. На HTTP-вузлах KeyCRM увімкнено повтор при помилці: три спроби з паузою. Для Нової пошти повторів лише два, бо повторний InternetDocument/save після таймауту теж може створити дубль, якщо перша відповідь просто не дійшла. Якщо ваш потік обробляє тисячі замовлень на добу, додайте перед створенням перевірку, чи немає вже документа з таким самим номером замовлення в InternetDocument/getDocumentList.
Падіння самого n8n. Задайте окремий сценарій помилок: у налаштуваннях сценарію вказується error workflow, який починається з вузла Error Trigger і отримує ідентифікатор виконання, текст помилки й останній виконаний вузол. Туди ж кладіть сповіщення в Telegram.
Вага. У нашому сценарії вага береться з поля weight товару, а якщо його немає, ставиться 0,5 кг на одиницю. Підлаштуйте це число під ваш асортимент, інакше Нова пошта перерахує тариф після звірки.
Статуси доставки
Другий сценарій питає Нову пошту про статуси відправлень пачками. Метод TrackingDocument/getStatusDocuments приймає масив документів {DocumentNumber, Phone} і повертає StatusCode та текст статусу Status. Ліміт на один запит сто документів: на сто першому API відповідає помилкою про максимум 100 елементів. Ми перевірили це живим запитом. Тому сценарій групує ТТН по сто.
Щоб не слати менеджерам однаковий статус щоразу, сценарій зберігає останній код для кожного ТТН у статичних даних сценарію й повідомляє лише про зміну. У сценарії стоять коди 7 («прибув у відділення») і 9 («отримано»), але з таблиці статусів документації ми їх не звіряли, бо документація для нашого інструмента закрита. Перевірте значення на тестовій посилці: в коді вони лежать в одному масиві, його легко змінити.
Для самого KeyCRM цей сценарій не обов'язковий: вона й так оновлює статуси, а зміна статусу замовлення за статусом доставки налаштовується у правилах. Другий сценарій потрібен для повідомлень: Telegram менеджеру, Telegram чи Viber клієнтові, виклик ШІ-кроку, що напише клієнту повідомлення у вашій манері.
Готовий сценарій для n8n
Нижче основний сценарій у форматі JSON. Скопіюйте його в файл і імпортуйте: у n8n меню сценарію, «Import from file». Ключі й паролі в ньому не зберігаються: усе береться зі змінних середовища ($env) і облікових даних, які ви створюєте самі. Заміни, які треба зробити, перелічено одразу після коду.
{
"name": "KeyCRM order -> Nova Poshta TTN -> tracking code + Telegram",
"nodes": [
{
"id": "w1",
"name": "KeyCRM webhook",
"type": "n8n-nodes-base.webhook",
"typeVersion": 2,
"position": [
0,
0
],
"webhookId": "keycrm-order-status",
"parameters": {
"httpMethod": "POST",
"path": "keycrm-order-status",
"authentication": "headerAuth",
"responseMode": "onReceived",
"options": {}
},
"credentials": {
"httpHeaderAuth": {
"id": "REPLACE_ME",
"name": "KeyCRM webhook secret"
}
}
},
{
"id": "w2",
"name": "Right status only",
"type": "n8n-nodes-base.code",
"typeVersion": 2,
"position": [
220,
0
],
"parameters": {
"jsCode": "// Keep only orders in the status that must get a TTN.\nconst body = $input.first().json.body || {};\nconst ctx = body.context || {};\nconst target = Number($env.KEYCRM_STATUS_READY_TO_SHIP || 0);\nif (body.event !== 'order.change_order_status' || Number(ctx.status_id) !== target) return [];\nreturn [{ json: { orderId: ctx.id } }];\n"
}
},
{
"id": "w3",
"name": "Get order from KeyCRM",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
440,
0
],
"parameters": {
"method": "GET",
"url": "=https://openapi.keycrm.app/v1/order/{{ $json.orderId }}",
"sendQuery": true,
"queryParameters": {
"parameters": [
{
"name": "include",
"value": "buyer,products.offer,shipping,payments"
}
]
},
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"options": {}
},
"credentials": {
"httpHeaderAuth": {
"id": "REPLACE_ME",
"name": "KeyCRM API (Bearer)"
}
},
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 5000
},
{
"id": "w4",
"name": "Build TTN payload",
"type": "n8n-nodes-base.code",
"typeVersion": 2,
"position": [
660,
0
],
"parameters": {
"jsCode": "// Build the Nova Poshta InternetDocument/save payload from a KeyCRM order.\nconst order = $input.first().json;\nconst buyer = order.buyer || {};\nconst ship = order.shipping || {};\nconst items = order.products || [];\nconst total = Number(order.grand_total || 0);\nconst cod = order.payment_status === 'paid' ? 0 : Math.max(total - Number(order.total_paid || 0), 0);\n\nif (ship.tracking_code) {\n return [{ json: { skip: true, reason: 'TTN already exists', orderId: order.id } }];\n}\nif (!ship.shipping_receive_point && !ship.warehouse_ref) {\n throw new Error('Order ' + order.id + ': no Nova Poshta warehouse in the order');\n}\nconst d = new Date();\nconst props = {\n PayerType: 'Recipient',\n PaymentMethod: 'Cash',\n CargoType: 'Cargo',\n ServiceType: 'WarehouseWarehouse',\n SeatsAmount: String(Math.max(items.length, 1)),\n Weight: String(Math.max(items.reduce((s, p) => s + Number(p.weight || 0.5) * Number(p.quantity || 1), 0), 0.1)),\n Description: items.map(p => p.name).join(', ').slice(0, 100) || 'Замовлення',\n Cost: String(Math.round(total)),\n RecipientsPhone: (ship.recipient_phone || buyer.phone || '').replace(/\\D/g, ''),\n RecipientAddress: ship.warehouse_ref,\n DateTime: [String(d.getDate()).padStart(2, '0'), String(d.getMonth() + 1).padStart(2, '0'), d.getFullYear()].join('.')\n};\nif (cod > 0) props.BackwardDeliveryData = [{ PayerType: 'Recipient', CargoType: 'Money', RedeliveryString: String(Math.round(cod)) }];\nconst parts = String(ship.recipient_full_name || buyer.full_name || '').trim().split(/\\s+/);\nreturn [{ json: { orderId: order.id, firstName: parts[0] || '-', lastName: parts.slice(1).join(' ') || '-', phone: props.RecipientsPhone, warehouseRef: ship.warehouse_ref, np: props } }];\n"
}
},
{
"id": "w5",
"name": "Skip if TTN exists",
"type": "n8n-nodes-base.if",
"typeVersion": 2,
"position": [
880,
0
],
"parameters": {
"conditions": {
"options": {
"caseSensitive": true,
"typeValidation": "loose"
},
"combinator": "and",
"conditions": [
{
"id": "c1",
"leftValue": "={{ $json.skip }}",
"rightValue": true,
"operator": {
"type": "boolean",
"operation": "notEquals"
}
}
]
},
"options": {}
}
},
{
"id": "w5a",
"name": "Nova Poshta: warehouse -> city",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
1100,
-100
],
"parameters": {
"method": "POST",
"url": "https://api.novaposhta.ua/v2.0/json/",
"sendBody": true,
"specifyBody": "json",
"jsonBody": "={{ JSON.stringify({ apiKey: $env.NOVA_POSHTA_API_KEY, modelName: 'Address', calledMethod: 'getWarehouses', methodProperties: { Ref: $json.warehouseRef, Language: 'UA' } }) }}",
"options": {}
},
"retryOnFail": true,
"maxTries": 2,
"waitBetweenTries": 3000
},
{
"id": "w5b",
"name": "Nova Poshta: create recipient",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
1320,
-100
],
"parameters": {
"method": "POST",
"url": "https://api.novaposhta.ua/v2.0/json/",
"sendBody": true,
"specifyBody": "json",
"jsonBody": "={{ JSON.stringify({ apiKey: $env.NOVA_POSHTA_API_KEY, modelName: 'Counterparty', calledMethod: 'save', methodProperties: { FirstName: $('Build TTN payload').first().json.firstName, LastName: $('Build TTN payload').first().json.lastName, Phone: $('Build TTN payload').first().json.phone, CounterpartyType: 'PrivatePerson', CounterpartyProperty: 'Recipient' } }) }}",
"options": {}
},
"retryOnFail": true,
"maxTries": 2,
"waitBetweenTries": 3000
},
{
"id": "w6",
"name": "Nova Poshta: create TTN",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
1540,
-100
],
"parameters": {
"method": "POST",
"url": "https://api.novaposhta.ua/v2.0/json/",
"sendBody": true,
"specifyBody": "json",
"jsonBody": "={{ JSON.stringify({ apiKey: $env.NOVA_POSHTA_API_KEY, modelName: 'InternetDocument', calledMethod: 'save', methodProperties: Object.assign({ Sender: $env.NP_SENDER_REF, CitySender: $env.NP_CITY_SENDER_REF, SenderAddress: $env.NP_SENDER_WAREHOUSE_REF, ContactSender: $env.NP_CONTACT_SENDER_REF, SendersPhone: $env.NP_SENDER_PHONE, CityRecipient: $('Nova Poshta: warehouse -> city').first().json.data[0].CityRef, Recipient: $json.data[0].Ref, ContactRecipient: $json.data[0].ContactPerson.data[0].Ref }, $('Build TTN payload').first().json.np) }) }}",
"options": {}
},
"retryOnFail": true,
"maxTries": 2,
"waitBetweenTries": 3000
},
{
"id": "w7",
"name": "TTN created?",
"type": "n8n-nodes-base.if",
"typeVersion": 2,
"position": [
1760,
-100
],
"parameters": {
"conditions": {
"options": {
"caseSensitive": true,
"typeValidation": "loose"
},
"combinator": "and",
"conditions": [
{
"id": "c2",
"leftValue": "={{ $json.success }}",
"rightValue": true,
"operator": {
"type": "boolean",
"operation": "true"
}
}
]
},
"options": {}
}
},
{
"id": "w8",
"name": "Write TTN number to KeyCRM",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
1980,
-200
],
"parameters": {
"method": "PUT",
"url": "=https://openapi.keycrm.app/v1/order/{{ $('Right status only').first().json.orderId }}",
"sendBody": true,
"specifyBody": "json",
"jsonBody": "={{ JSON.stringify({ shipping: { delivery_service_id: Number($env.KEYCRM_NP_DELIVERY_SERVICE_ID), tracking_code: $json.data[0].IntDocNumber } }) }}",
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"options": {}
},
"credentials": {
"httpHeaderAuth": {
"id": "REPLACE_ME",
"name": "KeyCRM API (Bearer)"
}
},
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 5000
},
{
"id": "w9",
"name": "Telegram: TTN ready",
"type": "n8n-nodes-base.telegram",
"typeVersion": 1.2,
"position": [
2200,
-200
],
"parameters": {
"chatId": "={{ $env.TELEGRAM_MANAGERS_CHAT_ID }}",
"text": "=TTN {{ $('Nova Poshta: create TTN').first().json.data[0].IntDocNumber }} created for order #{{ $('Right status only').first().json.orderId }}",
"additionalFields": {
"appendAttribution": false
}
},
"credentials": {
"telegramApi": {
"id": "REPLACE_ME",
"name": "Telegram bot"
}
}
},
{
"id": "w10",
"name": "Telegram: problem",
"type": "n8n-nodes-base.telegram",
"typeVersion": 1.2,
"position": [
1980,
0
],
"parameters": {
"chatId": "={{ $env.TELEGRAM_MANAGERS_CHAT_ID }}",
"text": "=Nova Poshta rejected the TTN for order #{{ $('Right status only').first().json.orderId }}: {{ ($json.errors || []).join('; ') }}",
"additionalFields": {
"appendAttribution": false
}
},
"credentials": {
"telegramApi": {
"id": "REPLACE_ME",
"name": "Telegram bot"
}
}
}
],
"connections": {
"KeyCRM webhook": {
"main": [
[
{
"node": "Right status only",
"type": "main",
"index": 0
}
]
]
},
"Right status only": {
"main": [
[
{
"node": "Get order from KeyCRM",
"type": "main",
"index": 0
}
]
]
},
"Get order from KeyCRM": {
"main": [
[
{
"node": "Build TTN payload",
"type": "main",
"index": 0
}
]
]
},
"Build TTN payload": {
"main": [
[
{
"node": "Skip if TTN exists",
"type": "main",
"index": 0
}
]
]
},
"Skip if TTN exists": {
"main": [
[
{
"node": "Nova Poshta: warehouse -> city",
"type": "main",
"index": 0
}
],
[]
]
},
"Nova Poshta: warehouse -> city": {
"main": [
[
{
"node": "Nova Poshta: create recipient",
"type": "main",
"index": 0
}
]
]
},
"Nova Poshta: create recipient": {
"main": [
[
{
"node": "Nova Poshta: create TTN",
"type": "main",
"index": 0
}
]
]
},
"Nova Poshta: create TTN": {
"main": [
[
{
"node": "TTN created?",
"type": "main",
"index": 0
}
]
]
},
"TTN created?": {
"main": [
[
{
"node": "Write TTN number to KeyCRM",
"type": "main",
"index": 0
}
],
[
{
"node": "Telegram: problem",
"type": "main",
"index": 0
}
]
]
},
"Write TTN number to KeyCRM": {
"main": [
[
{
"node": "Telegram: TTN ready",
"type": "main",
"index": 0
}
]
]
}
},
"settings": {
"executionOrder": "v1"
}
}Що потрібно налаштувати перед запуском:
- облікові дані «KeyCRM API (Bearer)»: тип Header Auth, ім'я
Authorization, значенняBearer ВАШ_КЛЮЧ; - облікові дані «KeyCRM webhook secret»: Header Auth з будь-яким власним заголовком, його ж додайте в тригер KeyCRM;
- облікові дані «Telegram bot»: токен бота від BotFather;
- змінні середовища:
NOVA_POSHTA_API_KEY,NP_SENDER_REF,NP_CITY_SENDER_REF,NP_SENDER_WAREHOUSE_REF,NP_CONTACT_SENDER_REF,NP_SENDER_PHONE,KEYCRM_STATUS_READY_TO_SHIP(номер статусу «Готово до відправки»),KEYCRM_NP_DELIVERY_SERVICE_IDіTELEGRAM_MANAGERS_CHAT_ID; - у n8n доступ до
$envможе бути закритий налаштуваннями екземпляра. Якщо у виразах порожньо, перевірте параметрN8N_BLOCK_ENV_ACCESS_IN_NODE: він може забороняти вузлам читати змінні середовища.
Дані відправника (Sender, адресу, контакт) дістаньте з уже створеного в кабінеті документа: така порада є і в тестах відкритої бібліотеки, бо створювати їх з нуля незручно.
Другий сценарій, який стежить за статусами, ми дали в тому ж форматі.
{
"name": "Nova Poshta tracking -> Telegram to manager",
"nodes": [
{
"id": "t1",
"name": "Every 30 minutes",
"type": "n8n-nodes-base.scheduleTrigger",
"typeVersion": 1.2,
"position": [
0,
0
],
"parameters": {
"rule": {
"interval": [
{
"field": "minutes",
"minutesInterval": 30
}
]
}
}
},
{
"id": "t2",
"name": "KeyCRM: shipped orders",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
220,
0
],
"parameters": {
"method": "GET",
"url": "https://openapi.keycrm.app/v1/order",
"sendQuery": true,
"queryParameters": {
"parameters": [
{
"name": "include",
"value": "buyer,shipping"
},
{
"name": "limit",
"value": "50"
},
{
"name": "filter[status_id]",
"value": "={{ $env.KEYCRM_STATUS_SHIPPED }}"
}
]
},
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"options": {}
},
"credentials": {
"httpHeaderAuth": {
"id": "REPLACE_ME",
"name": "KeyCRM API (Bearer)"
}
},
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 5000
},
{
"id": "t3",
"name": "Group TTNs",
"type": "n8n-nodes-base.code",
"typeVersion": 2,
"position": [
440,
0
],
"parameters": {
"jsCode": "// Collect TTNs of orders in 'shipped' status; keep batches of up to 100 (Nova Poshta limit).\nconst orders = $input.all().flatMap(i => i.json.data || []);\nconst docs = orders.filter(o => o.shipping && o.shipping.tracking_code)\n .map(o => ({ DocumentNumber: o.shipping.tracking_code, Phone: '', orderId: o.id, buyer: o.buyer && o.buyer.full_name }));\nconst out = [];\nfor (let i = 0; i < docs.length; i += 100) out.push({ json: { batch: docs.slice(i, i + 100) } });\nreturn out;\n"
}
},
{
"id": "t4",
"name": "Nova Poshta: statuses",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [
660,
0
],
"parameters": {
"method": "POST",
"url": "https://api.novaposhta.ua/v2.0/json/",
"sendBody": true,
"specifyBody": "json",
"jsonBody": "={{ JSON.stringify({ apiKey: $env.NOVA_POSHTA_API_KEY, modelName: 'TrackingDocument', calledMethod: 'getStatusDocuments', methodProperties: { Documents: $json.batch.map(d => ({ DocumentNumber: d.DocumentNumber, Phone: d.Phone })) } }) }}",
"options": {}
},
"retryOnFail": true,
"maxTries": 3,
"waitBetweenTries": 5000
},
{
"id": "t5",
"name": "What changed",
"type": "n8n-nodes-base.code",
"typeVersion": 2,
"position": [
880,
0
],
"parameters": {
"jsCode": "// Notify only when the status code is new for this TTN (state kept in workflow static data).\nconst sd = $getWorkflowStaticData('global');\nsd.seen = sd.seen || {};\nconst batch = $('Group TTNs').first().json.batch;\nconst res = $input.first().json.data || [];\nconst out = [];\nfor (const r of res) {\n const prev = sd.seen[r.Number];\n if (prev === r.StatusCode) continue;\n sd.seen[r.Number] = r.StatusCode;\n if (prev === undefined && r.StatusCode !== '7') continue; // first sight: remember silently\n if (['7', '9'].includes(r.StatusCode)) {\n const o = batch.find(b => b.DocumentNumber === r.Number) || {};\n out.push({ json: { orderId: o.orderId, ttn: r.Number, code: r.StatusCode, status: r.Status } });\n }\n}\nreturn out;\n"
}
},
{
"id": "t6",
"name": "Telegram: delivery update",
"type": "n8n-nodes-base.telegram",
"typeVersion": 1.2,
"position": [
1100,
0
],
"parameters": {
"chatId": "={{ $env.TELEGRAM_MANAGERS_CHAT_ID }}",
"text": "=Order #{{ $json.orderId }}: {{ $json.status }} (TTN {{ $json.ttn }})",
"additionalFields": {
"appendAttribution": false
}
},
"credentials": {
"telegramApi": {
"id": "REPLACE_ME",
"name": "Telegram bot"
}
}
}
],
"connections": {
"Every 30 minutes": {
"main": [
[
{
"node": "KeyCRM: shipped orders",
"type": "main",
"index": 0
}
]
]
},
"KeyCRM: shipped orders": {
"main": [
[
{
"node": "Group TTNs",
"type": "main",
"index": 0
}
]
]
},
"Group TTNs": {
"main": [
[
{
"node": "Nova Poshta: statuses",
"type": "main",
"index": 0
}
]
]
},
"Nova Poshta: statuses": {
"main": [
[
{
"node": "What changed",
"type": "main",
"index": 0
}
]
]
},
"What changed": {
"main": [
[
{
"node": "Telegram: delivery update",
"type": "main",
"index": 0
}
]
]
}
},
"settings": {
"executionOrder": "v1"
}
}Йому потрібні ті самі облікові дані та змінні, плюс KEYCRM_STATUS_SHIPPED (номер статусу «Відправлено»).
Те саме в Make
У Make схема та сама, відрізняються вузли. Вебхук приймає модуль Webhooks (Custom webhook), запити до KeyCRM і Нової пошти робить модуль HTTP «Make a request», розгалуження на «статус потрібний» і «ТТН уже є» робить Router з фільтрами, а помилки обробляють модулі Break, Resume, Rollback і Ignore. Окремий сценарій для статусів запускається за розкладом.
Різниця в трьох місцях. Перша: Make рахує кредити за кожну дію, тому основний сценарій з десятьма модулями на замовлення витрачає близько десяти кредитів, а n8n рахує весь запуск як один. Для відправлень на сотні замовлень на день різниця в рахунку відчутна, детальний розрахунок на трьох типових сценаріях є в нашому порівнянні n8n чи Make. Друга: у Make вебхук і відповідь налаштовуються модулем «Webhook response», а відповідь 2xx за 10 секунд теж обов'язкова. Третя: готового експорту Make-сценарію для цієї сторінки ми не публікуємо, бо не запускали його на живому акаунті Make, а чужі нерозібрані блюпринти для процесу з грошима брати не радимо.
Перевірка: що ми справді запускали
Для чесності розкладемо, що перевірено, а що ні.
Перевірено: обидва JSON імпортуються у n8n 2.47.7 без помилок; код у вузлах Code ми прогнали на тестових даних (фільтр статусу, побудова ТТН, пачки по 100); живі запити до API Нової пошти без ключа підтвердили формат запиту, ліміт 100 документів у getStatusDocuments і відповідь getWarehouses із CityRef; формати KeyCRM звірено з її OpenAPI-документацією й довідкою про вебхуки.
Не перевірено: створення реальної ТТН (потрібен ключ вашого кабінету й справжній відправник) і запис у реальну KeyCRM (потрібен ваш ключ). Тому сценарій треба спершу прогнати на одному тестовому замовленні.
Скільки це коштує
Є три шляхи. Перший: зробити самому за цією сторінкою. Потрібен n8n Cloud за підпискою або власний сервер, ключі API й людина, що вміє читати відповіді HTTP API. За публічною сторінкою цін n8n станом на 19.11.2026 план Starter коштує 20 EUR на місяць при оплаті за рік і дає 2 500 запусків, Pro 50 EUR на місяць і 10 000 запусків; власний сервер без ліцензійної плати, але з вашим часом на оновлення й резервні копії.
Другий: доручити нам. Мінімальний проєкт у Lytvynov Production становить 10 000 USD, і окремо сценарій на кілька вузлів ми не продаємо. Чесно: якщо вам потрібен лише цей один сценарій, дешевше віддати цю сторінку своєму розробникові чи фрілансеру. Якщо ж доставка є частиною більшої автоматизації, де є ще замовлення, оплати, ШІ-відповіді клієнтам чи власні ноди, ми беремося за весь обсяг на n8n за фіксованою ціною.
Третій: власний сервіс замість сценаріїв. Коли замовлень тисячі на день, а помилки в накладних коштують дорого, ми будуємо невеликий сервіс із чергою й екраном ручної перевірки. Приклад такого підходу в нашій роботі: сервіс квіткових підписок із викликом кур'єра Uklon Delivery, де статуси кур'єра рухають замовлення без участі людини. Про вибір між no-code і кодом є окремий розділ у порівнянні n8n і Make.
Джерела, перевірені 19.11.2026: KeyCRM OpenAPI, налаштування вебхуків KeyCRM, створення ТТН у KeyCRM, автозміна статусу за статусом доставки, API Нової пошти, вебхук-нода n8n, обробка помилок в n8n.