Към съдържанието

Автоматично създаване на сделки по заявки от сайта

За да се създават сделките в 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 не име на клиента
email 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' се предават продуктите. Тук можете също да посочите допълнителни полета за сделката и контакта.