HelomiWIKI

OLX

Інтеграція з OLX через Partner API приносить переписки з покупцями в «Переписки», дає створити угоду з розмови «OLX Доставки» і оновлювати оголошення й ціни зі складу. Окремого списку замовлень Partner API OLX не віддає, тому угода з'являється з переписки, а не опитуванням, як у Prom чи Rozetka.

6 хвОновлено 20.10.2026
Markdown для ШІ
На цій сторінці

Можливості

  • Підключення акаунта OLX через Partner API; токен оновлюється сам, картка показує, скільки днів він ще дійсний.
  • Переписки з покупцями — у «Переписках»; стан полера видно в картці.
  • Угода з переписки: ім'я й телефон покупця, оголошення, товар за артикулом; повторно з тієї самої розмови угода не дублюється.
  • Джерело, відповідальний, чати й оператори, автоматична ТТН на етапах, зв'язок товарів.
  • Оновлення оголошень і цін зі складу.

1Налаштування

Підключає адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Маркетплейси» → картка «OLX» → «Підключення».

  1. Ключі застосунку OLX Partner API: «Client ID» і «Client secret» → «Ввести» → «Зберегти ключ». Їх видає OLX, коли ви реєструєте застосунок у партнерській програмі.
  2. Сам акаунт OLX підключається кнопкою «Підключити OLX» у «Переписках» → «Стан каналів» (вхід в OLX і дозвіл доступу).
  3. «Перевірити» читає профіль: успіх — «акаунт: <ім'я>»; якщо OLX не підключено — підказка, куди натиснути.
  4. «Стан роботи»: «Підключення OLX» (підключено / не підключено), «Акаунт», «Токен дійсний ще N дн.», «Полер «Переписок»».

Кількох акаунтів OLX поки нема — одна картка на організацію.

2Угода з переписки OLX

Угоду створює менеджер з розмови «OLX Доставки» в «Переписках». CRM бере ім'я й телефон покупця, оголошення (назву, ціну) і шукає товар: за артикулом, потім за додатковим полем товару «Оголошення на ОЛХ», потім за списком оголошень ШІ Віки; не знайшла — вільна позиція з назвою оголошення. В угоді з'являються поля olx_order_id (за ним повтор не дублюється), olx_advert_id, olx_conversation_id.

Де саме кнопка створення угоди в «Переписках» —.

3Налаштування продажів OLX

Вкладка «Налаштування продажів»: «Основне» («Увімкнути інтеграцію», «Джерело угод», «Відповідальний»), «Нові замовлення» («Автоприйняття», «Зв'язувати товари по»), «Чати» («Чати про товари», «Чати про замовлення», «Оператори», «Відкрити переписки →»), «Автоматична відправка ТТН». «Пов'язаних статусів» нема: статусів замовлень API OLX не віддає. Унизу — «Зберегти».

4Оголошення і ціни

«Підключення» → «Стан роботи» → «Оновлення товарів»: автоматично чи вручну оновлюються оголошення зі складу; «Оновити зараз». Ціни оголошень веде ШІ Віка.

Віка також виправляє текст опису оголошення точними замінами (наприклад, артикул кольору, щоб оголошення збігалося зі складом): бере оголошення з OLX, міняє лише вказані фрагменти, ціну й решту полів лишає як були, і пише зміну в свій журнал. Якщо фрагмента в описі нема або він трапляється кілька разів, оголошення не чіпається.

«Виставити на OLX» (програма Віки): вибрані оголошення, які OLX вимкнув (закінчився ліміт, термін, не оплачено), Віка вмикає знову. Спершу розрахунок без витрат: які оголошення можна увімкнути (на модерації, заблоковані тощо — пропускаються з поясненням), скільки слотів уже є в куплених пакетах, що докупити — найдешевша комбінація з живого прайсу OLX (пакети від 3 і окремі розміщення: 4 оголошення — пакет на 3 + 1 окремо, а не два пакети), сума, баланс рахунку OLX і чого не вистачає. Ціну окремого розміщення OLX наперед не каже: поки її не знаємо — оцінка «≈» (половина пакета на 3), після першої покупки в категорії — точна. Купити й увімкнути може лише власник або адміністратор: сума має збігтися з підтвердженою, за раз — не більше 20 000 грн; гроші справжні. Кожен прогін — у журналі (що куплено, що увімкнено, що не вдалося); прогін, обірваний рестартом, позначається «перервано — перевірте кабінет OLX».

5Блок «OLX» в угоді

У картці угоди з джерелом OLX є блок «OLX (<джерело>)» з даними, що прийшли з переписки (olx_*); чого нема — «…». ID показується без посилання: окремої сторінки замовлення в кабінеті OLX Partner API не дає. «?» у заголовку блоку відкриває цю статтю у шторці.

Фінанси каналу: нарахування, комісія, виплата (16.10)

Гроші ОЛХ у «Фінансах» — правило каналу у ФінансиЗвірка«Фінанси → Звірка» → рядок «ОЛХ» (кожен акаунт — своє правило; типово вимкнено). Увімкнене правило в момент «гроші наші» (при замовленні, коли угода виграна чи на вибраних етапах) проводить дохід угоди в транзитний гаманець «Транзит · ОЛХ» (угода стає «сплаченою») і комісію майданчика витратою по угоді; угода скасована — сторно. Заготовка комісії: 20 грн + 3 % від суми угоди лише при оплаті через ОЛХ Доставку (поле «Спосіб оплати» містить «ОЛХ дост…», служба доставки ОЛХ або checkbox UAPay); комісію, яку надсилає ШІ Едуард, проведено одразу точною сумою, а табличка комісій ОЛХ Марії вже не просить «записати витратою». Виплата ОЛХ на рахунок — правило імпорту «Виплата каналу» або кнопка у «Вхідних»: переказ, а не другий дохід; баланс транзитного гаманця — скільки ОЛХ ще винен. Докладно — стаття «Фінанси», розділ 7а.

З 20.10 увімкнено: «Транзит · ОЛХ». Угоду ОЛХ Доставки, яку ШІ Едуард заводить через Telegram (джерело угоди «ОЛХ»), «Фінанси» вважають каналом ОЛХ. Дохід — коли угода виграна, лише при ОЛХ Доставці; комісія — точна від Едуарда або 20 грн + 3 %, одразу при замовленні з того самого транзиту. Виплата «ЮАПЕЙ» («…OLX.1» — це ОЛХ Доставка, не Prom) — переказ із транзиту сам.

Можливі помилки

Що ви бачитеЧомуЩо зробити
«OLX не підключено — «Переписки» → «Стан каналів» → «Підключити OLX»»Акаунт OLX не авторизованоПідключіть у «Переписках»
«не задано (у картці чи .env): OLX_PARTNER_CLIENT_ID, OLX_PARTNER_CLIENT_SECRET»Ключі застосунку не введеноВведіть «Client ID» і «Client secret»
«OLX не віддав профіль»OLX відповів без данихПерепідключіть OLX і перевірте знову
«Полер «Переписок»: помилка …»Збій отримання переписокПодивіться текст помилки, перепідключіть OLX

Для ШІ-співробітників

5). ШІ бачить угоди з OLX у «Угодах» (deals_list, deals_get): джерело і поля olx_order_id, olx_advert_id, olx_conversation_id. Статтю ШІ читає інструментом help("int-olx")`.

Додаткова інформація

Цю саму статтю читають ШІ-співробітники Helomi: help("int-olx")