> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.weblium.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Підключення KeyCRM до інтернет-магазину

KeyCRM — система автоматизації бізнесу. Вона може отримувати інформацію з багатьох сервісів, яку можна систематизовано обробляти в єдиному місці. Ви можете передавати до КеуCRM інформацію про ваші замовлення, які створюють клієнти у вашому інтернет-магазині.

Зміст:
1. [Підключення АРІ-ключа та ID джерела KeyCRM до сайту](#1-pidklyuchennya-ari-klyucha-ta-id-dzherela-keycrm-do-sajtu)
2. [Синхронізація полів між Weblium та KeyCRM](#1-sinhronizaciya-poliv-mizh-weblium-ta-keycrm)
3. [Створення додаткових полів з боку KeyCRM](#1-stvorennya-dodatkovih-poliv-z-boku-keycrm) (за потреби)

| ${color}[#1aa900](Підказка:) ви можете дізнатися більше про KeyCRM у їхньому [центрі підтримки](https://help.keycrm.app/uk).

# Підключення АРІ-ключа та ID джерела KeyCRM до сайту
1. Створіть акаунт на сервісі [KeyCRM](https://ua.keycrm.app/).

2. Зліва оберіть розділ **Налаштування** та натисніть на пункт **Основні**, після чого знизу сторінки натисніть кнопку **Згенерувати АРІ ключ**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/forms-ua-1_ktfhdo.png)
| ${color}[#1aa900](Підказка:) якщо ви вже генерували АРІ-ключ для [підключення KeyCRM до контактних форм](/uk/article/pidklyuchennya-keycrm-do-kontaktnoyi-formi-1fygrbb/), можете використати той самий АРІ-ключ.
3. Скопіюйте отриманий **АРІ-ключ** та натисність кнопку **Зберегти**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/forms-ua-2_1ulgy3n.png)

4. Перейдіть до налаштувань вашого сайту на Weblium і у секції **Ваш магазин** оберіть розділ **Налаштування**. Перейдіть до вкладки **Сповіщення**, прогорність сторінку дещо нижче, розгорніть секцію **KeyCRM сповіщення** та вставте у поле **АРІ-ключ** раніше скопійований АРІ-ключ:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-1_u56wny.png)

5. Поверніться до KeyCRM, відкрийте у лівому меню розділ **Налаштування** та натисніть на пункт **Джерела**. Потім натисніть на кнопку **Додати джерело**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-2_7gadm2.png)

6. Заповніть необхідну інформацію про джерело:
ㅤㅤ1) вкажіть його назву;
ㅤㅤ2) оберіть у випадному списку **Weblium**;
ㅤㅤ3) додайте посилання на ваш сайт (його головну сторінку);
ㅤㅤ4) оберіть менеджерів (користувачів KeyCRM), які матимуть доступ до замовлень з цього джерела; 
ㅤㅤ5) оберіть валюту у якій будуть надоходити замовлення;
ㅤㅤ6) натисніть на кнопку **Додати**.
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-3_n9gqnd.png)

7. Після створення джерела у лівому стовпчику наведіть на значок 🛈 праворуч від назви джерела. У підказці, що з'явиться, ви знайдете ID цього джерела, яке необхідне для підключення KeyCRM:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-4_nz3ie6.png)

| ${color}[#1aa900](Підказка:) якщо ви раніше не створювали джерела на KeyCRM, у вас ID матиме значення `1`.

8. Поверніться до налаштувань на стороні Weblium та уведіть **ID джерела** у одноіменне поле та натисніть **Підключити**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-5_1qgwr4w.png)

# Синхронізація полів між Weblium та KeyCRM
Для передачі даних з Weblium до KeyCRM необхідно вказати якому полю на KeyCRM буде відповідати кожне поле з кошику вашого інтернет-магазину на Weblium. Тобто необхідно синхронізувати кожне поле форми між KeyCRM та Weblium. 

1. Після підключення KeyCRM згідно з попереднім розділом у вас з'явиться кнопка **Синхронізувати поля з KeyCRM**. Натисніть на неї:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-6_1ptfe7c.png)

2. У відкритому вікні натисніть на кнопку **Додати поле**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/forms-ua-8_1bclcag.png)

