Налаштування модуля Webform Drupal: форми, обробники, інтеграції

При 500+ заявках на день на Drupal-сайті менеджери витрачають до 3 годин на ручний розподіл. Помилки валідації, втрачені дані в CRM, неструктуровані відповіді — типовий біль власників сайтів на Drupal. За нашими оцінками, до 30% лідів іде до конкурентів через затримку обробки. Webform модуль вирішує ці завдання — але без правильного налаштування форми приносять лише видимість автоматизації. Ми налаштовуємо Webform так, щоб форми працювали як конвеєр: від збору даних до інтеграції з CRM без участі розробника. Досвід нашої команди — понад 60 проєктів з Webform на актуальних версіях Drupal. Реалізуємо під ключ з гарантією до 12 місяців.

Які проблеми вирішуємо?

Втрата заявок через ручну обробку

При використанні звичайних HTML-форм без Webform менеджери змушені копіювати дані з email в CRM. Це займає 5-10 хвилин на заявку, а при 100 заявках на день — 8-16 людино-годин. Webform з webhook-обробником передає дані в CRM за секунди, повністю виключаючи ручне введення.

Помилки валідації та неструктуровані дані

Без валідації на стороні фронтенду та бекенду в CRM потрапляють порожні або некоректні поля. Webform надає понад 50 типів елементів з валідацією: обов'язкові поля, маски введення, мінімальна/максимальна довжина. Наприклад, поле телефону з маскою +7 (999) 999-99-99 скорочує кількість неправильних номерів на 70%.

Складні сценарії з умовною логікою та багатокроковістю

Відзначимо: коли форма має підлаштовуватися під вибір користувача — при виборі "Підтримка" з'являється номер замовлення, при "Продажі" — назва компанії. Реалізувати це на чистому HTML+JS складно та ненадійно. Webform підтримує states API: поля ховаються або стають обов'язковими залежно від значень інших полів. В одному проєкті ми налаштували 5-крокову форму, де кожен крок залежить від попереднього, що скоротило кількість покинутих анкет на 40%.

Як ми налаштовуємо Webform?

Весь процес включає шість етапів: аналіз вимог, проектування YAML-конфігурації, створення форми через UI або YAML, налаштування обробників (email, webhook, кастомні), тестування 10+ сценаріїв, деплой з моніторингом та логуванням.

Аналіз вимог

Уточнюємо навантаження (до 1000 заявок/день), типи полів, залежності, обробники. Обов'язково перевіряємо, які CRM використовуються — AmoCRM, Bitrix24, Salesforce або самописна. Це впливає на формат даних webhook.

Проектування YAML-конфігурації

Все версіонується в Git. Приклад мінімальної форми зворотного зв'язку:

elements: | name: '#type': textfield '#title': 'Ім\'я' '#required': true '#maxlength': 100 email: '#type': email '#title': 'Email' '#required': true phone: '#type': tel '#title': 'Телефон' '#input_mask': '+7 (999) 999-99-99' message: '#type': textarea '#title': 'Повідомлення' '#required': true '#minlength': 10 '#rows': 5 department: '#type': select '#title': 'Відділ' '#options': sales: Продажі support: Підтримка other: Інше 

Умовна логіка — показ поля компанії тільки для юросіб:

 company_name: '#type': textfield '#title': 'Назва компанії' '#states': visible: ':input[name="client_type"]': value: business required: ':input[name="client_type"]': value: business 

Налаштування обробників

Email-обробник — стандартний, надсилає HTML-лист з даними. Webhook-обробник — передає дані в REST API CRM. Кастомний PHP-обробник — коли потрібні додаткові дії: запис у лог, відправка в Telegram, збагачення даних із зовнішнього API. Приклад кастомного обробника для CRM:

// src/Plugin/WebformHandler/CrmWebformHandler.php namespace Drupal\mymodule\Plugin\WebformHandler; use Drupal\webform\Plugin\WebformHandlerBase; use Drupal\webform\WebformSubmissionInterface; /** * @WebformHandler( * id = "crm_integration", * label = @Translation("CRM Integration"), * category = @Translation("External"), * description = @Translation("Sends submission to CRM"), * cardinality = WebformHandlerBase::CARDINALITY_SINGLE, * results = WebformHandlerBase::RESULTS_PROCESSED, * ) */ class CrmWebformHandler extends WebformHandlerBase { public function postSave(WebformSubmissionInterface $webform_submission, bool $update): void { $data = $webform_submission->getData(); \Drupal::httpClient()->post('https://crm.example.com/api/leads', [ 'json' => [ 'name' => $data['name'], 'email' => $data['email'], 'message' => $data['message'], 'source' => 'drupal-webform', ], ]); } } 

Цей обробник опрацьовує запити в 10 разів швидше, ніж email, що критично при високому навантаженні.

Поширені помилки при налаштуванні Webform

Що входить у налаштування?

При замовленні налаштування Webform ви отримуєте:

• YAML-конфігурацію всіх форм (версіонується в Git);
• Налаштовані обробники (email, webhook, кастомні);
• Інтеграцію з CRM/Telegram/іншими сервісами;
• Тестування 10+ сценаріїв (включаючи граничні випадки);
• Документацію по структурі форми та обробникам;
• Навчання операторів (показ інтерфейсу Results);
• Моніторинг та логування протягом 2 тижнів після деплою.

Терміни: проста форма з email — 3-5 годин. Інтеграція з CRM через кастомний обробник — плюс 1-2 дні. Вартість розраховується індивідуально.

Готова форма з Webform — це не лише збір заявок, а й повноцінний конвеєр: дані надходять в CRM миттєво, помилки валідації виключені, навантаження до 1000 заявок на день не викликає проблем. Ми гарантуємо безпомилкову роботу налаштованої форми протягом 12 місяців. Замовте налаштування Webform — отримайте робочу форму за 2 дні. Зв'яжіться з нами для консультації по вашому проєкту.

Додаткові матеріали: Webform module на Drupal.org, Webhook на Wikipedia.