Розробка зворотного дзвінка на 1С-Бітрікс: CRM і телефонія

Кастомна форма зворотного дзвінка: від валідації до автодзвону

Стандартний компонент bitrix:main.feedback не перевіряє номер, не захищає від спаму і не створює ліди. У результаті менеджери витрачають до 30% часу на ручну обробку. Кастомна форма зворотного дзвінка вирішує ці завдання: валідація номера на клієнті та сервері, rate limiter через кеш, автоматичне створення ліда з UTM і задача на дзвінок. При навантаженні 1000+ заявок на день форма працює стабільно завдяки тегованому кешуванню та компонентній архітектурі Bitrix 2.0. Наш досвід — 50+ впроваджень для інтернет-магазинів і сервісних компаній, середня швидкість обробки заявки скорочується в 4 рази порівняно зі стандартною формою.

Ключова відмінність — вбудований оркестратор: форма аналізує робочий час операторів, розподіляє ліди за найменш завантаженими менеджерами та (опціонально) ініціює зворотний дзвінок через API телефонії. Все це — на готових компонентах Bitrix 2.0 з мінімальною залежністю від ядра.

Чому стандартна форма не підходить?

Стандартний bitrix:main.feedback не має вбудованої валідації телефону, антиспаму та прив'язки до CRM. Це призводить до втрати до 40% заявок: клієнти вводять неправильні номери, боти засмічують систему, а менеджери витрачають години на ручне введення. Кастомна форма вирішує ці проблеми: вона перевіряє номер за маскою +7, обмежує частоту запитів через rate limiter і автоматично створює лід з UTM-мітками.

Як ми захищаємо форму від спаму?

Використовуємо трирівневий захист: CSRF-токен у кожному запиті, rate limiter на основі тегованого кешу (не більше 2 заявок з одного IP на годину) та клієнтську валідацію перед відправкою. Додатково можна підключити reCAPTCHA. У результаті кількість спам-заявок знижується на 95%.

Які проблеми вирішує кастомна форма

• Немає валідації номера — клієнт вводить що завгодно, менеджер витрачає час на уточнення. Наша форма перевіряє довжину, маску +7 і блокує невалідні номери на клієнті та сервері.
• Спам-боти забивають CRM — без rate limiter і CSRF-захисту ліди летять пачками. Ми ставимо обмеження 2 заявки з одного IP на годину та перевіряємо сесію.
• Немає прив'язки до CRM — лід не створюється автоматично, менеджер сам вбиває дані. Ми створюємо лід з телефоном, ім'ям, UTM-мітками і одразу ставимо задачу на дзвінок.
• Немає автодзвону — клієнт чекає на дзвінок годинами. Якщо оператори працюють, система сама ініціює виклик через API АТС.
• Немає розкладу — заявки в неробочий час пропадають. Ми налаштовуємо календар: у вихідні відкладені повідомлення із зазначенням часу наступного дзвінка.

Як ми реалізуємо форму зворотного дзвінка?

Архітектура рішення

Клієнтський JavaScript надсилає AJAX-запит до /local/api/callback.php. Сервер валідує телефон, перевіряє антиспам, створює лід у CRM Бітрікс24 і (опціонально) ініціює дзвінок через API телефонії. Якщо зараз неробочий час — лід створюється, а дзвінок відкладається до наступної робочої години.

Серверний обробник

// /local/api/callback.php
require_once($_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php');
header('Content-Type: application/json');

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405);
    exit(json_encode(['success' => false, 'error' => 'Method not allowed']));
}

$data = json_decode(file_get_contents('php://input'), true);

// CSRF-проверка
$csrfToken = $data['sessid'] ?? '';
if (!\bitrix_sessid_check($csrfToken)) {
    http_response_code(403);
    exit(json_encode(['success' => false, 'error' => 'Invalid session']));
}

$phone = preg_replace('/\D/', '', $data['phone'] ?? '');

// Валидация телефона
if (!preg_match('/^[78]\d{10}$/', $phone)) {
    exit(json_encode(['success' => false, 'error' => 'Неверный формат телефона']));
}
$phone = '+7' . substr($phone, -10);

// Антиспам: не более 2 заявок с одного IP за час
$limiter = new \Local\Callback\RateLimiter();
if (!$limiter->allow($_SERVER['REMOTE_ADDR'])) {
    exit(json_encode(['success' => false, 'error' => 'Слишком много заявок. Попробуйте позже.']));
}

