Основы работы с API сделок Битрикс24

API сделок в Битрикс24 предоставляет полный набор инструментов для управления воронкой продаж. Основные возможности включают:

• Создание новых сделок
• Получение списка существующих сделок
• Обновление данных сделки
• Удаление сделок
• Работа с дополнительными полями
• Управление связанными объектами

Авторизация и подготовка к работе

Для работы с API необходимо получить токен доступа. Это можно сделать несколькими способами:

• Входящий вебхук — простой способ для внутренних интеграций
• Приложение — для создания полноценных решений
• OAuth 2.0 — для сложных интеграций с внешними системами

Метод crm.deal.add: создание новых сделок

Основной метод для создания сделок — crm.deal.add. Он позволяет добавлять новые записи с заполнением всех необходимых полей.

Синтаксис и параметры

Базовый синтаксис запроса:

POST https://ваш-портал.bitrix24.ru/rest/crm.deal.add.json

Обязательные параметры:

• TITLE — название сделки
• STAGE_ID — идентификатор стадии воронки
• CATEGORY_ID — идентификатор направления (воронки)

Пример создания сделки

Рассмотрим практический пример создания сделки с основными полями:

{
"fields": {
"TITLE": "Новая сделка из API",
"STAGE_ID": "NEW",
"CATEGORY_ID": 0,
"OPPORTUNITY": 50000,
"CURRENCY_ID": "RUB",
"CONTACT_ID": 123,
"COMPANY_ID": 456,
"ASSIGNED_BY_ID": 1,
"COMMENTS": "Сделка создана через API",
"SOURCE_ID": "WEB",
"SOURCE_DESCRIPTION": "Заявка с сайта"
}
}

Работа с дополнительными полями

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

{
"fields": {
"TITLE": "Сделка с доп. полями",
"STAGE_ID": "NEW",
"UF_CRM_CUSTOM_FIELD": "Значение пользовательского поля",
"UF_CRM_DATETIME_FIELD": "2026-01-15T10:30:00+03:00"
}
}

Получение данных о сделках

Метод crm.deal.get

Для получения информации о конкретной сделке используется метод crm.deal.get:

GET https://ваш-портал.bitrix24.ru/rest/crm.deal.get.json?id=123

Метод crm.deal.list

Для получения списка сделок с возможностью фильтрации применяется crm.deal.list:

{
"filter": {
"STAGE_ID": "NEW",
"ASSIGNED_BY_ID": 1,
">=OPPORTUNITY": 10000
},
"select": ["ID", "TITLE", "OPPORTUNITY", "STAGE_ID", "DATE_CREATE"],
"order": {"DATE_CREATE": "DESC"},
"start": 0
}

Обновление существующих сделок

Метод crm.deal.update

Для изменения данных сделки используется метод crm.deal.update:

{
"id": 123,
"fields": {
"STAGE_ID": "PREPAYMENT_INVOICE",
"OPPORTUNITY": 75000,
"COMMENTS": "Обновлено через API"
}
}

Массовое обновление

Для обновления нескольких сделок одновременно можно использовать пакетные запросы:

{
"halt": 0,
"cmd": {
"deal_1": "crm.deal.update?id=123&fields[STAGE_ID]=PREPAYMENT_INVOICE",
"deal_2": "crm.deal.update?id=124&fields[STAGE_ID]=PREPAYMENT_INVOICE"
}
}

Работа с полями сделок

Получение описания полей

Для получения полного списка доступных полей используется метод crm.deal.fields:

GET https://ваш-портал.bitrix24.ru/rest/crm.deal.fields.json

Основные поля сделок

Наиболее важные поля при работе с API:

• ID — уникальный идентификатор
• TITLE — название сделки
• STAGE_ID — стадия воронки
• CATEGORY_ID — направление (воронка)
• OPPORTUNITY — сумма сделки
• CURRENCY_ID — валюта
• PROBABILITY — вероятность закрытия
• CONTACT_ID — связанный контакт
• COMPANY_ID — связанная компания
• ASSIGNED_BY_ID — ответственный
• CREATED_BY_ID — кто создал
• MODIFY_BY_ID — кто изменил
• DATE_CREATE — дата создания
• DATE_MODIFY — дата изменения
• BEGINDATE — дата начала
• CLOSEDATE — дата закрытия
• CLOSED — признак закрытой сделки
• SOURCE_ID — источник
• SOURCE_DESCRIPTION — описание источника

