# Prom.ua + Krokul CRM

Так. Krokul CRM інтегрується з Prom.ua і забирає нові замовлення з кабінету токеном API. Замовлення стає угодою з товарами вашого каталогу, а покупець стає контактом. Етап угоди змінює статус замовлення в Prom, номер ТТН з Krokul потрапляє в замовлення, а повідомлення покупців видно в стрічці контакту.

**Статус:** Через API і вебхуки.

## Що отримує команда

### Замовлення з Prom як угода з товарами

Krokul кожні кілька хвилин читає /orders/list і створює угоду з кожного нового замовлення. Товари зіставляються з каталогом Krokul за артикулом, ціна береться з замовлення, а джерелом угоди стає «Prom.ua». Номер замовлення стає зовнішнім ключем угоди, тож повторне опитування не створює дубль.

### Покупець знаходиться за телефоном

Телефон і email з замовлення Krokul звіряє з контактами. Постійний покупець отримує нову угоду у своїй картці, а дані нового Krokul дочитує методом /clients/{id} і створює контакт.

### Етап угоди змінює статус у Prom

Менеджер переводить угоду на інший етап, і Krokul викликає /orders/set_status з відповідним статусом Prom. Відповідність етапів і статусів ви задаєте в налаштуваннях підключення зі списку /order_status_options/list вашого кабінету.

### Номер ТТН потрапляє в замовлення

Коли для угоди створено ТТН Нової пошти, Krokul передає її номер у Prom методом /delivery/save_declaration_id. Покупець бачить номер відправлення у своєму замовленні на Prom, коли посилка ще в дорозі, і менеджер не вводить його двічі.

### Повідомлення покупців поруч з угодою

Krokul забирає нові повідомлення методом /messages/list і пише їх у стрічку контакту. Відповідь менеджера з Krokul іде покупцю методом /messages/reply.

## Що передається між системами

| Prom.ua | Krokul | Напрям | Коли |
|---|---|---|---|
| Замовлення (/orders/list) | Угода з джерелом «Prom.ua» і зовнішнім ключем | Prom.ua → Krokul | Опитування за розкладом |
| Товари замовлення | Рядки угоди з товарами каталогу за артикулом | Prom.ua → Krokul | Разом з угодою |
| Покупець (/clients/{id}) | Контакт: знайдений або новий | Prom.ua → Krokul | Разом з угодою |
| Статус замовлення (/orders/set_status) | Етап угоди | Krokul → Prom.ua | Зміна етапу угоди |
| Номер декларації (/delivery/save_declaration_id) | ТТН у картці угоди | Krokul → Prom.ua | Після створення ТТН |
| Повідомлення (/messages/list, /messages/reply) | Стрічка контакту | Prom.ua ↔ Krokul | Опитування й відповідь менеджера |

## Як підключити сьогодні

### Власний потік через API і вебхуки Krokul

1. У кабінеті Prom відкрийте «Налаштування» → «Управління API-токенами» і створіть токен з правами на замовлення, клієнтів і повідомлення.
2. У Krokul створіть ключ API зі scope на угоди й контакти. Покупця з замовлення шукайте через `contact/api-find` за телефоном чи email, нового заводьте через `contact/api-create`.
3. Кожне нове замовлення з /orders/list записуйте угодою через `card/api-create`, а номер замовлення тримайте ключем угоди через `externalRef/api-upsert`, тоді повторне опитування не дасть дубля.
4. Підпишіть вебхук на `card.statusChanged` з фільтром за воронкою й на кожну доставку з перевіреним `x-crm-signature` викликайте /orders/set_status у Prom.

### Для інтеграторів

Специфікація API Prom відкрита у форматі OpenAPI, а токен Prom має права за методами. Угоди з Prom проходять у Krokul тим самим шляхом, що й створені вручну. Якщо склад чи облік чекають сигналу, подія `card.statusChanged` з фільтром за воронкою приходить до них підписаним вебхуком. Зовнішній ключ замовлення читає `externalRef/api-readList`.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи є в Krokul інтеграція з Prom.ua?

Так. Krokul інтегрується з Prom.ua через свій API і вебхуки. Krokul забирає замовлення Prom в угоди з товарами, повертає в Prom статус і номер ТТН і показує повідомлення покупців у стрічці контакту.

### Як швидко замовлення з Prom з’являється в Krokul?

Після найближчого опитування, зазвичай за кілька хвилин. Prom не надсилає вебхуків, тому Krokul сам перепитує кабінет і забирає все, що надійшло після попереднього запиту.

### Де взяти токен API Prom?

У кабінеті Prom, шлях «Налаштування» → «Управління API-токенами» → «Створити токен». Prom нагадує про завершення строку дії за 30 і за 7 днів.

### Що буде, якщо товару з замовлення Prom немає в каталозі Krokul?

Рядок угоди створюється з назвою й ціною з замовлення, а в журналі підключення з’являється позначка про незіставлений артикул.

## Обмеження

Prom сам називає свій публічний API закритою бета-версією і не надсилає вебхуків, тому Krokul опитує замовлення за розкладом. Токен діє щонайбільше рік, і його треба поновити в кабінеті до завершення строку.

## Пов’язані сервіси

- [Rozetka](https://krokul.com/uk/integrations/rozetka/index.md)
- [Хорошоп](https://krokul.com/uk/integrations/horoshop/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)
- [Checkbox](https://krokul.com/uk/integrations/checkbox/index.md)
- [WooCommerce](https://krokul.com/uk/integrations/woocommerce/index.md)

[Маркетплейси й магазини (Україна)](https://krokul.com/uk/integrations/category/marketplaces-ua/index.md)

Prom.ua є торговою маркою її власника. Krokul не афілійований з Prom.ua.

Оновлено: 2026-10-12

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs