NoiseCut API — интеграция проверки заявок

POST https://noisecut.ru/netcat/modules/noisecut/ingest.php

Генерация подписи

$signature = hash_hmac('sha256', $data_string, $secret);

<?php
function checkSpam($name, $phone, $text, $formId, $savedIp)
{
    $endpoint = 'https://noisecut.ru/netcat/modules/noisecut/ingest.php';
    $site = 'YOUR_SITE_HOST';
    $secret = 'YOUR_SITE_SECRET';

    $savedIp = trim((string)$savedIp);
    if (!filter_var($savedIp, FILTER_VALIDATE_IP)) {
        error_log('NoiseCut: saved request IP is missing');
        return true; // не теряем заявку при ошибке интеграции
    }

    $timestamp = time();
    $nameNorm = trim(mb_strtolower($name, 'UTF-8'));
    $phoneNorm = preg_replace('/\D+/', '', $phone);
    $textNorm = trim(mb_strtolower($text, 'UTF-8'));
    $dataString = $site . '|' . $timestamp . '|' . $nameNorm . '|' . $phoneNorm . '|' . $textNorm;
    $dataString .= '|' . $savedIp . '||' . $formId; // user_agent намеренно пуст

    $payload = array(
        'site' => $site,
        'name' => $name,
        'phone' => $phone,
        'text' => $text,
        'timestamp' => $timestamp,
        'signature' => hash_hmac('sha256', $dataString, $secret),
        'signature_version' => 2,
        'visitor_ip' => $savedIp,
        'user_agent' => '',
        'form_id' => $formId
    );

    $json = json_encode($payload, JSON_UNESCAPED_UNICODE);
    $ch = curl_init($endpoint);
    curl_setopt_array($ch, array(
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $json,
        CURLOPT_HTTPHEADER => array('Content-Type: application/json'),
        CURLOPT_TIMEOUT => 10,
        CURLOPT_SSL_VERIFYPEER => true,
        CURLOPT_SSL_VERIFYHOST => 2
    ));
    $response = curl_exec($ch);
    $httpCode = (int)curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    $result = json_decode((string)$response, true);
    if ($httpCode !== 200 || !is_array($result) || isset($result['error'])) {
        error_log('NoiseCut: API request failed');
        return true;
    }

    $resultCode = isset($result['analysis']['result_code'])
        ? (string)$result['analysis']['result_code']
        : '';

    return $resultCode !== 'spam';
}

<?php
// Действие после добавления объекта компонента заявки.
$savedIp = trim((string)$f_IP); // поле IP текущего MessageXXX
$formId = 'callback-form';

if (!filter_var($savedIp, FILTER_VALIDATE_IP)) {
    error_log('NoiseCut: saved request IP is missing');
} else {
    $sendToCrm = checkSpam($f_Name, $f_Phone, $f_Text, $formId, $savedIp);
    if ($sendToCrm) {
        // штатная отправка заявки в CRM или менеджеру
    }
}

{
  "status": "ok",
  "site": "example.ru",
  "site_id": 123,
  "user_id": 456,
  "request": {
    "name": "Имя клиента",
    "phone": "номер из формы",
    "text": "текст обращения",
    "timestamp": "1710000000"
  },
  "analysis": {
    "result_code": "other_region",
    "result_label": "Другой регион",
    "css_class": "good-other",
    "reasons": [
      {
        "code": "phone_other_region",
        "text": "Номер относится к другому региону"
      }
    ],
    "normalized": {
      "phone": "нормализованный номер",
      "name": "имя клиента",
      "text": "текст обращения",
      "phone_info": "оператор и регион"
    }
  }
}