Практические примеры интеграции

Создание сделки из формы на сайте

Типичный сценарий — создание сделки при отправке формы с сайта:

function createDealFromForm($formData) {
$dealData = [
'fields' => [
'TITLE' => 'Заявка с сайта: ' . $formData['service'],
'STAGE_ID' => 'NEW',
'CATEGORY_ID' => 0,
'OPPORTUNITY' => $formData['budget'] ?? 0,
'CURRENCY_ID' => 'RUB',
'ASSIGNED_BY_ID' => 1,
'SOURCE_ID' => 'WEB',
'SOURCE_DESCRIPTION' => 'Форма обратной связи',
'COMMENTS' => 'Телефон: ' . $formData['phone'] .
'\nEmail: ' . $formData['email'] .
'\nСообщение: ' . $formData['message'],
'UF_CRM_PHONE' => $formData['phone'],
'UF_CRM_EMAIL' => $formData['email']
]
];
// Отправка запроса к API
return sendRequest('crm.deal.add', $dealData);
}

Синхронизация с внешней системой

Пример синхронизации данных из внешней CRM:

function syncExternalDeals($externalDeals) {
$results = [];
foreach ($externalDeals as $externalDeal) {
// Проверяем, существует ли сделка
$existingDeal = findDealByExternalId($externalDeal['external_id']);
$dealData = [
'TITLE' => $externalDeal['title'],
'OPPORTUNITY' => $externalDeal['amount'],
'STAGE_ID' => mapExternalStage($externalDeal['stage']),
'UF_CRM_EXTERNAL_ID' => $externalDeal['external_id'],
'DATE_MODIFY' => date('Y-m-d H:i:s')
];
if ($existingDeal) {
// Обновляем существующую сделку
$results[] = updateDeal($existingDeal['ID'], $dealData);
} else {
// Создаем новую сделку
$results[] = createDeal($dealData);
}
}
return $results;
}

Обработка ошибок и отладка

Типичные ошибки при работе с API

Наиболее частые проблемы и их решения:

• Неверный STAGE_ID — проверьте актуальные стадии через crm.status.list
• Отсутствие прав доступа — убедитесь в корректности токена
• Неверный формат данных — проверьте типы полей через crm.deal.fields
• Превышение лимитов — используйте пакетные запросы для массовых операций

Логирование и мониторинг

Рекомендуется вести логи всех операций с API:

function logApiRequest($method, $params, $response) {
$logData = [
'timestamp' => date('Y-m-d H:i:s'),
'method' => $method,
'params' => $params,
'response' => $response,
'success' => !isset($response['error'])
];
file_put_contents('api_log.json', json_encode($logData) . "\n", FILE_APPEND);
}

Оптимизация производительности

Пакетные запросы

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

{
"halt": 0,
"cmd": {
"deal_1": "crm.deal.add?fields[TITLE]=Сделка 1&fields[STAGE_ID]=NEW",
"deal_2": "crm.deal.add?fields[TITLE]=Сделка 2&fields[STAGE_ID]=NEW",
"deal_3": "crm.deal.add?fields[TITLE]=Сделка 3&fields[STAGE_ID]=NEW"
}
}

Кэширование данных

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

function getStagesList($useCache = true) {
$cacheKey = 'bitrix24_stages';
$cacheTime = 3600; // 1 час
if ($useCache && $cached = getFromCache($cacheKey)) {
return $cached;
}
$stages = sendRequest('crm.status.list', [
'filter' => ['ENTITY_ID' => 'DEAL_STAGE']
]);
if ($useCache) {
setToCache($cacheKey, $stages, $cacheTime);
}
return $stages;
}

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

Защита токенов доступа

Основные рекомендации по безопасности:

• Храните токены в переменных окружения
• Используйте HTTPS для всех запросов
• Регулярно обновляйте токены
• Ограничивайте права доступа по принципу минимальных привилегий
• Ведите аудит всех операций

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

Всегда проверяйте входящие данные перед отправкой в API:

