База знань Uspacy
Усі матеріалиЗастосунки UspacyКрамниця Uspacy

Інтеграція Uspacy та Magento. Як налаштувати?

Інтеграція Uspacy та Magento. Як налаштувати?

У цій статті розкажемо, як під’єднати Magento до Uspacy і пришвидшити свою роботу: замовлення з’являються в CRM автоматично, а контакти не дублюються

Magento – це платформа для інтернет-магазинів. Вона допомагає керувати товарами, цінами та замовленнями, а покупцям – зручно оформлювати покупки на сайті.

Ми покроково розкажемо як під’єднати Magento до Uspacy, щоб замовлення з сайту автоматично з’являлися у вашому Просторі в CRM. Система одразу створює Лід або Угоду, створює та додає або прив’язує існуючий Контакт і дозволяє призначити відповідального менеджера – без ручного копіювання даних.

Крім того, пояснимо про встановлення модуля з ZIP-архіву, підкажемо, де взяти Magento Installation Domain і Magento Auth Secret, а також як підключити магазин в Uspacy та перевірити, що все працює.

57333a48-2a7e-4404-9c9f-d14660774024

Але про все по черзі ⬇️

Дії на стороні Magento

Крок 1. Установка модуля Uspacy/Magento через ZIP

🟣 Розміщення архіва ➡️ uspacy-magento-integration-module.zip (необхідно скачати). Скопіюйте його на сервер у корінь вашого Magento проєкту.

🟣 Распаковка архіва. Зробити це треба безпосередньо у потрібну папку:

Після розпакування структура має виглядати так:

app/code/Uspacy/Magento/registration.php

app/code/Uspacy/Magento/etc/module.xml

...

❗️Важливо: розпаковувати потрібно прямо в app/code/Uspacy/Magento, а НЕ у app/code/.

🟣 Активація модуля. У корені проєкту виконайте:

🟣 Генерація DI та кеш. Після встановлення модуля Magento потрібно «перезібрати» внутрішні зв’язки (компіляція DI), щоб магазин побачив нові можливості й працював стабільно. Потім треба очистити кеш – це стирає застарілі тимчасові копії, і «адмінка» та сайт відображають оновлення як слід.

Крок 2. Налаштування в адміністративній панелі та отримання даних для інтеграції

У вашій «адмінці» Magento потрібно перейти в розділ Stores (1) – Configuration(2).

71e897bc-6c0a-4c67-97cb-94c6469fe741

Розгорнути Uspacy Integration (3) – General Configuration (4).

ad0e13ea-27ba-4575-bfab-4c20df9d7692

На сторінці що відкриється, у полі Enable Integration проставити значення Yes.

83246ddb-bbbd-4a89-b2fb-e185d7d7ce75

Далі, скопіювати та зберегти собі:

🔗 Auth Secret. Можна скористатися кнопкою Copy.

5a9dcbe4-6435-490b-9ef4-fcd297046655

🔗 Назву домену. Без https://.

69144edd-b5d9-4eac-8143-1c823d0b8149

💡Ці дані будуть потрібні для підключення на стороні Uspacy.

98962954-fcf2-4739-bfce-4a4848d3cc7b

Окрім цього на сторінці налаштувань є секція Advanced Configuration, у якій має міститися Webhook URL. У цьому полі буде посилання на портал, яке додасться автоматично після успішного підключення інтеграції в Просторі.

uspacy-magento32.pnga516e5b5-5c3e-4406-b567-1dba3f3c6a35

Дії на стороні Uspacy

Крок 1. Установлення застосунку для інтеграції

У розділі Крамниця представлений безкоштовний застосунок для інтеграції Uspacy та Magento. Отже, спершу потрібно встановити його. Для цього натискаємо Отримати.

1b3e3466-9b2a-4332-9f06-09d347502d58

💡Зверніть увагу, що зробити це може адміністратор чи власник Простору.

Далі переходимо до налаштувань вже встановленого застосунку.

2bddc62c-b923-49ea-8015-798cb16d2da8

Крок 2. Підключення інтеграції

У цьому блоці налаштувань потрібно буде заповнити два поля, дані для яких уже отримали на стороні Magento: Magento Installation Domain та Magento Auth Secret.

fb94de98-a0b9-4ea0-b445-7f9a81661b44

