Налаштування в KeyCRM

Для початку нам потрібно створити в CRM нове джерело замовлень для цього переходимо в Налаштування → Джерела та натискаємо кнопку “Додати джерело”.

Заповнюємо поля:

• Назва - це назва лендінг сторінки, яка відображатиметься в KeyCRM, зовсім не обов'язково, щоб вона збігалася з доменом. Це просто зручна для розуміння назва, яку будуть використовувати ваші співробітники;
• Джерело обираємо "Інше";
• За потреби, вкажіть менеджера, на якого одразу призначатимуться всі замовлення з цього магазину. Якщо додати кілька менеджерів – замовлення призначатимуться на кожного менеджера по черзі. Можна залишити порожнім;
• Валюта - вибираємо валюту, в якій приходять замовлення з даного лендінгу

Після заповнення натискаємо кнопку "Додати".

Дії на хостингу, де знаходиться лендінг-сторінка

Для підключення нам підійде будь-яка форма, зараз ми розглянемо найпростіший приклад, коли продаємо 1 товар, вказується ім'я, e-mail, телефон покупця та адресу доставки, нам потрібно вказати які параметри передавати CRM.

$data = [
      "source_id" => 22, // до якого джерела в KeyCRM додавати замовлення
      "buyer" => [
            "full_name"=> $_POST['name'], // ПІБ покупця
            "email"=> $_POST['email'], // email покупця
            "phone"=> $_POST['phone'] // номер телефону покупця
      ],
      "shipping" => [
          "shipping_address_city"=> $_POST['address_city'], // місто покупця
          "shipping_receive_point"=> $_POST['address_street'], // вулиця, номер дому або відділення  Нової Пошти
          "shipping_address_country"=> $_POST['address_country'], // країна
          "shipping_address_region"=> $_POST['address_region'], // область/штат/регіон
          "shipping_address_zip"=> $_POST['address_zip'] // індекс
      ],
      "products"=> [
            [
                "price"=> $_POST['product_price'], // ціна продажу
                "quantity"=> 1, // кількість проданого товару
                "name"=> $_POST['product_name'], // назва товару
                "picture"=> $_POST['product_url'], // світлина товару
                "properties"=>[
                [
                    "name"=> "Color",
                    "value"=> "Space Gray"
                ]
              ]
          ]
      ]
];

“source_id” -id нашої лендінг сторінки як джерела в CRM (раніше додавали).

'source_name' => $_SERVER['SERVER_NAME']

Праворуч ми вказуємо звідки яку інформацію з яких полів брати, саме беремо параметр “name” з форми.

Нижче ми вказуємо ціну, кількість, назву, фото та властивості товару. В такому випадку, оскільки товар у нас 1, ми його жорстко прописали, але й ці параметри теж можна зробити динамічними, як ми зробили з ім'ям, e-mail'ом, телефоном покупця та адресою доставки.

Далі готуємо наші дані для відправки та відправляємо на сервер:

//  "упаковуємо данні"
$data_string = json_encode($data);

// Ваш унікальний API ключ KeyCRM
$token = 'Ваш API ключ';

// отправляем на сервер
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://openapi.keycrm.app/v1/order");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,$data_string);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        "Content-type: application/json",
        "Accept: application/json",
        "Cache-Control: no-cache",
        "Pragma: no-cache",
        'Authorization:  Bearer ' . $token)
);
$result = curl_exec($ch);
curl_close($ch);

Результат роботи

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

Додайте всі свої маркетплейси та відстежуйте замовлення через KeyCRM.