function validateDealData($data) {
$errors = [];
if (empty($data['TITLE'])) {
$errors[] = 'Название сделки обязательно';
}
if (empty($data['STAGE_ID'])) {
$errors[] = 'Стадия сделки обязательна';
}
if (isset($data['OPPORTUNITY']) && !is_numeric($data['OPPORTUNITY'])) {
$errors[] = 'Сумма должна быть числом';
}
if (isset($data['CURRENCY_ID']) && !in_array($data['CURRENCY_ID'], ['RUB', 'USD', 'EUR'])) {
$errors[] = 'Неверный код валюты';
}
return $errors;
}

Интеграция с вебхуками

Для автоматической обработки изменений в сделках используйте вебхуки:

Настройка вебхуков

Основные события для отслеживания:

• ONCRMDEALUPDATE — обновление сделки
• ONCRMDEALDELETE — удаление сделки
• ONCRMDEALADD — добавление сделки

Обработка событий

function handleDealWebhook($eventData) {
switch ($eventData['event']) {
case 'ONCRMDEALUPDATE':
handleDealUpdate($eventData['data']);
break;
case 'ONCRMDEALADD':
handleDealAdd($eventData['data']);
break;
case 'ONCRMDEALDELETE':
handleDealDelete($eventData['data']);
break;
}
}

Заключение

Работа с API сделок Битрикс24 открывает широкие возможности для автоматизации и интеграции. Основные методы — crm.deal.add, crm.deal.update, crm.deal.get и crm.deal.list — позволяют полноценно управлять воронкой продаж программными средствами.

При разработке интеграций важно учитывать особенности API, правильно обрабатывать ошибки и следовать лучшим практикам безопасности. Использование пакетных запросов и кэширования поможет обеспечить высокую производительность решения.

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

Сообщение Работа со сделками в Битрикс24 через API в 2026: инструкция по добавлению и управлению появились сначала на Битрикс24.

Что дает интеграция сайта с Битрикс24

Интеграция веб-сайта с Битрикс24 через API решает несколько ключевых бизнес-задач:

• Автоматическая передача лидов: все заявки с сайта мгновенно попадают в CRM без участия человека
• Исключение потерь заявок: каждое обращение фиксируется в системе с точной датой и временем
• Быстрая реакция на обращения: менеджеры получают уведомления о новых лидах в режиме реального времени
• Детальная аналитика: возможность отслеживать источники заявок и эффективность каналов привлечения
• Автоматизация воронки продаж: настройка автоматических действий при получении новых лидов

Подготовка к интеграции: что нужно знать

Перед началом работы с API Битрикс24 необходимо понимать основные принципы взаимодействия:

REST API Битрикс24: основы

Битрикс24 предоставляет REST API для интеграции с внешними системами. Для работы с API потребуется:

• Webhook URL или OAuth авторизация
• Знание методов API для работы с лидами
• Понимание структуры данных в Битрикс24

Типы авторизации

Входящий webhook — самый простой способ для базовой интеграции:

• Не требует сложной настройки OAuth
• Подходит для внутренних интеграций
• Имеет ограничения по количеству запросов

OAuth 2.0 — рекомендуемый метод для продакшн-решений:

• Более безопасный способ авторизации
• Поддерживает обновление токенов
• Подходит для коммерческих приложений

Пошаговая настройка интеграции

Шаг 1: Создание входящего webhook в Битрикс24

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

1. Перейдите в раздел «Приложения» → «Разработчикам» → «Другое»
2. Выберите «Входящий webhook»
3. Укажите название интеграции (например, «Заявки с сайта»)
4. Выберите пользователя, от имени которого будут выполняться операции
5. Настройте права доступа:
   • CRM — для работы с лидами
   • Пользователи — для получения информации о сотрудниках
   • Универсальные методы — для дополнительных возможностей
6. Сохраните настройки и скопируйте URL webhook

Шаг 2: Анализ структуры данных

Перед написанием кода интеграции изучите структуру лидов в вашем Битрикс24:

• Стандартные поля: NAME, LAST_NAME, EMAIL, PHONE
• Пользовательские поля: могут иметь префикс UF_CRM_
• Источники: настройте список источников заявок
• Воронки и стадии: определите, в какую воронку попадают лиды

