Интеграция сайта с Битрикс24 через вебхуки: инструкция с примерами настройки

Интеграция сайта с Битрикс24 через вебхуки позволяет автоматизировать передачу данных между вашим веб-ресурсом и CRM-системой. В этой статье разберем пошаговый процесс настройки вебхуков, рассмотрим практические примеры кода и научимся создавать эффективные интеграции для автоматической обработки лидов, заказов и других важных данных.

Что такое вебхуки в Битрикс24

Вебхуки (webhooks) — это механизм для автоматической передачи данных между системами в режиме реального времени. В контексте Битрикс24 вебхуки позволяют:

• Автоматически создавать лиды из форм обратной связи
• Передавать данные о заказах из интернет-магазина
• Синхронизировать информацию о клиентах
• Запускать автоматические процессы в CRM
• Интегрировать сторонние сервисы с Битрикс24

Типы вебхуков в Битрикс24

Битрикс24 поддерживает два основных типа вебхуков:

Входящие вебхуки

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

Исходящие вебхуки

Исходящие вебхуки срабатывают при определенных событиях в Битрикс24 и отправляют данные во внешние системы.

Создание входящего вебхука в Битрикс24

Для создания входящего вебхука выполните следующие шаги:

1. Войдите в административную панель Битрикс24
2. Перейдите в раздел «Приложения» → «Вебхуки»
3. Нажмите «Добавить вебхук»
4. Выберите тип «Входящий вебхук»
5. Укажите название и описание вебхука
6. Выберите пользователя, от имени которого будут выполняться операции
7. Настройте права доступа для вебхука
8. Скопируйте полученный URL вебхука

Настройка прав доступа для вебхука

При создании вебхука обязательно настройте права доступа. Для типичных задач интеграции сайта потребуются следующие разрешения:

• crm — работа с CRM (лиды, сделки, контакты)
• user — работа с пользователями
• department — работа с отделами
• task — работа с задачами (при необходимости)

Практический пример: отправка данных формы в Битрикс24

Рассмотрим практический пример интеграции формы обратной связи с Битрикс24. Создадим HTML-форму и PHP-скрипт для отправки данных.

HTML-форма

<form id="contact-form" method="POST" action="send_to_bitrix.php">
<div>
<label for="name">Имя:</label>
<input type="text" id="name" name="name" required>
</div>
<div>
<label for="phone">Телефон:</label>
<input type="tel" id="phone" name="phone" required>
</div>
<div>
<label for="email">Email:</label>
<input type="email" id="email" name="email" required>
</div>
<div>
<label for="message">Сообщение:</label>
<textarea id="message" name="message" rows="5"></textarea>
</div>
<button type="submit">Отправить</button>
</form>

PHP-скрипт для отправки данных

<?php
// Параметры вебхука
$webhookUrl = 'https://ваш_домен.bitrix24.ru/rest/1/ваш_webhook_код/';
// Получаем данные из формы
$name = $_POST['name'] ?? '';
$phone = $_POST['phone'] ?? '';
$email = $_POST['email'] ?? '';
$message = $_POST['message'] ?? '';
// Подготавливаем данные для отправки
$leadData = [
'fields' => [
'TITLE' => 'Заявка с сайта от ' . $name,
'NAME' => $name,
'PHONE' => [
[
'VALUE' => $phone,
'VALUE_TYPE' => 'WORK'
]
],
'EMAIL' => [
[
'VALUE' => $email,
'VALUE_TYPE' => 'WORK'
]
],
'COMMENTS' => $message,
'SOURCE_ID' => 'WEB', // Источник - веб-сайт
'SOURCE_DESCRIPTION' => 'Заявка с сайта'
]
];
// Отправляем данные в Битрикс24
$result = sendToBitrix24($webhookUrl . 'crm.lead.add.json', $leadData);
if ($result) {
echo json_encode(['status' => 'success', 'message' => 'Заявка успешно отправлена']);
} else {
echo json_encode(['status' => 'error', 'message' => 'Ошибка при отправке заявки']);
}
function sendToBitrix24($url, $data) {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200) {
$result = json_decode($response, true);
return isset($result['result']) && $result['result'] > 0;
}
return false;
}
?>

