# OLX + Krokul CRM

Так. Krokul CRM інтегрується з OLX через Partner API для бізнес-акаунтів продавців. Повідомлення покупця під вашим оголошенням стає розмовою в «Комунікаціях» Krokul, контактом і угодою, а менеджер відповідає з Krokul у той самий тред OLX. Оголошення OLX публікуються й оновлюються з товарів каталогу Krokul і знімаються, коли товар продано.

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

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

### Питання під оголошенням стає угодою

Krokul читає /threads і бере треди з непрочитаними повідомленнями. Новий тред з покупцем стає розмовою в «Комунікаціях», а співрозмовник за interlocutor_id стає контактом з ім’ям з /users/{id}. Угода отримує назву оголошення з advert_id і джерело OLX, тож продавець бачить, які оголошення приводять покупців.

### Відповідь з Krokul у той самий тред

Менеджер відповідає покупцю у вікні розмови Krokul, і текст іде в OLX через POST /threads/{threadId}/messages. Після прочитання Krokul надсилає команду mark-as-read, тому лічильник непрочитаних у кабінеті OLX збігається з Krokul. Уся переписка лишається в картці контакту поруч із дзвінками й листами.

### Оголошення з картки товару

Назва, опис, ціна й фото живуть у каталозі Krokul. Для нового товару Krokul створює оголошення через POST /adverts з атрибутами категорії з /categories/{categoryId}/attributes, а зміну ціни передає в PUT /adverts/{advertId}. Ідентифікатор оголошення Krokul зберігає як зовнішній ключ товару.

### Товар продано, оголошення знято

Коли угода виграна й залишок товару дійшов до нуля, Krokul надсилає команду deactivate з is_success, і оголошення OLX більше не приймає питань. Товар повернувся на склад, і команда activate знову відкриває оголошення.

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

| OLX | Krokul | Напрям | Коли |
|---|---|---|---|
| Тред (/threads): advert_id, interlocutor_id, unread_count | Розмова в «Комунікаціях» і угода | OLX → Krokul | Новий тред або непрочитане повідомлення |
| Повідомлення треду (/threads/{threadId}/messages) | Повідомлення в розмові | OLX ↔ Krokul | Покупець пише або менеджер відповідає |
| Користувач (/users/{id}) | Контакт з ім’ям | OLX → Krokul | Перше повідомлення від людини |
| Команда треду mark-as-read | Прочитана розмова | Krokul → OLX | Менеджер відкрив розмову |
| Оголошення (POST /adverts, PUT /adverts/{advertId}) | Товар каталогу із зовнішнім ключем | Krokul → OLX | Новий товар або зміна ціни й опису |
| Команди оголошення activate, deactivate | Залишок товару, виграна угода | Krokul → OLX | Товар закінчився або повернувся на склад |
| Статистика оголошення (/adverts/{advertId}/statistics) | Картка товару | OLX → Krokul | Опитування за розкладом |

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

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

1. Увійдіть на developer.olx.ua з акаунтом OLX, натисніть «Підключити додаток», заповніть форму й дочекайтесь листа про підтвердження з Client ID і Client Secret.
2. Авторизуйте застосунок бізнес-акаунтом продавця за authorization_code зі scope v2 read write. Токен client_credentials дає лише довідники, оголошень і повідомлень він не відкриває.
3. У Krokul створіть ключ API зі scope на контакти, угоди й активності. Новий тред з /threads передайте в `contact/api-create` і `card/api-create`, ідентифікатор треду збережіть через `externalRef/api-upsert`, а повідомлення пишіть у стрічку через `activity/api-create`.
4. Підпишіть вебхук Krokul на `card.won`, перевіряйте заголовок `x-crm-signature` і знімайте оголошення командою deactivate.

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

OLX Partner API працює з OAuth 2.0 і заголовком Version зі значенням 2.0, а пара Client ID і Client Secret діє лише для однієї країни OLX. З боку Krokul зв’язку тримають публічний API, вебхуки з підписом HMAC-SHA256 і журналом доставок та зовнішні ключі `externalRef` для угод, контактів і товарів. Логіку потоку можна перевірити в пісочниці Krokul на демо-компанії.

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

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

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

Так. Повідомлення покупців з OLX стають розмовами, контактами й угодами в Krokul, менеджер відповідає з Krokul, а оголошення публікуються й знімаються з товарів каталогу.

### Чи можна через Krokul керувати оголошеннями іншого продавця на OLX?

Ні. OLX відкриває доступ лише до оголошень акаунта, який авторизував застосунок.

### Чи є в OLX тестове середовище для перевірки потоку?

Ні. OLX не надає тестового середовища API і радить перевіряти інтеграцію на окремому акаунті OLX.

### Як часто Krokul перевіряє нові повідомлення OLX?

За розкладом і в межах ліміту OLX у 4500 запитів за п’ять хвилин з однієї IP-адреси. Перевищення блокує запити на 30 хвилин, тому Krokul читає лише треди з непрочитаними повідомленнями.

## Обмеження

OLX не надсилає подій про нові повідомлення, тому Krokul перевіряє треди за розкладом. Partner API дозволяє щонайбільше 4500 запитів за п’ять хвилин з однієї IP-адреси, а доступ стосується лише оголошень акаунта, який авторизував застосунок.

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

- [Prom.ua](https://krokul.com/uk/integrations/prom-ua/index.md)
- [Rozetka](https://krokul.com/uk/integrations/rozetka/index.md)
- [Епіцентр](https://krokul.com/uk/integrations/epicentr/index.md)
- [Telegram](https://krokul.com/uk/integrations/telegram/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)

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

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

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

---

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