Как настроить скрипт передачи заявок в KeyCRM через API

Если у нас еще нет интеграции с каким-то сервисом, то вы можете получать заявки по API, ниже опишем все пошагово
Автор Андрей Гадай
Обновлено 1 месяц назад

Настройка в 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.

Более детально какую информацию нужно передавать можете изучить в документации API https://docs.keycrm.app

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

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

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

// отправляем на сервер
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://openapi.keycrm.app/v1/leads");
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 ключ можно узнать ЗДЕСЬ
Внимание! Ограничение по количеству запросов нашего API — 60 запросов в минуту.

Добавляйте все свои сайты и отслеживайте заказы через KeyCRM.

Теги: api, апи, арі, фзш. 
Оцените эту статью