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

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

Форма зворотного дзвінка — один із найбільш конверсійних елементів сайту за правильної реалізації. Стандартний компонент bitrix:main.feedback технічно працює, але в реальних проектах його недостатньо: немає валідації на клієнті, немає захисту від спаму, немає інтеграції з CRM і телефонією, немає управління робочим часом операторів. Кастомна розробка вирішує всі ці завдання.

Архітектура компонента

Форма складається з чотирьох рівнів:

Клієнтський JS
  → Валідація поля телефону (маска + regex)
    → AJAX-запит на /local/api/callback.php
      → Серверна валідація + антиспам
        → Створення ліда в CRM Бітрікс
          → (Опційно) Ініціація дзвінка через Asterisk/Манго/Zadarma
            → Email/SMS сповіщення менеджеру

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

// /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);
    }
}

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

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') || '',
        };
    }
})();

Склад робіт

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

Терміни: базова форма з CRM-інтеграцією — 1–2 тижні. Повний функціонал з автодозвоном, розкладом та аналітикою — 3–4 тижні.