Панель управління
Контент менеджер
Налаштування
KeyCRM

Сервіс KeyCRM

KeyCRM — це CRM-система (система управління взаємовідносинами з клієнтами), яка підтримує облік замовлень, клієнтів, товарів і фінансових операцій. Система орієнтована на ринки України та Європи та дозволяє інтегрувати різні канали інтернет-продажів у єдину панель керування.

🔗 Підключення KeyCRM у ТОМ

Щоб інтегрувати KeyCRM із системою ТОМ (Торгсофт Онлайн Маркет), вам потрібно мати вже зареєстрований обліковий запис у KeyCRM. Для реєстрування нового облікового запису перейдіть на офіційний сайт KeyCRM (opens in a new tab).

Вхід в створений обліковий запис

Принцип роботи інтеграції

Передача даних між Торгсофт Онлайн Маркет (ТОМ) та KeyCRM здійснюється за допомогою API. У процесі обміну передаються всі необхідні дані про замовлення: інформація про покупця, перелік товарів, ціни, обрані способи доставки та оплати.

Щоб ТОМ міг коректно визначати, які саме дані і куди передавати, необхідно вказати відповідні ідентифікатори (ID) параметрів у налаштуваннях. Це дозволяє точно зіставити джерела замовлень, менеджерів, методи доставки, оплати та статуси між двома системами.

Далі розглянемо покроково, як правильно налаштувати ці параметри для забезпечення стабільної та точної синхронізації даних.

Крок 1. Отримання API ключа в KeyCRM
  1. Перейдіть у Панель керування KeyCRM.
  2. Відкрийте розділ: Налаштування → Основні
Налаштування KeyCRM
  1. У нижній частині сторінки Основні знайдіть та скопіюйте свій API ключ.
Налаштування основні KeyCRM
Крок 2. Активація модуля KeyCRM у ТОМ
  1. Відкрийте Панель керування ТОМ.
  2. Перейдіть до: Контент-менеджер → Налаштування → Сторонні ресурси
  3. Знайдіть модуль KeyCRM, активуйте його:
    • Активний: ТАК
    • Ключ доступу: Вставте раніше скопійований API ключ
Активація KeyCRM в TOM

Налаштування параметрів інтеграції

Індивідуальні параметри ID можуть відрізнятися для кожного користувача залежно від тривалості використання KeyCRM, кількості джерел та співробітників тощо. Нижче наведено інструкції з налаштування основних параметрів.

Налаштування параметрів інтеграції ID
Крок 3. Ідентифікатор джерела
  1. У KeyCRM відкрийте: Налаштування → Джерела
  2. Якщо ще не створено джерело — додайте нове:
    • Назва: домен вашого сайту
    • Джерело: Інший тип джерела
    • Менеджер: оберіть відповідального користувача (наприклад, Адміністратор)
    • Валюта: Ukrainian Hryvnia
Ідентифікатор джерела
  • Після створення джерела, знайдіть ID джерела та вкажіть його в полі Ідентифікатор джерела у ТОМ.
Ідентифікатор джерела
Крок 4. Ідентифікатор відповідального менеджера
  1. У KeyCRM відкрийте: Налаштування → Користувачі
  2. Знайдіть відповідального менеджера (наприклад, Адміністратор).
  3. Скопіюйте ID користувача та вставте його у поле Ідентифікатор відповідального менеджера в ТОМ.
Ідентифікатор відповідального менеджера
Крок 5. Ідентифікатори методів доставки

  1. У KeyCRM відкрийте: Налаштування → Доставки

  2. Додайте потрібні способи доставки:

    • Нова Пошта:

      • Назва: Нова Пошта
      • Зв'язати з: Novaposhta
      • За потреби можна пов’язати профіль акаунту Нова Пошта по API.

    • Самовивіз з магазину:

      • Назва: Самовивіз з нашого магазину
      • Зв'язати з: Other

  3. Після створення доставки скопіюйте ID кожного способу.

Ідентифікатори методів доставки
  1. Вкажіть ці ID у відповідних полях ТОМ:
    • Ідентифікатор методу Нова Пошта
    • Ідентифікатор методу нашого доставлення
Крок 6. Ідентифікатори способів оплати
  1. У KeyCRM відкрийте: Налаштування → Фінанси
  2. Створіть або перевірте наявність потрібних методів оплати:
    • LiqPay
    • Portmone
    • Інші способи: Готівкою, На картку тощо
  3. Знайдіть та скопіюйте ID кожного способу.
  4. У ТОМ вкажіть:
    • Ідентифікатор для методу оплати LiqPay
    • Ідентифікатор для методу оплати Portmone
    • Інші формати обов'язково зі назвою, наприклад: Готівкою:7, На картку:6
Ідентифікатори методів оплати
Крок 7. Ідентифікатори статусів

У стандартній формі ТОМ деякі ID параметри вже прописані — як це передбачено за замовчуванням у KeyCRM для обов’язкових необхідних подій. Також ви можете створити власні статуси й надати їм потрібні ID.

  • У KeyCRM відкрийте: Налаштування → Замовлення
Ідентифікатори методів доставки
Крок 8. Статуси, що передаються зі зворотним зв’язком із KeyCRM до ТОМ

Щоб статуси в KeyCRM змінювалися та передавалися до ТОМ, необхідно налаштувати події.

  • Для цього перейдіть у KeyCRM: Налаштування → Додатково → Автоматизація.
Стоврення подій
  • Створюємо дві події Статус та Оплачено
Крок 9. Перевірка інтеграції
  1. Збережіть усі зміни в налаштуваннях ТОМ.
  2. Створіть тестове замовлення на вашому інтернет-магазині.
  3. У KeyCRM відкрийте розділ: Продажі → Замовлення
  4. Перевірте, чи з'явилося нове замовлення з правильною інформацією.
Перевірка інтеграції
Сторонні ресурсиОновлення функцій з GTM та GA4