Налаштування в KeyCRM
Для початку потрібно створити в CRM воронку для цього переходимо в Налаштування → Воронки та натискаємо на кнопку «Створити нову воронку».
При створенні воронки завжди створюється стандартний набір статусів.
Детальна інструкція «Як налаштувати воронки та статуси»
Дії на хостингу, де знаходиться сайт
Для підключення нам підійде будь-яка форма, зараз ми розглянемо найпростіший приклад, коли продаємо 1 товар, вказується ім'я, e-mail, телефон покупця та адресу доставки, нам потрібно вказати які параметри передавати CRM.
$data = [
"title" => $_POST['title'], // назва заявки
"source_id" => 1, // ідентифікатор джерела
"manager_comment" => $_POST['manager_comment'], // коментар до заявки
"manager_id" => 1, //ідентифікатор відповідального менеджера
"pipeline_id" => $_POST['pipeline_id'], // ідентифікатор воронки (за відсутності параметра буде використана перша воронка у списку)
"contact" => [
"full_name" => $_POST['name'], // ПІБ покупця
"email" => $_POST['email'], // email покупця
"phone" => $_POST['phone'] // номер телефону покупця
],
"utm_source" => $_POST['utm_source'], // джерело компанії
"utm_medium" => $_POST['utm_medium'], // тип трафіку
"utm_campaign" => $_POST['"utm_campaign'], // назву компанії
"utm_term" => $_POST['utm_term'], // ключове слово
"utm_content" => $_POST['utm_content'], // ідентифікатор оголошення
"products" => [
[
"name" => $_POST['product_name'], // назву товару
"sku" => $_POST['product_sku'], // артикул товару
"quantity" => $_POST['product_quantity'], // кількість проданого товару
"price" => $_POST['product_price'], // ціна продажу
"picture" => $_POST['product_url'], // світлина товару
]
]
];
У разі відсутності даних "title" номер заявки автоматично генерується у CRM.
Більш детально, яку інформацію потрібно передавати, можете переглянути в нашому Swagger
Далі готуємо наші дані для відправки та відправляємо на сервер:
// "упаковуємо дані"
$data_string = json_encode($data);
// Ваш унікальний API ключ KeyCRM
$token = 'Ваш API ключ';
// відправляємо на сервер
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://openapi.keycrm.app/v1/pipelines/cards");
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);
Зверніть увагу! Обмеження кількості запитів нашого API — 60 запитів на хвилину.
Теги: api, апи, арі, фзш.