І натиснути Підключення.

d97f1376-2852-4a60-867e-25e76fffd847

У результаті статус повинен змінитися.

df4b887c-ca49-4051-a1d0-e1bf2acd9d9a

☝🏻 І нагадуємо, що після успішного підключення у поле Webhook URL в налаштуваннях Magento буде підтягнута адреса вашого Простору.

ea022e49-5f60-4886-97b4-600d617821e2

Крок 3. Додавання магазину

Одразу буде підтягнутий ваш магазин за замовчуванням. Якщо у вас їх декілька, то можете вибрати, який саме хочете додати (або навіть додати всі, але по черзі).

84ecd83d-0dcc-49e1-8564-d921b4b289b0

Також можете змінити назву магазину й присвоїти йому «робочу» для ідентифікації у вашому Просторі.

b1bf0cf6-6768-4c3b-af95-72c63e1e5806

Крок 4. Налаштування зв’язків із CRM

Спершу виберіть, елемент якої сутності створюватиметься у вашій CRM при отриманні замовлення на сайті. Це може бути Лід або Угода.

952c5cd2-1cd8-4bb7-8ef0-47a134bd7855

☝🏻Якщо у якості сутності для cтворення вибираєте Лід, то обов'язково в Налаштуваннях увімкніть опцію Підтримка продуктів.

uspacy-magento33.png

Тоді, у картку CRM безперешкодно будуть передані ті товари, які містяться у замовленні, оформленому на сайті.

Далі вкажіть воронку, у яку потраплятимуть новостворені елементи.

f494a6fe-c605-479a-a623-3d0a495486e3

А також окремого відповідального за нові ліди чи угоди, що опиняться в CRM.

a72a3279-405a-4f18-9527-ea51daabf7fc

💡 Якщо цього не зробити, то ви не зможете завершити налаштування. Тобто це поле є обов’язковим для заповнення.

Крок 5. Перевірка та збереження налаштувань

Ще раз перевірте всі параметри та натисніть Зберегти.

3c0be6d6-8faf-4c40-a0e0-360a5dd76d6b

Готово✅ Інтеграція підключена та готова до роботи.

Як це працює?

Клієнт оформляє своє замовлення на сайті. Йому присвоюється свій номер.

9f09324b-28e0-4f77-b02e-6c421f58cc7c

Це замовлення автоматично потрапляє у вашу CRM у вигляді угоди (чи ліда, залежно від налаштувань).

5ba85273-50ca-4a02-b8e2-64b4b07f73ab

У картці цього елемента ви побачите прив’язаний контакт.

8cbdc944-5de1-4778-b7a8-137129cb86f7

💡За загальним правилом Контакт створюється завжди й одразу прив’язується до Ліда або Угоди. Але перед цим спрацьовує перевірка на дублікати за email або телефоном. Якщо у вашому Просторі вже існує Контакт з такою електронною адресою/номером, то новий не створюється. Натомість система знаходить наявний Контакт і прив’язує його до відповідного Ліда/Угоди.

426c1310-749e-4c13-86cb-bb1a39a6b85c9cca0e9c-adfe-44e3-8981-dabadbd7f709

А також побачите нотатку, де буде міститися інформація про адресу клієнта, яку він залишив у формі на сайті, й тип доставки, що вибрано.

718087cc-cdca-4da6-9a39-a879e30544ce

До картки CRM автоматично додаються всі позиції замовлення. Доставка при цьому відображається як самостійний продукт.

3da51359-94b2-4195-b29d-91da847b93b1

Важливі дані із замовлення, такі як назва товару, кількість, ціна та її тип, знижки, податки теж переносяться.

4f122410-13be-4915-85b4-4e9e839af46d

💡 Зверніть увагу, що продукти додані до угоди (чи ліда) будуть саме локальними. Тобто використовуватимуться тільки для конкретного елемента й не будуть додані до каталогу.

1b8aebbe-97bf-460e-928d-c6cd811685c4

🔍 Детальніше про локальні продукти в Uspacy можна прочитати в окремій статті.

Отже, тепер ви можете далі працювати із замовленням, яке отримали на своєму сайті, прямо в CRM.

8d7bcd10-b9b1-452e-8a45-b690a89ba897

Створено: 25 вересня 2025 р. / Оновлено: 26 вересня 2025 р.