Так. Krokul CRM інтегрується з Prom.ua і забирає нові замовлення з кабінету токеном API. Замовлення стає угодою з товарами вашого каталогу, а покупець стає контактом. Етап угоди змінює статус замовлення в Prom, номер ТТН з Krokul потрапляє в замовлення, а повідомлення покупців видно в стрічці контакту.
Krokul кожні кілька хвилин читає /orders/list і створює угоду з кожного нового замовлення. Товари зіставляються з каталогом Krokul за артикулом, ціна береться з замовлення, а джерелом угоди стає «Prom.ua». Номер замовлення стає зовнішнім ключем угоди, тож повторне опитування не створює дубль.
Телефон і email з замовлення Krokul звіряє з контактами. Постійний покупець отримує нову угоду у своїй картці, а дані нового Krokul дочитує методом /clients/{id} і створює контакт.
Менеджер переводить угоду на інший етап, і Krokul викликає /orders/set_status з відповідним статусом Prom. Відповідність етапів і статусів ви задаєте в налаштуваннях підключення зі списку /order_status_options/list вашого кабінету.
Коли для угоди створено ТТН Нової пошти, Krokul передає її номер у Prom методом /delivery/save_declaration_id. Покупець бачить номер відправлення у своєму замовленні на Prom, коли посилка ще в дорозі, і менеджер не вводить його двічі.
Krokul забирає нові повідомлення методом /messages/list і пише їх у стрічку контакту. Відповідь менеджера з Krokul іде покупцю методом /messages/reply.
| Prom.ua | Напрям | Krokul | Коли |
|---|---|---|---|
| Замовлення (/orders/list) | Prom.ua → Krokul | Угода з джерелом «Prom.ua» і зовнішнім ключем | Опитування за розкладом |
| Товари замовлення | Prom.ua → Krokul | Рядки угоди з товарами каталогу за артикулом | Разом з угодою |
| Покупець (/clients/{id}) | Prom.ua → Krokul | Контакт: знайдений або новий | Разом з угодою |
| Статус замовлення (/orders/set_status) | Krokul → Prom.ua | Етап угоди | Зміна етапу угоди |
| Номер декларації (/delivery/save_declaration_id) | Krokul → Prom.ua | ТТН у картці угоди | Після створення ТТН |
| Повідомлення (/messages/list, /messages/reply) | Prom.ua ↔ Krokul | Стрічка контакту | Опитування й відповідь менеджера |
contact/api-find за телефоном чи email, нового заводьте через contact/api-create.card/api-create, а номер замовлення тримайте ключем угоди через externalRef/api-upsert, тоді повторне опитування не дасть дубля.card.statusChanged з фільтром за воронкою й на кожну доставку з перевіреним x-crm-signature викликайте /orders/set_status у Prom.Так. Krokul інтегрується з Prom.ua через свій API і вебхуки. Krokul забирає замовлення Prom в угоди з товарами, повертає в Prom статус і номер ТТН і показує повідомлення покупців у стрічці контакту.
Після найближчого опитування, зазвичай за кілька хвилин. Prom не надсилає вебхуків, тому Krokul сам перепитує кабінет і забирає все, що надійшло після попереднього запиту.
У кабінеті Prom, шлях «Налаштування» → «Управління API-токенами» → «Створити токен». Prom нагадує про завершення строку дії за 30 і за 7 днів.
Рядок угоди створюється з назвою й ціною з замовлення, а в журналі підключення з’являється позначка про незіставлений артикул.
Prom сам називає свій публічний API закритою бета-версією і не надсилає вебхуків, тому Krokul опитує замовлення за розкладом. Токен діє щонайбільше рік, і його треба поновити в кабінеті до завершення строку.
Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.
Запит отримано. Відповімо на вашу пошту.
Prom.ua є торговою маркою її власника. Krokul не афілійований з Prom.ua.