Сайти (WooCommerce та інші): акаунти, поля, вебхук

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

Підключає адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Сайти» → картка сайту (підписана доменом, напр. «shop.com.ua»).

У картці сайту три вкладки:

• «Підключення» — перемикач «Інтеграція» (приймати замовлення цього сайту в угоди; зберігається в базі), «Секрет підпису вебхука» (потрібен лише для адреси з підписом), «Логотип» («Завантажити», «Взяти з сайту», «Стандартний»), блок «Вебхук» з «Вебхук url» і «Адреса з підписом» (кнопки «Скопіювати»), «Стан роботи», «Журнал подій», «Останні запити від сайту», «Прибрати акаунт».
• «Поля» — мапінг полів і «Історія запитів акаунту» (розділи 4–5).
• «Налаштування продажів» — «Основне» (перемикач, «Назва», «Компанія», «Джерело угод», «Відповідальний»), «Нові замовлення», «Вебхук url», «Пов'язані статуси», «Автоматична відправка ТТН», «Фід для маркетплейсу».

Спільна картка «Усі сайти (WooCommerce)» у тій самій вкладці: блок «Сайти» (список усіх сайтів зі станом і «+ Додати сайт»), ключ «Сайти чату (slug:Назва:ключ, через кому)» для чату з сайту, «Стан роботи» з оновленням товарів. Її перемикач — «приймати замовлення з усіх сайтів разом»; коли він увімкнений, перемикачі окремих сайтів сайт не вимикають.

Джерело угод за замовчуванням — назва компанії сайту; бренд угоди визначається за цією назвою (профіль у Налаштування›Компанії та реквізити«Налаштування → Компанії та реквізити»). Юрособа — правилом Налаштування›Бренди та юрособи›Правила«Налаштування → Бренди та юрособи → Правила» з умовою «Канал (картка «Інтеграцій»)».

2Підключити сайт через «Вебхук url»

