API для партнёров

Отправляйте заявки в CKALIBRO CRM одним запросом — с сайта, из рекламного кабинета, телефонии, n8n или своего сервиса. Лид сразу попадает в воронку с пометкой, от кого он пришёл.

Быстрый старт

1. Владелец CRM создаёт ключ: Настройки → API и интеграции → Создать ключ.
2. Партнёр отправляет заявку на адрес ниже с этим ключом.
3. Лид появляется в первом этапе воронки по умолчанию и уходит ответственному по правилам распределения.

curl -X POST https://crm.ckalibro.ru/api/v1/leads \
  -H "Authorization: Bearer ck_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ирина","phone":"+7 912 000-44-10","comment":"Ремонт квартиры 60 м²"}'

Ключ API

Ключ начинается с ck_ и показывается один раз при создании. Передавайте его одним из способов:

Способ	Пример
Заголовок (рекомендуется)	`Authorization: Bearer ck_…`
Параметр адреса — для форм и вебхуков, где нельзя задать заголовок	`/api/v1/leads?key=ck_…`
Поле формы	`key=ck_…`

У каждого партнёра — свой ключ: в CRM видно, сколько лидов он прислал. Ключ можно отключить в любой момент, остальные продолжат работать.

GET/api/v1/ping

Проверка ключа. Ответ: {"ok": true, "company_id": 12}

Отправить лид

POST/api/v1/leads

Принимает application/json, а также обычные формы application/x-www-form-urlencoded. Нужно хотя бы одно из полей: name, phone, email.

Поля

Имена полей не зависят от регистра, понимаются и частые варианты из форм (в скобках).

Поле	Описание
`name` (fio, имя)	Имя клиента
`phone` (tel, телефон)	Телефон в любом формате — CRM приведёт его к единому виду
`email` (mail, почта)	Почта
`comment` (message, text)	Текст заявки
`title`	Название сделки. По умолчанию — имя или телефон
`amount`	Сумма сделки, число
`source`	Источник (site, avito, partner…). По умолчанию — источник, указанный у ключа
`utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`	Метки рекламы — сохраняются в сделке

Ответы и ошибки

# 201 — создана новая сделка
{ "id": 1842, "client_id": 977, "status": "new", "duplicate": false }

# 200 — повторное обращение: у клиента уже есть открытая сделка
{ "id": 1790, "client_id": 977, "status": "repeat", "duplicate": true }

Код	Что значит
201 / 200	Лид принят
400	Нет ни имени, ни телефона, ни почты
401	Нет ключа, ключ неверный или отключён
429	Больше 120 запросов в минуту с одного ключа

Текст ошибки — в поле error: {"error": "Ключ API не найден или отключён"}

Дубли

CRM ищет клиента по телефону (последние 10 цифр), затем по почте. Если клиент найден и у него есть открытая сделка, новая сделка не создаётся — в её ленту добавляется «Повторное обращение». Если открытых сделок нет — создаётся новая сделка у того же клиента.

Примеры

PHP

$ch = curl_init('https://crm.ckalibro.ru/api/v1/leads');
curl_setopt_array($ch, [
  CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ck_ВАШ_КЛЮЧ', 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode(['name' => $name, 'phone' => $phone, 'comment' => $text]),
]);
$res = json_decode(curl_exec($ch), true);

JavaScript (сервер или браузер)

await fetch('https://crm.ckalibro.ru/api/v1/leads', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer ck_ВАШ_КЛЮЧ', 'Content-Type': 'application/json' },
  body: JSON.stringify({ name, phone, email, comment, utm_source })
});

Ключ в коде страницы виден посетителям. Для сайта создайте отдельный ключ — при утечке его можно отключить, не затрагивая партнёров.

n8n / Make

Узел HTTP Request: метод POST, адрес https://crm.ckalibro.ru/api/v1/leads, заголовок Authorization: Bearer ck_…, тело — JSON с полями выше.

Тильда и другие конструкторы

В Тильде: Настройки сайта → Формы → Webhook. Адрес:

https://crm.ckalibro.ru/api/v1/leads?key=ck_ВАШ_КЛЮЧ

Поля Name, Phone, Email распознаются автоматически. Проверочный запрос Тильды (test=test) CRM подтверждает без создания сделки. Так же подключаются формы WordPress, Webflow и любые конструкторы с вебхуками.

Ограничения

Частота	120 запросов в минуту на ключ
Размер запроса	до 200 КБ
Комментарий	до 4000 символов

Вопросы по подключению — crm@ckalibro.ru