// Создаём лид в CRM
$leadCreator = new \Local\Callback\LeadCreator();
$leadId = $leadCreator->create([
    'phone' => $phone,
    'name' => htmlspecialchars(mb_substr($data['name'] ?? '', 0, 100)),
    'comment' => htmlspecialchars(mb_substr($data['comment'] ?? '', 0, 500)),
    'source' => $data['source'] ?? 'callback_form',
    'page' => $_SERVER['HTTP_REFERER'] ?? '',
    'utm' => $data['utm'] ?? [],
]);

// Инициируем обратный звонок если рабочее время
$scheduler = new \Local\Callback\WorkSchedule();
if ($scheduler->isWorkingNow()) {
    (new \Local\Callback\AutoDialer())->initiate($phone, $leadId);
    $message = 'Мы перезвоним вам в течение 2 минут';
} else {
    $message = 'Мы перезвоним в ближайшее рабочее время: ' . $scheduler->getNextWorkStart();
}

exit(json_encode(['success' => true, 'message' => $message, 'lead_id' => $leadId]));

Створення ліда в CRM

namespace Local\Callback;

class LeadCreator
{
    public function create(array $data): int
    {
        $fields = [
            'TITLE' => 'Обратный звонок: ' . $data['phone'],
            'NAME' => $data['name'] ?: 'Клиент',
            'PHONE' => [['VALUE' => $data['phone'], 'VALUE_TYPE' => 'WORK']],
            'SOURCE_ID' => 'CALLBACK',
            'STATUS_ID' => 'NEW',
            'ASSIGNED_BY_ID' => $this->getAvailableManager(),
            'COMMENTS' => $this->buildComment($data),
            'UF_UTM_SOURCE' => $data['utm']['utm_source'] ?? '',
            'UF_UTM_CAMPAIGN'=> $data['utm']['utm_campaign'] ?? '',
            'UF_CALLBACK_PAGE' => mb_substr($data['page'] ?? '', 0, 255),
        ];

        $lead = new \CCrmLead(false);
        $leadId = $lead->Add($fields, true);

        if ($leadId) {
            // Добавляем задачу менеджеру: перезвонить
            $this->addCallTask($leadId, $data['phone'], $fields['ASSIGNED_BY_ID']);
        }

        return (int)$leadId;
    }

    private function addCallTask(int $leadId, string $phone, int $assigneeId): void
    {
        \CCrmActivity::Add([
            'TYPE_ID' => \CCrmActivityType::Call,
            'SUBJECT' => 'Перезвонить: ' . $phone,
            'OWNER_TYPE_ID' => \CCrmOwnerType::Lead,
            'OWNER_ID' => $leadId,
            'RESPONSIBLE_ID' => $assigneeId,
            'DEADLINE' => (new \Bitrix\Main\Type\DateTime())->add('+1H'),
            'COMPLETED' => 'N',
        ]);
    }

    private function getAvailableManager(): int
    {
        // Ротация: выбираем менеджера с наименьшим количеством открытых лидов
        $managers = [5, 7, 12, 15]; // ID сотрудников
        $counts = [];

        foreach ($managers as $id) {
            $res = \CCrmLead::GetList(
                [],
                ['ASSIGNED_BY_ID' => $id, 'STATUS_ID' => 'NEW'],
                ['COUNT' => true]
            );
            $counts[$id] = (int)$res;
        }

        asort($counts);
        return array_key_first($counts);
    }
}

Метод CCrmLead::Add описано в документації 1С-Бітрікс.

Розклад роботи та управління часом

namespace Local\Callback;

class WorkSchedule
{
    private array $schedule = [
        1 => ['09:00', '19:00'], // Пн
        2 => ['09:00', '19:00'], // Вт
        3 => ['09:00', '19:00'], // Ср
        4 => ['09:00', '19:00'], // Чт
        5 => ['09:00', '19:00'], // Пт
        6 => ['10:00', '16:00'], // Сб
        0 => null, // Вс — выходной
    ];

    public function isWorkingNow(): bool
    {
        $tz = new \DateTimeZone('Europe/Moscow');
        $now = new \DateTime('now', $tz);
        $dow = (int)$now->format('w'); // 0=Sun
        $hours = $this->schedule[$dow] ?? null;
        if (!$hours) return false;
        $start = \DateTime::createFromFormat('H:i', $hours[0], $tz);
        $end = \DateTime::createFromFormat('H:i', $hours[1], $tz);
        return $now >= $start && $now < $end;
    }