1. Картка сайту → вкладка «Поля» → блок «Вебхук url» → «Адреса для сайту» → «Скопіювати».
2. На сайті замініть адресу вебхука KeepinCRM (https://api.keepincrm.com/callbacks/webhook/…) на цю. Тіло запиту лишається тим самим — поля вже зв'язані.
3. Зробіть тестове замовлення на сайті.
4. Перший справжній запит сам вмикає картку сайту (один раз; якщо вимкнули вручну — далі діє перемикач). «Стан» покаже, коли адресу активовано.
5. Перевірте «Історію запитів акаунту» і нову угоду в «Угодах».

«Нова адреса» генерує новий токен: стара адреса перестане приймати замовлення, її треба замінити на сайті.

3Підключити через вебхук WooCommerce з підписом

1. «Підключення» → «Секрет підпису вебхука» → «Ввести» → придумайте секрет → «Зберегти ключ».
2. На сайті: WooCommerce → Налаштування → Додатково → Вебхуки → два вебхуки на «Адресу з підписом» з картки: теми «Замовлення створено» і «Замовлення оновлено», секрет — той самий.
3. Увімкніть перемикач «Інтеграція» картки сайту.

Поки сайт підключений до KeepinCRM, перемикач лишайте вимкненим, інакше замовлення прийде двічі. Пінг WooCommerce при створенні вебхука записується в історію як «пінг WooCommerce».

4Поля контрагента, угоди і товарів

Вкладка «Поля»:

• «Поля контрагента»: «Тип контрагента» (Клієнт / Лід), «Головний відповідальний», «Джерело», «Статус» (номер статусу контрагента з KeepinCRM), «Теги» (через кому) і таблиця «Зовнішня назва поля» → «Helomi: поля контрагента».
• «Поля угоди»: «Етап» (якщо статус замовлення не знайшовся в мапі статусів) і таблиця змінна›поле угоди«змінна → поле угоди»: назва, коментар, ID замовлення, статус, тип оплати, сума, знижка, теги, доставка (служба, місто, відділення, адреса, отримувач, телефон, ТТН, післяплата), додаткові поля.
• «Поля товарів»: «Масив товарів *» (напр. line_items), «Артикул», «Назва», «Кількість», «Знижка (необов'язково)»; «Ціна товару передається в копійках» (сайт шле 12500 замість 125.00), «Тип знижки».

«+ Додати» — новий рядок, «Прибрати рядок» — прибрати. Змінні пишуться так само, як у вхідних вебхуках: a.b, a[].b, {{a}} {{b}}, /текст/. «Як у KeepinCRM» повертає початкове заповнення. «Зберегти» / «Скасувати зміни» — у панелі внизу. Змінювати поля може лише адміністратор.

Чого нема в запиті, береться зі стандартного розбору WooCommerce (billing, line_items). Значення, яке не підходить під тип додаткового поля, замовлення не зупиняє: поле пропускається, причина — в історії й журналі.

5Історія запитів: перевірити й обробити ще раз

«Поля» → «Історія запитів акаунту» (до 200 останніх запитів): «Дата», «Клієнт», угода, «Помилки», «Відповідь», тіло («показати»).

• «Змінні» — назви полів запиту з прикладами; клік вставляє змінну в рядок полів, де стоїть курсор.
• «Перевірити мапінг» — показує, що вийде, нічого не створюючи.
• «Обробити ще раз» — обробляє запит за поточними полями: угода створиться або оновиться, дубля не буде.
• «Оновити» — перечитати історію.

6Налаштування продажів сайту

• «Пов'язані статуси»: статус WooCommerce (Очікує оплати, В обробці, Утримується, Виконано, Скасовано, Повернено кошти, Не вдалося) → етап угоди. Передавати статус назад на сайт поки не можна.
• «Автоматична відправка ТТН»: етапи й служба доставки.
• «Зв'язувати товари по»: артикул, ID маркетплейсу або назва.
• «Фід для маркетплейсу»: «Фід каналу з прайс-листа» (/feed/channel/sites-<slug>.xml — товари саме цього сайту з його id, ціною з прайс-листа і залишком зі складу) і фід усього складу /feed/all.xml. З 14.10 у налаштуваннях імпорту товарів на сайті адресу фіду KeepinCRM замінюють на фід каналу (робить власник).

7Додати чи прибрати сайт

1. Картка «Усі сайти (WooCommerce)» → блок «Сайти» → «+ Додати сайт».
2. «Компанія» (джерело угод сайту) і «Домен сайту» (з нього складеться адреса вебхука) → «Додати сайт».
3. Відкриється картка нового сайту, вимкнена. Далі — розділ 2 або 3.

Прибрати: картка сайту → «Підключення» → «Прибрати». Угоди лишаються; зникають секрет, налаштування, журнал і історія запитів.

8Побачити, що клієнт оплатив на сайті

Коли клієнт платить карткою на сайті, скасовує несплачене замовлення чи отримує гроші назад, сайт сам оновлює угоду: поле «Статус оплати:», нотатку «Сайт <домен>: статус оплати — …» з деталями оплати і рядок «Оплата: …» у коментарі угоди.

1. Відкрийте угоду сайту — її назва починається з префікса сайту, напр. «PP-453».
2. У «Даних угоди» подивіться рядок «Коментар»: «Оплата: Оплачено (Monobank · Apple Pay · … · 719,00 ₴ · статус success · RRN … · рахунок …)».
3. Ті самі деталі — у нотатці «Сайт <домен>: статус оплати — Оплачено» у стрічці праворуч.

Статуси оплати: «Оплачено», «Очікує оплати», «Не оплачено», «При отриманні», «Повернено». Решта коментаря (коментар покупця, юрособа, набори) не змінюється, а зміну видно в журналі угоди від імені «Сайт». Коментар угод з Telegram, який пише ШІ Едуард, статус оплати не переписує.