Работа с контактами и компаниями

Для более сложных интеграций может потребоваться создание не только лидов, но и контактов или компаний. Вот пример создания контакта:

<?php
// Создание контакта
$contactData = [
'fields' => [
'NAME' => $name,
'PHONE' => [
[
'VALUE' => $phone,
'VALUE_TYPE' => 'WORK'
]
],
'EMAIL' => [
[
'VALUE' => $email,
'VALUE_TYPE' => 'WORK'
]
],
'COMMENTS' => 'Контакт создан через сайт',
'SOURCE_ID' => 'WEB'
]
];
$contactResult = sendToBitrix24($webhookUrl . 'crm.contact.add.json', $contactData);
?>

Обработка ошибок и логирование

Для надежной интеграции важно правильно обрабатывать ошибки и вести логи операций:

<?php
function sendToBitrix24WithLogging($url, $data) {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);
// Логирование запроса
$logData = [
'timestamp' => date('Y-m-d H:i:s'),
'url' => $url,
'data' => $data,
'response' => $response,
'http_code' => $httpCode,
'error' => $error
];
file_put_contents('bitrix24_log.txt', json_encode($logData) . "\n", FILE_APPEND);
if ($httpCode === 200) {
$result = json_decode($response, true);
if (isset($result['error'])) {
// Ошибка API Битрикс24
return [
'success' => false,
'error' => $result['error_description'] ?? 'Неизвестная ошибка API'
];
}
return [
'success' => true,
'id' => $result['result'] ?? null
];
}
return [
'success' => false,
'error' => 'HTTP Error: ' . $httpCode . ($error ? ' - ' . $error : '')
];
}
?>

Настройка исходящих вебхуков

Исходящие вебхуки позволяют получать уведомления о событиях в Битрикс24. Для настройки исходящего вебхука:

1. Создайте исходящий вебхук в Битрикс24
2. Укажите URL вашего обработчика
3. Выберите события, на которые нужно реагировать
4. Создайте скрипт-обработчик на вашем сайте

Пример обработчика исходящего вебхука

<?php
// webhook_handler.php
$input = file_get_contents('php://input');
$data = json_decode($input, true);
// Логирование входящих данных
file_put_contents('webhook_log.txt', date('Y-m-d H:i:s') . ' - ' . $input . "\n", FILE_APPEND);
// Обработка события
if (isset($data['event']) && isset($data['data'])) {
$event = $data['event'];
$eventData = $data['data'];
switch ($event) {
case 'ONCRMLEADADD':
// Обработка добавления лида
handleNewLead($eventData);
break;
case 'ONCRMDEALUPDATE':
// Обработка обновления сделки
handleDealUpdate($eventData);
break;
default:
// Обработка других событий
break;
}
}
function handleNewLead($data) {
// Отправка уведомления о новом лиде
$message = "Новый лид #{$data['FIELDS']['ID']}: {$data['FIELDS']['TITLE']}";
// Здесь можно добавить отправку email, SMS или другие действия
}
function handleDealUpdate($data) {
// Обработка обновления сделки
$message = "Обновлена сделка #{$data['FIELDS']['ID']}";
// Дополнительная логика обработки
}
?>

Интеграция с популярными CMS

Интеграция с WordPress

Для WordPress можно создать плагин интеграции с Битрикс24:

