Приєднання WordPress (Woocommerce)

Зміст

Загальна інформація

#1. Встановлення Webhook на WooCommerce

#2. Налаштування Webhook в KeepinCRM

Додаткова інформація

Загальна інформація

За допомогою вхідних Webhook можна швидко приєднати кошик WordPress який працює на WooCommerce. Всі данні будуть приходити в KeepinCRM та створюватись потрібні сутності:

• Контрагент
• Угода
• Завдання

Процес приєднання проходить в декілька етапів:

1. Встановлення url Webhook на WooCommerce
2. Налаштування Webhook в KeepinCRM

#1. Встановлення Webhook на WooCommerce

Для додавання url Webhook на плагіні WooCommerce потрібно перейти в розділ Налаштування => Додатково => Вебхуки (Вебзаціпи / Webhook) і натиснути на кнопку "Створити новий вебхук"

В наступному вікні потрібно вказати:

• Назву (будь-яку)
• Статус - Активно
• Тема (topic) - Замовлення створено
• URL доставки - url на Webhook, який описано нижче, в кроці #2
• Натиснути зберегти вебхук

#2. Налаштування Webhook в KeepinCRM

Для отримання URL та налаштування Webhook потрібно перейти в розділ: Налаштування => Інтеграції => Webhook, натиснути на кнопку "+" та обрати шаблон WooCommerce

Після збереження будуть заповнені стандартні змінні з кошика та пов'яжуться до полів KeepinCRM. В самому низу сформується url, який треба вказати в налаштуваннях, описаних вище (крок #1).

Після створення Webhook та його вказання в плагіні WooCommerce нові замовлення вже почнуть надходити, але скоріш за все потрібно буде доналаштувати додаткові змінні для зв'язки (поля), наприклад відділення, місто, адреса, метод оплати, метод доставлення та інше. Вони приходять в першому запиті і їх можна звідти взяти.

Приклад створеного Webhook та зв'язка додаткових змінних на основі приходу першого замовлення.

Важливо!

• Щоб записати ID замовлення в назву угоди потрібно використати змінну - ID (на фото приклад)
• Контрагент завжди створюється, якщо він не налаштований, або налаштований неправильно - дані не створяться
• До контрагента можна обрати, щоб створювалась угода або завдання, або угода та завдання разом
• Для створення контрагента обов'язково повинно бути налаштовано заповнення поля - Назва компанії / Контактна особа
• Для створення угоди повинно бути налаштовано заповнення поля - Назва угоди
• Для створення завдання повинно бути налаштовано заповнення поля - Назва завдання
• Якщо змінні в об'єкті, то вказується: назва об'єкта, крапка і назва змінної. Приклад на фото: billing.email, billing.phone
• Якщо потрібно заповнити текст в поле, наприклад назву завдання, то вказувати через - /ТУТ НАЗВА/
• Якщо потрібно записати 2 змінні в одне поле KeepinCRM - використовувати {{Тут змінна 1}} {{Тут змінна 2}}
• В товари додавати додаткові поля не можна, тільки описати змінні 4-х стандартних які ми надаємо

В цілому, все досить просто налаштовується. А саме замовлення приходить від WordPress з затримкою у 2-4 хвилини.

Додаткова інформація

• Доступно на розширеному тарифі
• Якщо потрібна додаткова автоматизація після створення контрагента, угоди або завдання, можна використовувати тригери. Наприклад авторозподілення угоди й тому подібне
• При видаленні Webhook дані не видаляються, тільки профіль
• В товари записуються тільки 4 стандартизовані змінні, більше додати не можна.
• Webhook це одностороннє отримання даних, повернути щось в іншу систему не можна. Наприклад двостороння зміна статусів й тому подібне
• Для розміщення замовлення в потрібному етапі обирається відповідне поле в блоці Поля угоди
• Якщо потрібно, щоб угоди які сплачені онлайн переходили в інший етап, то це вже налаштовується на рівні тригеру. Наприклад, якщо метод оплати Liqpay, то перемістити на етап - Онлайн оплата.
• Якщо був створений Webhook та доданий на Сайт 1, а потім створюється Сайт 2 на заміну Сайт 1, то необхідно створити новий Webhook та вказати на Сайт 2 нове посилання створеного Webhook. Якщо таке не зробити, то можуть бути випадки, коли замовлення зі старого та нового сайту мають однакові ID, і відповідно замовлення з нового сайту не будуть створюватись, оскільки вони вже були створенні з Сайту 1 з помилкою: {"agreements.external_uid":["вже зайнятий"]}
• Додаткові можливі помилки