    public function getNextWorkStart(): string
    {
        $tz = new \DateTimeZone('Europe/Moscow');
        $now = new \DateTime('now', $tz);
        for ($i = 1; $i <= 7; $i++) {
            $next = clone $now;
            $next->modify("+{$i} day");
            $dow = (int)$next->format('w');
            $hours = $this->schedule[$dow] ?? null;
            if ($hours) {
                $next->setTime(...explode(':', $hours[0]));
                return $next->format('d.m в H:i');
            }
        }
        return 'понедельник';
    }
}

Rate Limiter через Бітрікс-кеш

namespace Local\Callback;

class RateLimiter
{
    private const MAX_ATTEMPTS = 2;
    private const WINDOW_SECONDS = 3600;

    public function allow(string $identifier): bool
    {
        $key = 'callback_rl_' . md5($identifier);
        $cache = \Bitrix\Main\Application::getInstance()->getManagedCache();
        $count = (int)$cache->get($key);

        if ($count >= self::MAX_ATTEMPTS) {
            return false;
        }

        $cache->set($key, $count + 1, self::WINDOW_SECONDS);
        return true;
    }
}

Клієнтська частина: форма з маскою та AJAX

(function () {
  const form = document.getElementById('callback-form');
  if (!form) return;
  const phoneInput = form.querySelector('[name="phone"]');
  // Маска ввода телефона
  phoneInput.addEventListener('input', function () {
    let val = this.value.replace(/\D/g, '');
    if (val.startsWith('8') || val.startsWith('7')) val = val.slice(1);
    val = val.slice(0, 10);
    let formatted = '+7 ';
    if (val.length > 0) formatted += '(' + val.slice(0, 3);
    if (val.length >= 3) formatted += ') ' + val.slice(3, 6);
    if (val.length >= 6) formatted += '-' + val.slice(6, 8);
    if (val.length >= 8) formatted += '-' + val.slice(8, 10);
    this.value = formatted;
  });
  form.addEventListener('submit', async function (e) {
    e.preventDefault();
    const submitBtn = form.querySelector('[type="submit"]');
    submitBtn.disabled = true;
    const phone = phoneInput.value.replace(/\D/g, '');
    if (phone.length < 11) {
      showError('Введите корректный номер телефона');
      submitBtn.disabled = false;
      return;
    }
    const payload = {
      phone: phone,
      name: form.querySelector('[name="name"]')?.value || '',
      sessid: BX.bitrix_sessid(),
      utm: getUtmParams(),
    };
    try {
      const res = await fetch('/local/api/callback.php', {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json'
        },
        body: JSON.stringify(payload),
      });
      const data = await res.json();
      if (data.success) {
        showSuccess(data.message);
        form.reset();
      } else {
        showError(data.error || 'Произошла ошибка');
      }
    } catch {
      showError('Ошибка соединения. Попробуйте ещё раз.');
    }
    submitBtn.disabled = false;
  });
  function getUtmParams() {
    const params = new URLSearchParams(window.location.search);
    return {
      utm_source: params.get('utm_source') || getCookie('utm_source') || '',
      utm_campaign: params.get('utm_campaign') || getCookie('utm_campaign') || '',
    };
  }
})();

Порівняння стандартної та кастомної форми

Типові помилки при розробці форми зворотного дзвінка

Процес розробки

1. Аналіз — вивчаємо поточну форму, навантаження, графік операторів, використовувану телефонію.
2. Проектування — погоджуємо макет, логіку роботи, архітектуру компонента.
3. Реалізація — пишемо компонент, серверний API, інтеграцію з CRM та АТС.
4. Тестування — перевіряємо валідацію, антиспам, автодзвон, роботу в неробочий час.
5. Деплой — викочуємо на продакшен, налаштовуємо моніторинг помилок.

Що входить у роботу

• Кастомний компонент local:callback.form з шаблонами (попап, вбудована форма, плаваюча кнопка)
• Серверний обробник з CSRF, rate limiting, валідацією
• Створення ліда в CRM, задача менеджеру, ротація відповідальних
• Розклад робочого часу з timezone-підтримкою
• JS: маска телефону, AJAX-відправка, передача UTM
• Email/SMS сповіщення при надходженні заявки
• (Опціонально) Автодзвон через API телефонії
• Документація по компоненту та налаштуванням
• Гарантія 12 місяців на код

Терміни та вартість

Базова форма з CRM-інтеграцією — 1–2 тижні. Повний функціонал з автодзвоном, розкладом та аналітикою — 3–4 тижні. Вартість розраховується індивідуально після аналізу ваших завдань.

Кастомна форма обробляє заявки в 3 рази швидше стандартної, а конверсія в дзвінок збільшується на 60%. Зв'яжіться з нами для консультації — ми оцінимо проект за один робочий день.