OLX
Інтеграція з OLX через Partner API приносить переписки з покупцями в «Переписки», дає створити угоду з розмови «OLX Доставки» і оновлювати оголошення й ціни зі складу. Окремого списку замовлень Partner API OLX не віддає, тому угода з'являється з переписки, а не опитуванням, як у Prom чи Rozetka.
На цій сторінці
Можливості
- Підключення акаунта OLX через Partner API; токен оновлюється сам, картка показує, скільки днів він ще дійсний.
- Переписки з покупцями — у «Переписках»; стан полера видно в картці.
- Угода з переписки: ім'я й телефон покупця, оголошення, товар за артикулом; повторно з тієї самої розмови угода не дублюється.
- Джерело, відповідальний, чати й оператори, автоматична ТТН на етапах, зв'язок товарів.
- Оновлення оголошень і цін зі складу.
1Налаштування
Підключає адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Маркетплейси» → картка «OLX» → «Підключення».
- Ключі застосунку OLX Partner API: «Client ID» і «Client secret» → «Ввести» → «Зберегти ключ». Їх видає OLX, коли ви реєструєте застосунок у партнерській програмі.
- Сам акаунт OLX підключається кнопкою «Підключити OLX» у «Переписках» → «Стан каналів» (вхід в OLX і дозвіл доступу).
- «Перевірити» читає профіль: успіх — «акаунт: <ім'я>»; якщо OLX не підключено — підказка, куди натиснути.
- «Стан роботи»: «Підключення 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")