Автоматично създаване на сделки по заявки от сайта¶
За да се създават сделките в CRM автоматично по заявки от сайта, е необходимо да настроите изпращането на сделки към R7K12. За целта имаме готово решение: проксиране на сделките. Проксирането трябва да се настрои в онзи файл, който обработва формите на сайта. Например изпраща данните за поръчката по имейл. Добавете за всяка форма за поръчка (заявка) този PHP код, като поставите в него своите променливи за полетата:
//Отправка данных в R7K12CRM
$KEY = 'PROJECT KEY';//ключ проекта
$phone = !empty($_REQUEST['phone']) ? $_REQUEST['phone'] : '';
$products = [
[
"id" => "1", //код товара (из каталога CRM)
"name" => "тестовый товар", //название товара
"price" => "20", //цена товара 1
"quantity" => "1", //количество
]
];
if (preg_match("/^0/",$phone)) $phone = '+38'.$phone;
$CRM = [
"r7k12id" => isset($_COOKIE['r7k12_si']) ? $_COOKIE['r7k12_si'] : null,
"type" => "Form",//Тип заявки (ОБЯЗАТЕЛЬНО)
"title" => $_REQUEST['title'],//Заголовок заявки (НЕ ОБЯЗАТЕЛЬНО)
"href" => $_SERVER['HTTP_REFERER'],//Ссылка на страницу, с которой пришла заявка (НЕ ОБЯЗАТЕЛЬНО)
"comment" => $_REQUEST['comment'],//Комментарий к сделке (НЕ ОБЯЗАТЕЛЬНО)
"name" => $_REQUEST['name'],//Название контакта (НЕ ОБЯЗАТЕЛЬНО)
"email" => $_REQUEST['email'],//E-mail адрес контакта (ОБЯЗАТЕЛЕН ЕСЛИ НЕ УКАЗАН ТЕЛЕФОН КОНТАКТА)
"phone" => $phone,//Телефон контакта (ОБЯЗАТЕЛЕН ЕСЛИ НЕ УКАЗАН E-MAIL КОНТАКТА)
"shop" => $products[0]['name'],//Магазин
"department" => 1,//ID Отдела из R7K12 CRM
"create_new_lead" => "1", //'0' - новая сделка создается только если нет сделки или предыдущая в статусе "успешно реализовано" или "возврат"; '1' - новая сделка создается в любом случае (НЕ ОБЯЗАТЕЛЬНО)
"fields" => [
"lead" => [//Поля для сделок
"products" => $products,
"revenue" => array_sum(array_map(function($p){return $p['price'] * $p['quantity'];}, $products)),
],
"contact" => [//Поля для контактов
],
],
];
$context = stream_context_create([
"http" => [
"method" => "POST",
"content" => json_encode($CRM),
],
]);
file_get_contents("https://r7k12.com/" . $KEY . "/crm/", false, $context);
//Завершение отправки данных в R7K12CRM
Параметри:
| Параметър | Тип | Задължителен | Описание |
| r7k12id | string | не | id на посещението |
| type | string | да | тип на заявката |
| title | string | не | име на заявката |
| href | string | не | линк към страницата, от която е изпратена заявката |
| comment | string | не | коментар |
| name | string | не | име на клиента |
| string | да (ако не е посочен phone) | имейл на клиента | |
| phone | string | да (ако не е посочен email) | телефонен номер на клиента |
| create_new_lead | boolean | не | стойност '0' – нова сделка се създава само ако няма сделка или предишната е в статус „Успешно реализирано“ или „Отказ“ '1' – нова сделка се създава във всеки случай да се създава нова сделка във всеки случай |
| fields | object | не | допълнителни полета на сделката и контакта |
| fields[lead] | object | не | допълнителни полета на сделката |
| fields[lead][products] | object | не | продукти в сделката |
| fields[lead][products][][id] | string | да | id на продукта |
| fields[lead][products][][name] | string | не | име на продукта |
| fields[lead][products][][price] | float | не | цена на продукта |
| fields[lead][products][][quantity] | integer | да | количество |
С помощта на този код ще можете да настроите изпращането на данни за заявките от сайта към R7K12 CRM, по които услугата автоматично ще създава сделки във Вашата CRM. По-долу ще обясним по-подробно частите на кода.
1. В Настройките на своя проект копирайте Ключа на проекта. Пример:
В първия ред на кода $KEY = 'PROJECT KEY'; поставете своя ключ от настройките. Пример:
$KEY = '3f797313ca7ac12686167fdda5eae839'; //ключ проекта
2. В масива $products можете да предадете следните данни за продуктите: код, име, цена, количество. Пример за изпращане на два вида продукти в масива:
$products = [
[
"id" => "1",//код товара (из каталога CRM)
"name" => "Товар 1",
"price" => 10, //цена товара 1
"quantity" => 3
],
[
"id" => '2', //код товара (из каталога CRM)
"name" => 'Товар 2',
"price" => 20, //цена товара 2
"quantity" => 1
]
];
Ако изпратите поръчка с продукт, който все още го няма в склада на CRM, продуктът автоматично ще бъде добавен в склада на R7K12 CRM.
3. В масива $CRM е необходимо да посочите данните и променливите за изпращане на информацията за заявката и контакта.
В реда
'type' => $type,
се посочва типът на заявката. Можете да настроите изпращането с тип 'Form' за всички форми на сайта. Или на всяка форма или група форми да присвоите собствено име на типа. Така в аналитиката ще можете да видите от кои точно форми оставят заявки най-често. В реда
"href" => $_SERVER['HTTP_REFERER'],
автоматично ще се отчита страницата, от която е оставена заявката. Но ще е по-добре, ако за всяка форма зададете статично страницата ('href' => 'http://site.com'), на която се намира формата. След това за полетата 'comment', 'name', 'name', 'phone' посочете съответните променливи от вашите форми. Редът
'create_new_lead' => '1'
отговаря за алгоритъма за създаване на сделка по запитвания от формата. Стойност '0' – нова сделка се създава само ако няма сделка или предишната е в статус „Успешно реализирано“ или „Отказ“. Стойност '1' – нова сделка се създава във всеки случай. В масива 'fields' се предават продуктите. Тук можете също да посочите допълнителни полета за сделката и контакта.