Шаг 3: Написание скрипта интеграции

Создайте PHP-скрипт для обработки заявок с сайта:

<?php
// Конфигурация
define('BITRIX24_WEBHOOK_URL', 'https://your-domain.bitrix24.ru/rest/1/xxxxxxxxxx/');
// Функция для отправки данных в Битрикс24
function sendToBitrix24($method, $data) {
$url = BITRIX24_WEBHOOK_URL . $method;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Content-Length: ' . strlen(json_encode($data))
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return [
'httpCode' => $httpCode,
'response' => json_decode($response, true)
];
}
// Обработка POST-запроса с формы
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
$name = $_POST['name'] ?? '';
$email = $_POST['email'] ?? '';
$phone = $_POST['phone'] ?? '';
$message = $_POST['message'] ?? '';
// Подготовка данных для отправки
$leadData = [
'fields' => [
'TITLE' => 'Заявка с сайта от ' . $name,
'NAME' => $name,
'EMAIL' => [['VALUE' => $email, 'VALUE_TYPE' => 'WORK']],
'PHONE' => [['VALUE' => $phone, 'VALUE_TYPE' => 'WORK']],
'COMMENTS' => $message,
'SOURCE_ID' => 'WEB', // Источник - сайт
'ASSIGNED_BY_ID' => 1, // ID ответственного
'OPENED' => 'Y'
]
];
// Отправка лида в Битрикс24
$result = sendToBitrix24('crm.lead.add', $leadData);
if ($result['httpCode'] === 200 && isset($result['response']['result'])) {
echo json_encode(['success' => true, 'leadId' => $result['response']['result']]);
} else {
echo json_encode(['success' => false, 'error' => $result['response']['error']]);
}
}
?>

Шаг 4: Создание формы на сайте

Создайте HTML-форму для сбора заявок:

<form id="leadForm" method="POST">
<div class="form-group">
<label for="name">Имя:</label>
<input type="text" id="name" name="name" required>
</div>
<div class="form-group">
<label for="email">Email:</label>
<input type="email" id="email" name="email" required>
</div>
<div class="form-group">
<label for="phone">Телефон:</label>
<input type="tel" id="phone" name="phone" required>
</div>
<div class="form-group">
<label for="message">Сообщение:</label>
<textarea id="message" name="message"></textarea>
</div>
<button type="submit">Отправить заявку</button>
</form>
<script>
document.getElementById('leadForm').addEventListener('submit', function(e) {
e.preventDefault();
const formData = new FormData(this);
fetch('lead-handler.php', {
method: 'POST',
body: formData
})
.then(response => response.json())
.then(data => {
if (data.success) {
alert('Заявка успешно отправлена!');
this.reset();
} else {
alert('Ошибка при отправке заявки: ' + data.error);
}
})
.catch(error => {
alert('Ошибка сети: ' + error);
});
});
</script>

Расширенные возможности интеграции

Работа с дополнительными полями

Для передачи дополнительных данных в Битрикс24 можно использовать пользовательские поля:

// Получение списка пользовательских полей
$fields = sendToBitrix24('crm.lead.fields', []);
// Добавление данных в пользовательские поля
$leadData['fields']['UF_CRM_CUSTOM_FIELD'] = 'Значение';

Настройка автоматических действий

После создания лида можно настроить автоматические действия:

• Назначение ответственного на основе времени обращения или источника
• Отправка уведомлений менеджерам о новых заявках
• Создание задач для обработки лидов
• Запуск бизнес-процессов для автоматизации воронки продаж

Работа с файлами и вложениями

Если форма содержит файлы, их можно передать в Битрикс24:

// Загрузка файла
if (isset($_FILES['file']) && $_FILES['file']['error'] === UPLOAD_ERR_OK) {
$fileData = [
'fields' => [
'filename' => $_FILES['file']['name'],
'content' => base64_encode(file_get_contents($_FILES['file']['tmp_name']))
]
];
$fileResult = sendToBitrix24('crm.lead.file.add', $fileData);
}

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

Типичные ошибки и их решения

Ошибки авторизации:

