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

Зміст

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

#1. Підготовлені шаблони інтеграцій

#2. Налаштування даних з Webhook

#3. Сервіс для змінних

#4. Можливі помилки

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

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

За допомогою вхідних Webhook (вебхуків) можна приєднати майже будь-який сервіс, який їх підтримує. Тобто зі стороннього сервісу відправляється інформація до KeepinCRM, а KeepinCRM обробляє згідно з налаштуваннями (мапінг): яку інформацію з сервісу записати та в які поля KeepinCRM.

В KeepinCRM є 2 типи Webhook:

• Вхідний - цей (отримує інформацію зі стороннього сервісу)
• Вихідний - тригер (відправляє інформацію в сторонній сервіс)

За допомогою вхідного Webhook можна створити:

1. Контрагента (ліда/клієнта)
2. Угоду
3. Завдання

Які сервіси можна приєднати?

Всі які можуть відправляти дані через Webhook в сторонню систему.

Структура Webhook запиту який приходить:

• Назва змінної - з якої змінної й куди записати значення (зовнішня назва поля)
• Значення змінної - що записується і в яке поле до KeepinCRM (KeepinCRM: поля)

Для приєднання можна використати наші підготовлені шаблони або обрати Webhook без налаштувань, і налаштувати всі змінні з нуля.

Створити Webhook можна в розділі: Налаштування => Інтеграції => Webhook

#1. Підготовлені шаблони інтеграцій

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

• WooCommerce (Кошик)
• WordPress (Contact Form 7)
• Weblium (Форми)
• Weblium (Кошик)
• Facebook Leads (Apix-drive)

Тобто, обираєте потрібний сервіс зі списку і вказуєте URL на webhook, який сформував KeepinCRM в обраній системі. А якщо потрібно створити чистий Webhook, то обрати +.

#2. Налаштування даних з Webhook

Якщо в шаблонах немає потрібного сервісу, то створюється пустий Webhook та налаштовується з нуля. Головне заповнити правильно змінні з Webhook та поля куди записати значення з цих змінних.

Самі налаштування поділяються на декілька блоків:

1. Створення контрагента
2. Створення угоди
3. Створення завдання

Важливо!

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

Приклад зв'язки змінних та полів KeepinCRM (мапінг) на основі історії запитів, звідки й можна взяти ці змінні.

Все досить просто налаштовується, якщо розібратись трохи детальніше в тому, що і як приходить в запиті до нас. На фото вказано приклад змінної зліва в запиті та точне його вказання в налаштуваннях.

#3. Сервіс для змінних

Також змінні можна отримати на сервісі https://www.site24x7.com/tools/jsonpath-finder-validator.html. В нього копіюється запит який приходить до KeepinCRM і натискається кнопка копіювання біля потрібної змінної, далі копіюєте змінну яку сервіс надав.

#4. Можливі помилки

Помилки в більшості випадків стандартні:

• Не обрано поле Назва компанії / Контактна особа при створенні контрагента
• Обрано поле в яке не можна записати дані: ID, формула
• Обрано поле, в яке записати дані не можна через його формат: в цифрове поле текст записати не можна, або в тип поля: Так/Ні записується текст і тому подібне
• Неправильно вказана змінна з Webhook

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

• Доступно на розширеному тарифі
• Можна створювати необмежену к-сть Webhook
• Якщо потрібна додаткова автоматизація після створення контрагента, угоди або завдання, можна використовувати тригери. Наприклад авторозподілення угоди й тому подібне
• При видаленні Webhook дані не видаляються, тільки профіль
• Товари в більшості випадків приходять в масиві (таке собі вкладення), тому потрібно вказати масив і далі змінні які відповідають за назву, к-сть, ціну та артикул
• Webhook це одностороннє отримання даних, повернути щось в іншу систему не можна. Наприклад двостороння зміна статусів й тому подібне
• В назві змінних не можна використовувати українські/російські слова, тільки латиниця
• В назвах змінних не може бути пробілів
• Якщо змінна в масиві
  

  "first": [
  {
    "second": "тут значення"
  },
  {
    "third": "тут значення"
  } 
  ]

  то вказується назва масиву [].назва змінної. Приклад: first[].second, якщо потрібне значення не перше, а друге, наприклад third, то first[1].third
• Якщо дані в об'єкті, то через крапку
  

  "first": 
  {
    "second": "тут значення",
    "third": "тут значення"
  }

  то вказується назва обєкту.назва змінної. Приклад: first.second, якщо потрібне значення не перше, а друге, наприклад third, то first.third