OLX

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

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

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

Кілька кабінетів OLX — розділ «1б».

1аПідключити кабінет OLX

Кабінет OLX підключається кнопкою в самій картці — і основний, і кожен додатковий (акаунт). Після входу на сторінці OLX браузер повертається в картку, а переписки цього кабінету починають приходити в «Переписки» з його підписом.

1. Відкрийте Налаштування›Інтеграції й автоматизація›Маркетплейси›OLX«Налаштування → Інтеграції й автоматизація → Маркетплейси → OLX» і виберіть кабінет у перемикачі акаунтів під шапкою.
2. Натисніть «Підключити OLX» — сторінка OLX відкриється в новій вкладці.
3. Увійдіть саме в той кабінет OLX, який підключаєте, і дозвольте доступ.
4. OLX поверне вас у картку з повідомленням про підключення; у «Стані роботи» з'являться «Акаунт» і «Токен дійсний ще N дн.».
5. Натисніть «Перевірити» — успіх показує «акаунт: <назва кабінету>».

Якщо OLX не повернув вас у картку (наприклад, вхід відбувся на іншому пристрої), скопіюйте адресу сторінки, на яку повернув OLX, або лише код з неї і вставте в «Вставити код вручну» в картці.

«Від'єднати» стирає вхід цього кабінету: переписки з нього більше не читаються і відповісти в нього не вийде, поки ви не підключите кабінет знову. Інші кабінети це не зачіпає.

1бДругий кабінет OLX (акаунти)

Кожен кабінет OLX — окремий акаунт картки зі своїм входом, налаштуваннями продажів і журналом. Чати акаунта приходять у «Переписки» з його назвою, а відповідь іде з цього ж кабінету.

1. У картці «OLX» натисніть «+» у шапці (або «Акаунти» → «+ Додати акаунт»), вкажіть назву кабінету — так його буде підписано в «Переписках» — і натисніть «Додати акаунт».
2. У картці нового акаунта натисніть «Підключити OLX» і увійдіть саме в цей кабінет (розділ «1а»).
3. «Client ID» і «Client secret» акаунту вводити не треба: він бере ключі застосунку з основної картки. Свої впишіть, лише якщо кабінет працює через інший застосунок OLX.
4. Читання переписок вимикає «Налаштування продажів» → «Чати» → «Читати переписки цього кабінету».

1вКабінет у браузері для «OLX Доставки»

Замовлення «OLX Доставки» (хто купив, сума, кнопка «Підтвердити», накладна з ТТН) офіційний доступ OLX для України не віддає — лише переписки й оголошення. Тому Helomi читає їх зі сторінки кабінету OLX у невидимому браузері на сервері, який увійшов у ваш кабінет один раз. Цей рядок є лише в основній картці «OLX» і лише для адміністратора.

1. Відкрийте Налаштування›Інтеграції й автоматизація›Маркетплейси›OLX«Налаштування → Інтеграції й автоматизація → Маркетплейси → OLX» і знайдіть рядок «Кабінет у браузері». Поруч — коли сесію збережено востаннє («сьогодні», «32 дн. тому») або «входу ще не було».
2. Натисніть «Увійти в кабінет» (або «Увійти заново»). У новій вкладці відкриється вікно з живими кадрами браузера на сервері: клікайте й друкуйте просто по картинці або вставте пароль у поле внизу й натисніть «Надіслати текст».
3. Увійдіть в OLX як продавець: пароль і код з SMS чи пошти. Щойно кабінет відкриється, сесія збережеться сама — вікно повідомить «Сесію збережено» і за півтори хвилини закриється.
4. Поверніться в картку: у рядку з'явиться «сесію збережено сьогодні». Відтепер Helomi читає «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 не дає. «?» у заголовку блоку відкриває цю статтю у шторці.

6Підключити ШІ-відповідача

ШІ-відповідач — агент, який читає чати OLX, готує чернетки відповідей і розбір розмови, пропонує угоду й задачу з чату. Для OLX це ШІ Олександр; назовні він нічого не надсилає, поки ви не дозволите це в його налаштуваннях.

1. Відкрийте Інтеграції›Маркетплейси›OLX›Налаштування продажів«Інтеграції → Маркетплейси → OLX → Налаштування продажів».
2. У блоці «ШІ-відповідач» виберіть у списку «Хто відповідає на чати» агента «Олександр» і натисніть «Зберегти».
3. Увімкніть агента: Інтеграції›ШІ«Інтеграції → ШІ» → картка «Олександр» → перемикач «Увімкнено» (ключ моделі — Інтеграції›ШІ›Anthropic (Claude)«Інтеграції → ШІ → Anthropic (Claude)»).
4. Натисніть «Відкрити» в блоці «ШІ-відповідач» — вікно Олександра з чатами OLX, чернетками, угодами й задачами з чату.

Чати OLX мають приходити в «Переписки»: кабінет OLX підключено кнопкою «Підключити OLX» у картці «OLX» (розділ «1а»). Підключає агента адміністратор; у вікні агента для цього є ще й кнопка «Підключити до каналу». Працює лише агент, який і увімкнений, і підключений до каналу OLX. Докладно — стаття ШІ Олександр.

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

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

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