• Проверьте правильность URL webhook
• Убедитесь, что webhook не был удален или изменен
• Проверьте права доступа для webhook

Ошибки данных:

• Проверьте обязательные поля
• Убедитесь в правильности формата данных
• Проверьте существование пользовательских полей

Система логирования

Добавьте логирование для отладки интеграции:

function logIntegration($data, $response) {
$logEntry = [
'timestamp' => date('Y-m-d H:i:s'),
'data' => $data,
'response' => $response
];
file_put_contents('integration.log', json_encode($logEntry) . "\n", FILE_APPEND);
}

Тестирование интеграции

Проверка работоспособности

Перед запуском интеграции в продакшн проведите тестирование:

1. Тестирование подключения: проверьте доступность API
2. Тестирование данных: отправьте тестовые заявки
3. Проверка полей: убедитесь, что все данные корректно передаются
4. Тестирование ошибок: проверьте поведение при некорректных данных

Мониторинг работы

После запуска интеграции настройте мониторинг:

• Регулярно проверяйте логи интеграции
• Сравнивайте количество заявок на сайте и в CRM
• Настройте уведомления об ошибках
• Отслеживайте время отклика API

Оптимизация производительности

Асинхронная обработка

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

// Сохранение заявки в локальную базу данных
function saveLeadToQueue($leadData) {
$pdo = new PDO('mysql:host=localhost;dbname=site', $username, $password);
$stmt = $pdo->prepare("INSERT INTO lead_queue (data, created_at) VALUES (?, NOW())");
$stmt->execute([json_encode($leadData)]);
}
// Обработка очереди через cron
function processLeadQueue() {
$pdo = new PDO('mysql:host=localhost;dbname=site', $username, $password);
$stmt = $pdo->query("SELECT * FROM lead_queue WHERE processed = 0 LIMIT 10");
while ($row = $stmt->fetch()) {
$leadData = json_decode($row['data'], true);
$result = sendToBitrix24('crm.lead.add', $leadData);
if ($result['httpCode'] === 200) {
$updateStmt = $pdo->prepare("UPDATE lead_queue SET processed = 1 WHERE id = ?");
$updateStmt->execute([$row['id']]);
}
}
}

Кэширование и оптимизация запросов

Для улучшения производительности используйте кэширование:

• Кэшируйте списки пользователей и источников
• Используйте пакетные операции для множественных запросов
• Оптимизируйте количество обращений к API

Безопасность интеграции

Защита webhook URL

Обеспечьте безопасность вашей интеграции:

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

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

Всегда проверяйте входящие данные:

function validateLeadData($data) {
$errors = [];
if (empty($data['name'])) {
$errors[] = 'Имя обязательно для заполнения';
}
if (empty($data['email']) || !filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
$errors[] = 'Некорректный email';
}
if (empty($data['phone'])) {
$errors[] = 'Телефон обязателен для заполнения';
}
return $errors;
}

Альтернативные способы интеграции

Готовые решения

Помимо разработки собственной интеграции, существуют готовые решения:

• Виджеты Битрикс24: встраиваемые формы для сайта
• CRM-формы: готовые формы с автоматической интеграцией
• Коннекторы: готовые модули для популярных CMS

Интеграция через сторонние сервисы

Можно использовать сервисы-агрегаторы:

• Zapier для автоматизации без программирования
• Integromat для сложных сценариев интеграции
• Pipedream для разработчиков

Часто задаваемые вопросы

Вопрос: Сколько запросов в день можно отправлять через webhook?

Ответ: Лимиты зависят от тарифа Битрикс24. Для коммерческих аккаунтов обычно это 10000-50000 запросов в день. Точные лимиты можно уточнить в документации или технической поддержке.

Вопрос: Можно ли передавать данные в конкретную воронку?

Ответ: Да, используйте поле CATEGORY_ID для указания конкретной воронки лидов.

Вопрос: Как избежать дублирования лидов?

Ответ: Используйте метод crm.duplicate.findbycomm для проверки существующих лидов по email или телефону перед созданием нового.

Вопрос: Что делать если webhook перестал работать?

Ответ: Проверьте статус webhook в настройках Битрикс24, убедитесь, что он не был удален или отключен. При необходимости создайте новый webhook.

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

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