<?php
// В functions.php темы или в отдельном плагине
function bitrix24_integration_init() {
add_action('wp_ajax_send_to_bitrix24', 'handle_bitrix24_submission');
add_action('wp_ajax_nopriv_send_to_bitrix24', 'handle_bitrix24_submission');
}
function handle_bitrix24_submission() {
// Проверка nonce для безопасности
if (!wp_verify_nonce($_POST['nonce'], 'bitrix24_nonce')) {
wp_die('Ошибка безопасности');
}
$webhook_url = get_option('bitrix24_webhook_url');
if (!$webhook_url) {
wp_die('Не настроен URL вебхука');
}
$lead_data = [
'fields' => [
'TITLE' => 'Заявка с WordPress сайта',
'NAME' => sanitize_text_field($_POST['name']),
'PHONE' => [
[
'VALUE' => sanitize_text_field($_POST['phone']),
'VALUE_TYPE' => 'WORK'
]
],
'EMAIL' => [
[
'VALUE' => sanitize_email($_POST['email']),
'VALUE_TYPE' => 'WORK'
]
],
'COMMENTS' => sanitize_textarea_field($_POST['message']),
'SOURCE_ID' => 'WEB'
]
];
$result = wp_remote_post($webhook_url . 'crm.lead.add.json', [
'body' => $lead_data,
'timeout' => 30
]);
if (is_wp_error($result)) {
wp_die('Ошибка при отправке данных');
}
$response = json_decode(wp_remote_retrieve_body($result), true);
if (isset($response['result']) && $response['result'] > 0) {
echo json_encode(['status' => 'success']);
} else {
echo json_encode(['status' => 'error']);
}
wp_die();
}
add_action('init', 'bitrix24_integration_init');
?>

Интеграция с Битрикс

Для сайтов на 1С-Битрикс можно создать компонент интеграции:

<?php
// В компоненте или модуле
class CBitrix24Integration {
private $webhookUrl;
public function __construct($webhookUrl) {
$this->webhookUrl = $webhookUrl;
}
public function sendLead($data) {
$leadData = [
'fields' => [
'TITLE' => $data['title'],
'NAME' => $data['name'],
'PHONE' => [
[
'VALUE' => $data['phone'],
'VALUE_TYPE' => 'WORK'
]
],
'EMAIL' => [
[
'VALUE' => $data['email'],
'VALUE_TYPE' => 'WORK'
]
],
'COMMENTS' => $data['comments'],
'SOURCE_ID' => 'WEB'
]
];
return $this->makeRequest('crm.lead.add.json', $leadData);
}
private function makeRequest($method, $data) {
$url = $this->webhookUrl . $method;
$httpClient = new \Bitrix\Main\Web\HttpClient();
$response = $httpClient->post($url, $data);
if ($response) {
$result = json_decode($response, true);
return isset($result['result']) && $result['result'] > 0;
}
return false;
}
}
?>

Безопасность и лучшие практики

При работе с вебхуками важно соблюдать принципы безопасности:

Валидация данных

• Всегда валидируйте и санитизируйте входящие данные
• Используйте фильтры для email и телефонов
• Ограничивайте длину текстовых полей

Аутентификация

• Храните URL вебхуков в безопасном месте
• Используйте HTTPS для всех запросов
• Регулярно обновляйте вебхуки

Ограничения и лимиты

• Учитывайте лимиты API Битрикс24 (обычно 50 запросов в секунду)
• Реализуйте механизм повторных попыток
• Используйте очереди для массовых операций

Отладка и тестирование

Для эффективной отладки интеграции используйте следующие инструменты:

Тестирование вебхуков

<?php
// Скрипт для тестирования вебхука
$webhookUrl = 'https://ваш_домен.bitrix24.ru/rest/1/ваш_webhook_код/';
// Тестовые данные
$testData = [
'fields' => [
'TITLE' => 'Тестовый лид',
'NAME' => 'Тестовый пользователь',
'PHONE' => [
[
'VALUE' => '+7 (999) 123-45-67',
'VALUE_TYPE' => 'WORK'
]
],
'EMAIL' => [
[
'VALUE' => 'test@example.com',
'VALUE_TYPE' => 'WORK'
]
],
'COMMENTS' => 'Тестовая заявка для проверки интеграции'
]
];
// Отправка тестового запроса
$result = testWebhook($webhookUrl . 'crm.lead.add.json', $testData);
if ($result['success']) {
echo "Тест пройден успешно. ID лида: " . $result['id'];
} else {
echo "Ошибка тестирования: " . $result['error'];
}
function testWebhook($url, $data) {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_VERBOSE, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo "HTTP код: " . $httpCode . "\n";
echo "Ответ: " . $response . "\n";
if ($httpCode === 200) {
$result = json_decode($response, true);
if (isset($result['result']) && $result['result'] > 0) {
return ['success' => true, 'id' => $result['result']];
} else {
return ['success' => false, 'error' => $result['error_description'] ?? 'Неизвестная ошибка'];
}
}
return ['success' => false, 'error' => 'HTTP Error: ' . $httpCode];
}
?>

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

