Вебмастеры: создание токена и подключение лендинга

Вебмастер — это партнёр или источник трафика, у которого есть собственный токен и который может создавать заявки в X10 CRM через публичный API. Каждая заявка автоматически подписывается этим вебмастером: виден источник, работает учёт и выплаты. Эта страница проводит весь путь — от создания токена до рабочей формы на лендинге.

Зачем это нужно с точки зрения процесса — на странице CRM для товарного бизнеса: откуда берутся заявки, как считается конверсия каждого источника и за что вы платите партнёру.

#Шаг 1. Создать вебмастера и получить токен

1. 01

   Откройте раздел «Вебмастеры»

   В боковом меню CRM выберите Вебмастеры. Здесь список всех партнёров, их токены, сумма выплаты и статус активности.

2. 02

   Нажмите «Добавить вебмастера»

   Укажите имя (оно же станет источником заявки в карточке — пишите понятно: Instagram Ads, Партнёр Иванов, Landing shop-example) и сумму выплаты за заявку. Сумму можно изменить позже.

3. 03

   Скопируйте токен

   Токен генерируется автоматически — это случайная строка из 43 символов. В таблице рядом с ним сразу показан готовый адрес API. Копируйте кнопкой, а не выделением мышкой: лишний пробел в конце сломает авторизацию.

#Шаг 2. Адрес API

Заявка создаётся одним POST-запросом. Токен передаётся прямо в пути — отдельных заголовков авторизации не нужно.

• crm.your-domain.com — замените на адрес вашей CRM (тот же, на который вы заходите в систему).
• {TOKEN} — токен вебмастера из предыдущего шага.
• Слеш в конце адреса обязателен.
• Метод — только POST. GET вернёт 405.

#Шаг 3. Первый тестовый запрос

Прежде чем трогать лендинг, убедитесь, что токен рабочий. Выполните запрос из терминала — заявка должна появиться в CRM за несколько секунд.

curl -X POST "https://crm.your-domain.com/api/webmasters/YOUR_TOKEN/leads/create/" \
  -H "Content-Type: application/json" \
  -d '{"phone": "380681234567", "fullname": "Тест из документации"}'

Успешный ответ выглядит так — lead_id это номер созданной заявки:

{"ok": true, "lead_id": 10241}

#Формат запроса

#Поля заявки

Обязательное поле только одно — phone. Остальные необязательны, но чем больше вы передадите, тем меньше оператор дозаполняет руками.

#Что CRM проставляет сама

#Шаг 4. Подключить лендинг

Есть три рабочих способа. Самый надёжный — первый: токен остаётся на сервере, а вы видите результат каждого запроса.

<?php
// send-lead.php — форма лендинга шлёт сюда, а уже этот файл — в CRM.
// Токен остаётся на сервере и не попадает в код страницы.

$token = getenv('X10_WM_TOKEN');
$url   = "https://crm.your-domain.com/api/webmasters/{$token}/leads/create/";

$payload = [
    'phone'        => $_POST['phone']    ?? '',
    'fullname'     => $_POST['name']     ?? '',
    'comment'      => $_POST['comment']  ?? '',
    'landing'      => $_SERVER['HTTP_HOST'] ?? '',
    'city'         => $_POST['city']     ?? '',
    'np_department'=> $_POST['np']       ?? '',
    'utm_source'   => $_POST['utm_source']   ?? '',
    'utm_medium'   => $_POST['utm_medium']   ?? '',
    'utm_campaign' => $_POST['utm_campaign'] ?? '',
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
]);

$response = curl_exec($ch);
$status   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status === 200) {
    header('Location: /thank-you');
    exit;
}

error_log("X10 CRM: заявка не создана. HTTP {$status} {$response}");
header('Location: /?error=1');

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

#Безопасность токена

• Токен позволяет только создавать заявки. Он не даёт доступа к базе, звонкам или настройкам.
• В браузерном варианте токен виден в коде страницы. Это приемлемый риск (максимум — спам-заявки), но если источник трафика сомнительный, лучше проксировать запрос через свой бэкенд.
• Скомпрометированный токен меняется за полминуты: Вебмастеры → редактировать → Сгенерировать новый токен. Старый перестаёт работать мгновенно — не забудьте обновить все лендинги.
• Чтобы временно отключить партнёра, снимите галочку Активен: API сразу начнёт отдавать 403, а история заявок сохранится.

#Если что-то не работает

#Чек-лист перед запуском трафика

• Вебмастер создан, указана сумма выплаты, переключатель «Активен» включён
• Тестовый запрос через cURL вернул {"ok": true} и заявка видна в CRM
• Поле phone приходит в международном формате
• Передаётся landing — чтобы разделять сайты
• Передаются UTM-метки из адреса страницы
• Если отправка идёт из браузера — домен лендинга добавлен в разрешённые источники CRM
• В CRM есть статус с кодом new
• Кнопка отправки блокируется на время запроса
• После успешной отправки пользователь видит страницу благодарности