Сообщение Интеграция сайта с Битрикс24 API в 2026: инструкция по настройке передачи заявок появились сначала на Битрикс24.

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

Что такое REST API Битрикс24 Облако

REST API (Representational State Transfer Application Programming Interface) Битрикс24 Облако — это набор HTTP-методов, которые позволяют внешним приложениям взаимодействовать с данными вашего портала. Через API можно:

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

Основные отличия API облачной версии от коробочной

Облачная версия Битрикс24 имеет несколько ключевых особенностей при работе с API:

Ограничения по количеству запросов

В облачной версии действуют лимиты на количество API-запросов:

• Базовый тариф: 100 запросов в минуту
• Стандартный тариф: 300 запросов в минуту
• Профессиональный тариф: 500 запросов в минуту
• Энтерпрайз: 1000 запросов в минуту

Доступность методов

Некоторые методы API доступны только в определенных тарифных планах. Наиболее полный функционал доступен в тарифах «Профессиональный» и выше.

Способы авторизации в REST API

Битрикс24 Облако поддерживает несколько способов авторизации для работы с API:

OAuth 2.0 (рекомендуемый)

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

Процесс авторизации:

1. Регистрация приложения в Битрикс24.Маркете
2. Получение client_id и client_secret
3. Перенаправление пользователя на страницу авторизации
4. Получение authorization_code
5. Обмен кода на access_token

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

Простой способ для интеграции собственных решений. Создается в настройках портала и предоставляет уникальный URL для API-запросов.

Создание веб-хука:

1. Зайдите в «Приложения» → «Разработчикам» → «Другое»
2. Выберите «Входящий веб-хук»
3. Укажите название и выберите пользователя
4. Настройте права доступа
5. Сохраните и получите URL для запросов

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

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

Структура API-запросов

Все запросы к REST API Битрикс24 Облако имеют следующую структуру:

https://[ваш-домен].bitrix24.ru/rest/[method]/[parameters]

Основные HTTP-методы

• GET — получение данных
• POST — создание новых записей
• PUT — обновление существующих данных
• DELETE — удаление записей

Формат ответов

API возвращает данные в формате JSON. Структура ответа:

{
"result": {
// данные ответа
},
"time": {
"start": 1234567890.123,
"finish": 1234567890.456,
"duration": 0.333
}
}

Работа с основными сущностями CRM

Лиды (Leads)

Лиды — это потенциальные клиенты, которые проявили интерес к вашим товарам или услугам.

Основные методы для работы с лидами:

• crm.lead.add — создание лида
• crm.lead.get — получение лида по ID
• crm.lead.list — получение списка лидов
• crm.lead.update — обновление лида
• crm.lead.delete — удаление лида

Пример создания лида:

POST /rest/crm.lead.add
{
"fields": {
"TITLE": "Новый лид из формы",
"NAME": "Иван",
"LAST_NAME": "Петров",
"EMAIL": [{"VALUE": "ivan@example.com", "VALUE_TYPE": "WORK"}],
"PHONE": [{"VALUE": "+7(999)123-45-67", "VALUE_TYPE": "WORK"}],
"SOURCE_ID": "WEB"
}
}

Сделки (Deals)

Сделки представляют коммерческие возможности с определенной стоимостью.

Основные методы:

• crm.deal.add — создание сделки
• crm.deal.get — получение сделки
• crm.deal.list — список сделок
• crm.deal.update — обновление сделки

Контакты (Contacts)

Контакты содержат информацию о людях, с которыми вы работаете.

Основные методы:

• crm.contact.add — создание контакта
• crm.contact.get — получение контакта
• crm.contact.list — список контактов
• crm.contact.update — обновление контакта

Компании (Companies)

Компании представляют организации, с которыми вы ведете бизнес.

Основные методы:

• crm.company.add — создание компании
• crm.company.get — получение компании
• crm.company.list — список компаний
• crm.company.update — обновление компании

Работа с задачами и проектами

Задачи (Tasks)

API для работы с задачами позволяет создавать, изменять и управлять задачами в Битрикс24.

Основные методы:

• tasks.task.add — создание задачи
• tasks.task.get — получение задачи
• tasks.task.list — список задач
• tasks.task.update — обновление задачи