Работа с пользовательскими полями

Битрикс24 позволяет создавать пользовательские поля для различных сущностей. Вот пример работы с ними:

<?php
// Получение списка пользовательских полей для лидов
$fieldsUrl = $webhookUrl . 'crm.lead.userfield.list.json';
$fields = sendToBitrix24($fieldsUrl, []);
// Создание лида с пользовательским полем
$leadData = [
'fields' => [
'TITLE' => 'Заявка с дополнительными полями',
'NAME' => $name,
'PHONE' => [
[
'VALUE' => $phone,
'VALUE_TYPE' => 'WORK'
]
],
'UF_CRM_XXXXX' => 'Значение пользовательского поля', // Замените XXXXX на ID вашего поля
'UF_CRM_YYYYY' => $_POST['custom_field'] ?? ''
]
];
?>

Массовые операции

Для обработки больших объемов данных используйте batch-запросы:

<?php
// Пример массового создания лидов
$batchData = [
'cmd' => []
];
foreach ($leads as $index => $leadData) {
$batchData['cmd']['lead_' . $index] = 'crm.lead.add?' . http_build_query(['fields' => $leadData]);
}
$result = sendToBitrix24($webhookUrl . 'batch.json', $batchData);
?>

Мониторинг и аналитика

Для контроля качества интеграции рекомендуется настроить мониторинг:

<?php
// Простая система мониторинга
class Bitrix24Monitor {
private $logFile = 'bitrix24_stats.log';
public function logRequest($success, $responseTime, $error = null) {
$data = [
'timestamp' => time(),
'success' => $success,
'response_time' => $responseTime,
'error' => $error
];
file_put_contents($this->logFile, json_encode($data) . "\n", FILE_APPEND);
}
public function getStats($period = 3600) { // За последний час
$since = time() - $period;
$lines = file($this->logFile, FILE_IGNORE_NEW_LINES);
$stats = [
'total' => 0,
'success' => 0,
'errors' => 0,
'avg_response_time' => 0
];
$responseTimes = [];
foreach ($lines as $line) {
$data = json_decode($line, true);
if ($data && $data['timestamp'] >= $since) {
$stats['total']++;
if ($data['success']) {
$stats['success']++;
} else {
$stats['errors']++;
}
$responseTimes[] = $data['response_time'];
}
}
if (count($responseTimes) > 0) {
$stats['avg_response_time'] = array_sum($responseTimes) / count($responseTimes);
}
return $stats;
}
}
?>

Заключение

Интеграция сайта с Битрикс24 через вебхуки — это мощный инструмент для автоматизации бизнес-процессов. Правильная настройка позволяет:

• Автоматически создавать лиды из форм обратной связи
• Синхронизировать данные между системами
• Снизить количество ручного труда
• Повысить скорость обработки заявок
• Улучшить качество работы с клиентами

Помните о важности безопасности, валидации данных и мониторинга работы интеграции. При правильной реализации вебхуки станут надежным мостом между вашим сайтом и CRM-системой.

Наша компания предоставляет профессиональные услуги по настройке и внедрению Битрикс24. Мы поможем вам создать эффективную интеграцию сайта с CRM, настроить автоматизацию бизнес-процессов и обеспечить стабильную работу всех систем. Обращайтесь к нашим специалистам для получения консультации и разработки индивидуального решения для вашего бизнеса.