Так. Krokul CRM інтегрується з OLX через Partner API для бізнес-акаунтів продавців. Повідомлення покупця під вашим оголошенням стає розмовою в «Комунікаціях» Krokul, контактом і угодою, а менеджер відповідає з Krokul у той самий тред OLX. Оголошення OLX публікуються й оновлюються з товарів каталогу Krokul і знімаються, коли товар продано.
Krokul читає /threads і бере треди з непрочитаними повідомленнями. Новий тред з покупцем стає розмовою в «Комунікаціях», а співрозмовник за interlocutor_id стає контактом з ім’ям з /users/{id}. Угода отримує назву оголошення з advert_id і джерело OLX, тож продавець бачить, які оголошення приводять покупців.
Менеджер відповідає покупцю у вікні розмови 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 | Картка товару | Опитування за розкладом |
contact/api-create і card/api-create, ідентифікатор треду збережіть через externalRef/api-upsert, а повідомлення пишіть у стрічку через activity/api-create.card.won, перевіряйте заголовок x-crm-signature і знімайте оголошення командою deactivate.Так. Повідомлення покупців з OLX стають розмовами, контактами й угодами в Krokul, менеджер відповідає з Krokul, а оголошення публікуються й знімаються з товарів каталогу.
Ні. OLX відкриває доступ лише до оголошень акаунта, який авторизував застосунок.
Ні. OLX не надає тестового середовища API і радить перевіряти інтеграцію на окремому акаунті OLX.
За розкладом і в межах ліміту OLX у 4500 запитів за п’ять хвилин з однієї IP-адреси. Перевищення блокує запити на 30 хвилин, тому Krokul читає лише треди з непрочитаними повідомленнями.
OLX не надсилає подій про нові повідомлення, тому Krokul перевіряє треди за розкладом. Partner API дозволяє щонайбільше 4500 запитів за п’ять хвилин з однієї IP-адреси, а доступ стосується лише оголошень акаунта, який авторизував застосунок.
Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.
Запит отримано. Відповімо на вашу пошту.
OLX є торговою маркою її власника. Krokul не афілійований з OLX.