Пример создания задачи:

POST /rest/tasks.task.add
{
"fields": {
"TITLE": "Подготовить презентацию",
"DESCRIPTION": "Создать презентацию для встречи с клиентом",
"RESPONSIBLE_ID": 1,
"DEADLINE": "2026-01-15T18:00:00+03:00",
"PRIORITY": "2"
}
}

Пакетные запросы (Batch)

Для оптимизации работы с API и соблюдения лимитов используйте пакетные запросы. Они позволяют выполнить несколько операций за один запрос.

Пример пакетного запроса:

POST /rest/batch
{
"cmd": {
"lead1": "crm.lead.add?fields[TITLE]=Лид 1&fields[NAME]=Иван",
"lead2": "crm.lead.add?fields[TITLE]=Лид 2&fields[NAME]=Петр",
"deals": "crm.deal.list?select[]=ID&select[]=TITLE"
}
}

Обработка ошибок

При работе с API важно правильно обрабатывать ошибки. Битрикс24 возвращает ошибки в следующем формате:

{
"error": "ERROR_CODE",
"error_description": "Описание ошибки"
}

Основные коды ошибок

• INVALID_REQUEST — неверный запрос
• INVALID_CREDENTIALS — неверные учетные данные
• INSUFFICIENT_SCOPE — недостаточно прав
• QUOTA_EXCEEDED — превышен лимит запросов
• NOT_FOUND — запрашиваемый ресурс не найден

Лучшие практики работы с API

Соблюдение лимитов

Всегда учитывайте ограничения по количеству запросов в минуту. Используйте пакетные запросы для обработки больших объемов данных.

Кеширование данных

Не запрашивайте одни и те же данные повторно. Используйте локальное кеширование для часто используемой информации.

Обработка ошибок сети

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

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

Проверяйте данные перед отправкой запросов. Это поможет избежать ошибок и повысить производительность.

Примеры интеграций

Интеграция с формой на сайте

Один из самых популярных сценариев — автоматическое создание лидов из форм обратной связи на сайте.

// PHP пример
$webhook_url = 'https://your-domain.bitrix24.ru/rest/1/webhook_code/crm.lead.add';
$data = [
'fields' => [
'TITLE' => 'Лид с сайта',
'NAME' => $_POST['name'],
'EMAIL' => [['VALUE' => $_POST['email'], 'VALUE_TYPE' => 'WORK']],
'PHONE' => [['VALUE' => $_POST['phone'], 'VALUE_TYPE' => 'WORK']],
'SOURCE_ID' => 'WEB',
'COMMENTS' => $_POST['message']
]
];
$response = file_get_contents($webhook_url, false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => 'Content-Type: application/json',
'content' => json_encode($data)
]
]));

Синхронизация с внешней системой

Регулярная синхронизация данных между Битрикс24 и внешними системами учета или складскими программами.

Автоматизация отчетности

Создание автоматических отчетов и их отправка по email или в мессенджеры.

Мониторинг и логирование

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

• Записывайте все API-запросы и ответы
• Отслеживайте количество запросов и соблюдение лимитов
• Настройте уведомления о критических ошибках
• Регулярно проверяйте работоспособность интеграций

Документация и ресурсы

Для изучения REST API Битрикс24 Облако рекомендуем следующие ресурсы:

• Официальная документация: dev.1c-bitrix.ru
• Примеры кода: github.com/bitrix-tools
• Форум разработчиков: dev.1c-bitrix.ru/community
• Обучающие материалы: academy.1c-bitrix.ru

Безопасность при работе с API

Обеспечение безопасности при работе с API критически важно:

Защита учетных данных

• Никогда не храните токены доступа в коде
• Используйте переменные окружения для конфиденциальных данных
• Регулярно обновляйте токены доступа

HTTPS-подключения

Всегда используйте HTTPS для API-запросов. Битрикс24 Облако требует безопасные подключения.

Валидация входящих данных

При обработке веб-хуков всегда проверяйте подлинность запросов и валидируйте входящие данные.

Заключение

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

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

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

Сообщение REST API Битрикс24 Облако в 2026: инструкция по интеграции и настройке появились сначала на Битрикс24.