Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Добавить лид с файлами через веб-форму». Вы узнаете экспертные методики работы с битрикс и научитесь избегать типичных ошибок начинающих разработчиков.

Добавить лид с файлами через веб-форму

> Scope: crm
>
> Кто может выполнять метод: пользователи с правом создания лидов в CRM

На сайте можно разместить форму для сбора данных потенциальных клиентов. Когда клиент заполнит форму и приложит файлы, его данные попадут в CRM, и вы сможете обработать заявку.

Настройка формы состоит из двух шагов.

1. Разместите форму на HTML-странице. Она отправит данные в обработчик.

2. Создайте файл для обработки данных. Обработчик примет и подготовит данные, а затем создаст лид методом crm.lead.add.

1. Создаем веб-форму

В Битрикс24 из лида можно автоматически создать контакт и компанию. Чтобы форма подходила для разных случаев, сделаем ее универсальной. Для контакта нужно указать имя и фамилию, а для компании — название. Создадим на странице сайта веб-форму с полями:

NAME — имя, обязательное,

LAST_NAME — фамилия,

COMPANY_TITLE — название компании,

EMAIL — электронная почта,

PHONE — телефон.

Чтобы клиент мог загрузить файлы, добавим в форму поля:

FILE — для одного файла,

FILES — для добавления нескольких файлов.

При отправке форма передает данные в обработчик form.php.

<form id="form_to_crm" method="POST" action="form.php" enctype="multipart/form-data">
    <!-- Имя (обязательное поле) -->
    <input type="text" name="NAME" placeholder="Имя" required>
    <!-- Фамилия -->
    <input type="text" name="LAST_NAME" placeholder="Фамилия">
    <!-- Название компании -->
    <input type="text" name="COMPANY_TITLE" placeholder="Название компании">
    <!-- Email -->
    <input type="text" name="EMAIL" placeholder="Почта">
    <!-- Телефон -->
    <input type="text" name="PHONE" placeholder="Телефон">
    <!-- Поле для одного файла -->
    <input type="file" name="FILE">
    <!-- Поле для нескольких файлов -->
    <input type="file" name="FILES" multiple">

    <!-- Кнопка отправки -->
    <input type="submit" value="Отправить">
</form>

<!-- Подключаем jQuery для AJAX-запроса -->
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
<script>
	$(document).ready(function() {
	    $('#form_to_crm').on('submit', function(el) {
	        el.preventDefault();
	        var formData = new FormData(this); // Собираем данные формы с файлами
	        $.ajax({
	            method: 'POST',
	            url: 'form.php',
	            data: formData,
	            processData: false,
	            contentType: false,
	            dataType: 'json',
	            success: function(data) {
	                alert(data.message);
	            },
	            error: function() {
	                alert('Ошибка при отправке формы');
	            }
	        });
	    });
	});
</script>

2. Создаем обработчик формы

Чтобы обработать значения из полей формы и добавить лид в CRM, создадим обработчик form.php.

Подготавливаем данные из формы

Чтобы использовать данные из формы в методе создания лида, нужно их подготовить.

Очищаем от HTML-тегов

Получаем и очищаем от HTML-тегов данные из формы.

// Получаем и очищаем данные из формы
$sName = htmlspecialchars($_POST["NAME"]);
$sLastName = htmlspecialchars($_POST["LAST_NAME"]);
$sCompanyTitle = htmlspecialchars($_POST["COMPANY_TITLE"]);
$sPhone = htmlspecialchars($_POST["PHONE"]);
$sEmail = htmlspecialchars($_POST["EMAIL"]);

Подготавливаем файлы

Подготавливаем файлы для загрузки в Битрикс24. Для каждого файла нужно передать массив:

с именем файла,

строкой с кодировкой файла в Base64.

Чтобы закодировать файл, используем функцию base64_encode.

Как работать с файлами

// Создаем переменные для массивов с файлами
$arFiles = [];
$arSingleFile = [];