3. Оберіть у лівій колонці з випадного списку поле з кошику вашого інтернет-магазину на Weblium, а у правій колонці — поле з боку KeyCRM, у яке буде надходити відповідна інформація з кошику інтернет-магазину. На лівій половині скриншота відображено де можна знайти перелік полів кошику вашого магазину, а на правій половині скриншоту — вікно з налаштувань, які ви відкрили у попередньому пункті. Встановіть відповідність для усіх полів, дані з яких необхідно передавати до KeyCRM, та натисність на кнопку **Застосувати**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-7_vftlaq.png)

|| ${color}[#ffa800](Примітка:) за замовчуванням у KeyCRM для магазину є 4 поля: "Ім'я покупця", "Телефон покупця", "Email покупця" та "Коментар покупця". Якщо у кошику вашого інтернет-магазину більше полів, вам необхідно створити додаткові поля з боку KeyCRM — як це зробити зазначено у [наступному розділі цієї інструкції](#1-stvorennya-dodatkovih-poliv-z-boku-keycrm).

4. Готово! Опублікуйте ваш сайт, щоб зміни набули чинності. 

Ви зможете переглянути замовлення у KeyCRM у розділі **Продажі** (перший зверху у лівому меню) у пункті **Замовлення**. Інформація, яку заповнили ваші клієнти у кошику на вашому сайті, буде відображена у відповідних полях замовлення:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-8_snpqwr.png)

||| ${color}[#f97700](Важливо:) якщо у вашому кошику з боку Weblium більше 4 полів і необхідно інші поля також передавати до KeyCRM, вам потрібно створити на KeyCRM додаткові поля. Цей процес описаний нижче. 

# Створення додаткових полів з боку KeyCRM
У разі потреби передавати більшу кількість полів з магазину до KeyCRM, ніж ім'я, телефон, email та коментар, вам необхідно створити додаткові поля з боку KeyCRM, щоб отримувати туди відповідну інформацію з полів кошика.

1. Перейдіть до розділу **Налаштування** — **Додатково** та натисніть кнопку **Додати поле**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/forms-ua-11_1v5d7ro.png)

2. Заповніть необхідну інформацію про нове поле:
ㅤㅤ1) вкажіть назву поля;
ㅤㅤ2) оберіть його тип. Для більшості полів підходить значення  "Строка" (короткий текст) або "Текст" (більший текст, наприклад коментар, який може бути з декількома рядками);
ㅤㅤ3) у якості сутності виберіть "Замовлення";
ㅤㅤ4) натисність на кнопку **Зберегти**.
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-9_1qgm5py.png)

| ${color}[#1aa900](Підказка:) ви можете дізнатися більше про створення полів у KeyCRM в [цій інструкції](https://help.keycrm.app/uk/work-with-pipeline/how-to-add-your-fields-to-the-pipeline) або у команди підтримки KeyCRM.

3. Аналогічним чином додайте усі необхідні поля, які згодом будуть пов'язані з полями кошика у вашому інтернет-магазині.

4. Після створення усіх необхідних полів з боку KeyCRM, так само, як це було у попередньому розділі інструкції, перейдіть до налаштувань вашого сайту на Weblium, відкрийте налаштування інтернет-магазину та у вкладці **Сповіщення** натисніть на кнопку **Синхронізувати поля з KeyCRM**. Натисність кнопку **Додати поле** й оберіть у лівому випадному списку назву поля з вашого кошику, а у правому випадному списку — назву додаткового поля, яке ви додали на KeyCRM. Після цього натисність **Застосувати**:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-10_15kzx8p.png)

|| ${color}[#ffa800](Примітка:) у разі невідображення полів KeyCRM під час синхронізації у налаштуваннях інтернет-магазину на Weblium спробуйте заново відкрити вікно синхронізації полей або перезавантажити сторінку.

5. Виконайте пункт 4 для усіх додаткових полів, які необхідно надсилати до KeyCRM. 

6. Готово! Опублікуйте ваш сайт, щоб зміни набули чинності. 

Тепер додаткові поля також будуть відображатися у замовленнях в KeyCRM:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/store-ua-11_tozbv.png)