// Обрабатываем поле FILES с несколькими файлами
if(!empty($_FILES['FILES']['tmp_name'])) {
    foreach($_FILES['FILES']['tmp_name'] as $key => $tmpName) {
        if(!empty($tmpName)) {
            $arFiles[] = [
                'fileData' => [
                    $_FILES['FILES']['name'][$key], // название файла
                    base64_encode(file_get_contents($tmpName)) // контент файла, закодированный в base64 
                ]
            ];
        }
    }
}

// Обрабатываем поле FILE с одним файлом
if(!empty($_FILES['FILE']['tmp_name'])) {
    $arSingleFile = [
        'fileData' => [
            $_FILES['FILE']['name'], // название файла
            base64_encode(file_get_contents($_FILES['FILE']['tmp_name'])) // контент файла, закодированный в base64 
        ]
    ];
}

Форматируем телефон и почту

Телефон и email система хранит как массив объектов crm_multifield, поэтому их нужно привести к формату массива.

1. Если значение есть, добавляем его первым элементом VALUE в массив, а вторым значением указываем тип VALUE_TYPE, например:

WORK — для телефона,

HOME — для email.

2. Если значения нет, передаем пустой массив.

// Форматируем телефон и почту для Битрикс24 в формат crm_multifield
$arPhone = (!empty($sPhone)) ? array(array('VALUE' => $sPhone, 'VALUE_TYPE' => 'WORK')) : array();
$arEmail = (!empty($sEmail)) ? array(array('VALUE' => $sEmail, 'VALUE_TYPE' => 'HOME')) : array();

Формируем заголовок лида

Заголовок лида сформируем из имени и фамилии. Для компаний добавим в заголовок название компании.

// Формируем заголовок лида из имени и фамилии
$sTitle = 'С сайта: ' . trim($sName . ' ' . $sLastName);
// Если есть название компании — добавляем его через тире после имени и фамилии
if (!empty($sCompanyTitle)) {
    $sTitle .= ' — ' . $sCompanyTitle;
}

Создаем лид

Для создания лида используем метод crm.lead.add. В объекте fields передаем поля:

TITLE — заголовок лида,

NAME — имя лида,

LAST_NAME — фамилия,

COMPANY_TITLE — название компании,

PHONE — номер телефона,

EMAIL — электронная почта,

UF_CRM_LEAD_FILES — пользовательское поле для добавления нескольких файлов,

UF_CRM_LEAD_FILE — пользовательское поле для файла.

Пользовательские поля UF_CRM_* нужно создать в Битрикс24 до создания лида. Добавьте их на портале вручную или методом crm.lead.userfield.add. В примере подставьте свои названия полей вместо UF_CRM_LEAD_FILES и UF_CRM_LEAD_FILE.

Проверьте, какие обязательные поля настроены для лидов в вашем Битрикс24. Все обязательные поля нужно передать в метод crm.lead.add.

CRest::call(
    'crm.lead.add',
    [
        'fields' => [
            'TITLE' => $sTitle, // Заголовок лида
            'NAME' => $sName, // Имя
            'LAST_NAME' => $sLastName, // Фамилия
            'COMPANY_TITLE' => $sCompanyTitle, // Название компании
            'PHONE' => $arPhone, // Телефон
            'EMAIL' => $arEmail, // Email
            'UF_CRM_LEAD_FILES' => $arFiles, // Поле для добавления нескольких файлов
            'UF_CRM_LEAD_FILE' => $arSingleFile // Поле для файла
        ]
    ]
);

В результате получим идентификатор нового лида 5.

{
	"result": 5
}

Полный пример кода обработчика

<?
require_once('crest.php');

// Получаем и очищаем данные из формы
$sName = htmlspecialchars($_POST["NAME"]);
$sLastName = htmlspecialchars($_POST["LAST_NAME"]);
$sCompanyTitle = htmlspecialchars($_POST["COMPANY_TITLE"]);
$sPhone = htmlspecialchars($_POST["PHONE"]);
$sEmail = htmlspecialchars($_POST["EMAIL"]);

// Создаем переменные для массивов с файлами
$arFiles = [];
$arSingleFile = [];

// Обрабатываем поле FILES с несколькими файлами
if(!empty($_FILES['FILES']['tmp_name']) {
    foreach($_FILES['FILES']['tmp_name'] as $key => $tmpName) {
        if(!empty($tmpName)) {
            $arFiles[] = [
                'fileData' => [
                    $_FILES['FILES']['name'][$key],
                    base64_encode(file_get_contents($tmpName))
                ]
            ];
        }
    }
}

// Обрабатываем поле FILE с одним файлом
if(!empty($_FILES['FILE']['tmp_name'])) {
    $arSingleFile = [
        'fileData' => [
            $_FILES['FILE']['name'],
            base64_encode(file_get_contents($_FILES['FILE']['tmp_name']))
        ]
    ];
}

// Форматируем телефон и почту для Битрикс24 в формат crm_multifield
$arPhone = (!empty($sPhone)) ? array(array('VALUE' => $sPhone, 'VALUE_TYPE' => 'WORK')) : array();
$arEmail = (!empty($sEmail)) ? array(array('VALUE' => $sEmail, 'VALUE_TYPE' => 'HOME')) : array();

// Формируем заголовок лида из имени и фамилии
$sTitle = 'С сайта: ' . trim($sName . ' ' . $sLastName);
// Если есть название компании — добавляем его через тире после имени и фамилии
if (!empty($sCompanyTitle)) {
    $sTitle .= ' — ' . $sCompanyTitle;
}

// Отправляем данные в Битрикс24
$result = CRest::call(
    'crm.lead.add',
    [
        'fields' => [
            'TITLE' => $sTitle, // Заголовок лида
            'NAME' => $sName, // Имя
            'LAST_NAME' => $sLastName, // Фамилия
            'COMPANY_TITLE' => $sCompanyTitle, // Название компании
            'PHONE' => $arPhone, // Телефон
            'EMAIL' => $arEmail, // Email
            'UF_CRM_LEAD_FILES' => $arFiles, // Поле для добавления нескольких файлов
            'UF_CRM_LEAD_FILE' => $arSingleFile // Поле для файла
        ]
    ]
);

// Проверяем результат и выводим сообщение
if(!empty($result['result'])){
    echo json_encode(['message' => 'Лид добавлен успешно']);
} elseif(!empty($result['error_description'])){
    echo json_encode(['message' => 'Лид не добавлен: '.$result['error_description']]);
} else {
    echo json_encode(['message' => 'Лид не добавлен']);
}
?>

💡 Экспертное мнение и рекомендации

Практические рекомендации:

При написании кастомных компонентов для «Добавить лид с файлами через веб-форму» всегда разделяйте бизнес-логику и представление (шаблон).
Используйте отладку SQL-запросов через конструкцию $wpdb->last_query или стандартный трекер Битрикса, чтобы контролировать нагрузку.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Написать во ВКонтакте

или на почту: gorandvas@yandex.ru

Добавить лид с файлами через веб-форму

Добавить лид с файлами через веб-форму

1. Создаем веб-форму

2. Создаем обработчик формы

Подготавливаем данные из формы

Очищаем от HTML-тегов

Подготавливаем файлы

Форматируем телефон и почту

Формируем заголовок лида

Создаем лид

Полный пример кода обработчика

💡 Экспертное мнение и рекомендации

Практические рекомендации:

Помогу автоматизировать процессы и внедрить ИИ

Related Post

Изменить раздел торгового каталога catalog.section.updateИзменить раздел торгового каталога catalog.section.update

Как использовать метод SDK crm.lead.productrows.set в Битрикс24Как использовать метод SDK crm.lead.productrows.set в Битрикс24

Как использовать метод SDK task.checklistitem.add в Битрикс24Как использовать метод SDK task.checklistitem.add в Битрикс24