Разработка и автоматизация бизнеса в Казахстане
Битрикс24

Битрикс24 обновил REST API 3.0: новые возможности интеграции CRM с сайтами, 1С и внешними сервисами

**Ваш сайт, интернет-магазин и 1С до сих пор работают отдельно от CRM? Битрикс24 расширил REST API 3.0 — новые возможности для интеграций уже документированы!** Теперь разработчикам доступен обновлённый интерфейс работы со сделками, контактами, воронками, стадиями, реквизитами и смарт-процессами. Разбираем, что изменилось в ноябре 2026 года, чем REST 3.0 отличается от предыдущего API, как создавать сделки через PHP и какие процессы можно автомат…

REST API 3.0 Битрикс24

Битрикс24 обновил REST API 3.0: новые возможности интеграции CRM с сайтами, 1С и внешними сервисами

17 ноября 2026 года | Битрикс24 | AT Line Security

Представьте: клиент оформляет заказ на вашем сайте, менеджер сразу видит сделку в Битрикс24, бухгалтерия получает необходимые данные в 1С, а сотрудник склада узнаёт о новом заказе без единого телефонного звонка.

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

Именно для таких задач компании используют интеграции через REST API.

5 ноября 2026 года Битрикс24 объявил о расширении REST API 3.0 — нового программного интерфейса для взаимодействия с CRM и другими инструментами платформы.

Разработчикам стали доступны обновлённые методы для работы со сделками, контактами, воронками продаж, стадиями, реквизитами, товарными позициями и смарт-процессами.

Но главное изменение заключается не только в количестве методов.

REST 3.0 делает взаимодействие с Битрикс24 более единообразным, расширяет возможности обработки связанных данных и предлагает механизмы, которые помогают создавать надёжные интеграции.

Разбираемся, что изменилось, как работает обновлённый API и какую пользу это принесёт компаниям Казахстана.

Что такое REST API Битрикс24?

REST API — это программный интерфейс, позволяющий одной системе обмениваться данными с другой.

Например, у компании есть интернет-магазин на собственном движке PHP.

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

Чтобы менеджеру не пришлось вручную переносить заказ в CRM, можно разработать интеграцию.

Сервер сайта обращается к API Битрикс24 и передаёт нужную информацию.

CRM создаёт сделку, связывает её с клиентом и сохраняет необходимые поля.

Такой же механизм можно использовать для получения информации обратно из Битрикс24.

Принцип работы: сайт или внешняя программа отправляет запрос → Битрикс24 выполняет разрешённую операцию → возвращает результат.

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

Что изменилось 5 ноября 2026 года?

ATLine Bitrix24 REST3 AdditionalСогласно официальной документации, в REST 3.0 добавлены новые группы методов CRM.

Они охватывают:

  • Сделки, лиды, контакты и компании.

  • Предложения, счета и смарт-процессы.

  • Поля CRM, включая пользовательские.

  • Воронки продаж и стадии.

  • Товарные позиции.

  • Реквизиты компаний и контактов.

  • Адреса.

  • Дела CRM.

  • Виды карточек.

  • Справочники.

Обновление продолжает переход Битрикс24 к более последовательной архитектуре API.

Отдельно ещё 22 октября 2026 года разработчики добавили методы REST 3.0 для CRM-форм и ряда сущностей торгового каталога.

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

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

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

1. Новый принцип обращения к REST API 3.0

В предыдущей версии разработчики использовали адрес вызова вида:

https://portal.bitrix24.kz/rest/USER_ID/WEBHOOK/crm.deal.add

В новой версии перед идентификатором пользователя добавляется сегмент /api/:

https://portal.bitrix24.kz/rest/api/USER_ID/WEBHOOK/crm.deal.add

Здесь portal.bitrix24.kz — условный адрес, который необходимо заменить реальным доменом вашего портала.

Изменился и формат передаваемых данных.

Пример создания сделки в предыдущем REST API

{
  "FIELDS": {
    "TITLE": "Заявка с сайта",
    "ASSIGNED_BY_ID": 1
  }
}

Аналогичный запрос в REST 3.0

{
  "fields": {
    "title": "Заявка с сайта",
    "assignedById": 1
  }
}

Обратите внимание: названия стандартных полей теперь используются в формате camelCase.

Например:

TITLE → title

STAGE_ID → stageId

ASSIGNED_BY_ID → assignedById

При этом пользовательские поля сохраняют собственные имена вида UF_CRM_....

Это важно для разработчиков: при переходе на REST 3.0 недостаточно просто изменить URL. Необходимо проверить параметры запроса и формат ответа.

2. Создание сделок через REST 3.0

Создание сделок — один из наиболее востребованных сценариев интеграции.

Например, клиент оставляет заявку на сайте компании.

Сервер получает данные, проверяет их и отправляет запрос к Битрикс24.

Для создания сделки в REST 3.0 используется документированный метод:

crm.deal.add

Название метода осталось таким же, как в предыдущей версии, однако изменились правила передачи полей.

Технический пример на PHP

Ниже показан упрощённый серверный пример создания сделки.

<?php

// Адрес вебхука REST 3.0.
// Храните настоящий токен вне публичного каталога сайта.
$webhook = getenv('BITRIX24_REST_V3_URL');

if (!$webhook) {
    throw new RuntimeException('Не настроен URL Битрикс24');
}

// Данные новой сделки.
$data = [
    'fields' => [
        'title' => 'Новая заявка с сайта AT Line',
        'categoryId' => 0,
        'opportunity' => 100000,
        'currencyId' => 'KZT'
    ]
];

// Выполняем запрос к Битрикс24.
$ch = curl_init(
    rtrim($webhook, '/') . '/crm.deal.add'
);

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Accept: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode(
        $data,
        JSON_UNESCAPED_UNICODE
    ),
    CURLOPT_TIMEOUT => 15
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

curl_close($ch);

$result = json_decode($response, true);

// Проверяем, что сделка создана.
if ($status !== 200 || isset($result['error'])) {
    throw new RuntimeException('Ошибка создания сделки');
}

// Получаем идентификатор сделки.
$dealId = $result['result']['id'] ?? null;

В переменной окружения BITRIX24_REST_V3_URL должен находиться базовый URL вебхука, заканчивающийся на идентификатор пользователя и токен.

Результат успешного создания сделки содержит идентификатор:

{
  "result": {
    "id": 9023
  }
}

В отличие от предыдущего API, где идентификатор мог возвращаться непосредственно в result, новая версия использует объект.

Важно: пример показывает работу с методом API, а не готовый обработчик публичной формы. В рабочем проекте дополнительно нужны серверная проверка данных, защита от спама и повторной отправки, журналирование и безопасное хранение секретов.

Кроме того, создание сделки само по себе не означает автоматического создания связанного контакта. Эту логику необходимо реализовать отдельно.

3. Воронки и стадии теперь доступны через новые методы

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

Например, организация может иметь отдельные процессы для:

  • Продажи товаров.

  • Оказания услуг.

  • Обработки обращений.

  • Гарантийного обслуживания.

  • Выполнения сервисных заявок.

В REST 3.0 для получения списка воронок сделок предусмотрен метод:

crm.deal.category.list

Для получения стадий определённой воронки:

crm.deal.category.stage.list

Это позволяет интеграционному приложению получать актуальную структуру CRM, а не полагаться исключительно на заранее записанные идентификаторы стадий.

Почему это полезно?

Представьте, что руководитель изменил структуру воронки.

В старой интеграции разработчик мог вручную прописать идентификаторы стадий.

Если стадия была удалена или изменена, интеграция начинала работать неправильно.

При корректной архитектуре приложение может получать сведения о доступных стадиях и проверять существование нужных значений.

Это делает систему удобнее для сопровождения.

4. Новые возможности для смарт-процессов

Смарт-процессы позволяют организовывать в Битрикс24 собственные типы бизнес-объектов.

Например:

Заявки на ремонт.

Заявки на закупку.

Обращения граждан.

Сервисные задания.

Внутренние согласования.

В REST 3.0 для них применяется единый принцип именования методов.

Если идентификатор типа смарт-процесса равен 1038, создание элемента выполняется методом:

crm.smartprocess1038.add

Получение списка элементов:

crm.smartprocess1038.list

Идентификатор типа можно получить через метод crm.type.list.

Это отличается от прежнего универсального подхода, в котором тип передавался отдельно через entityTypeId.

Для компаний с большим количеством индивидуальных CRM-объектов единая схема методов упрощает проектирование интеграций.

5. Получение данных CRM с явным указанием полей

Ещё одно важное изменение — работа с параметром select.

В REST 3.0 методы получения одного элемента и списков не возвращают все данные автоматически.

Если не указать select, результат содержит только идентификаторы.

Например, чтобы получить список сделок с основными данными, можно использовать запрос:

{
  "select": [
    "id",
    "title",
    "stageId",
    "opportunity"
  ]
}

Метод:

crm.deal.list

Такой подход позволяет запрашивать только те сведения, которые действительно необходимы приложению.

Он особенно полезен при разработке отчётов и интеграций, работающих с большим количеством записей.

REST 3.0 также предусматривает механизмы получения связанных данных и инструменты фильтрации и постраничной навигации.

При этом разработчику нужно учитывать права доступа пользователя, от имени которого выполняется запрос.

6. Защита от дублирования при повторных запросах

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

Например, сайт отправил заявку в CRM, но из-за сетевой задержки не получил ответ.

Сервер повторяет запрос.

Если первая операция уже была выполнена, в CRM может появиться вторая одинаковая сделка.

REST 3.0 предоставляет механизм Idempotency-Key, предназначенный для безопасного повторения поддерживаемых операций.

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

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

Важно: такая защита не заменяет проверку дублей клиентов, идентификаторов заказов и собственную логику синхронизации.

7. Интеграция Битрикс24 с сайтом: практический сценарий

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

Посетитель заполняет форму обратной связи.

Он указывает имя, телефон и описание задачи.

Далее возможна следующая последовательность:

1. Сайт принимает форму и проверяет данные.

2. Сервер сохраняет внутренний идентификатор обращения.

3. Интеграционный модуль проверяет наличие существующего клиента или связанной заявки.

4. При необходимости создаёт контакт.

5. Через crm.deal.add создаёт сделку.

6. Контакт связывается со сделкой с помощью предусмотренных API-полей.

7. Данные об успешной передаче записываются в журнал.

8. Менеджер видит обращение в CRM.

Подобный сценарий можно реализовать на собственном PHP-движке, WordPress, Joomla, 1С-Битрикс и других платформах.

Для сайта atline.kz такой подход особенно актуален, поскольку можно использовать собственный дизайн формы и серверную обработку, не ограничиваясь внешним видом встроенной CRM-формы.

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

8. Интеграция Битрикс24 с 1С: что стало удобнее?

Компании Казахстана часто используют Битрикс24 для продаж и клиентских коммуникаций, а 1С — для учёта товаров, финансов и документов.

Без интеграции сотрудники вынуждены переносить данные между системами вручную.

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

Например:

Клиент → Битрикс24 → Заказ → Интеграционный модуль → 1С.

После обработки заказа в учётной системе информация может передаваться обратно в CRM.

Какие данные можно синхронизировать?

В зависимости от конфигурации 1С и разработанного обмена:

  • Контрагентов.

  • Заказы.

  • Номенклатуру.

  • Цены.

  • Остатки.

  • Сведения об оплате.

  • Статусы обработки.

  • Документы и реквизиты.

Но здесь есть принципиальный момент.

REST API 3.0 — это интерфейс Битрикс24, а не универсальный API для всех конфигураций 1С.

Чтобы обмен заработал, необходимо разработать или настроить вторую сторону интеграции.

Например, использовать HTTP-сервисы 1С, предусмотренные механизмы обмена или промежуточный сервер.

Возможность передачи конкретных данных зависит от версии и конфигурации 1С, а также бизнес-правил компании.

9. Подключение телефонии, мессенджеров и внешних API

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

Например, компания получает звонок через виртуальную АТС.

Внешняя телефонная система передаёт данные в промежуточный сервис.

Сервис обращается к CRM и находит нужного клиента, создаёт или обновляет обращение.

Другой пример — Telegram-бот, который собирает информацию о клиенте и передаёт её в Битрикс24.

Также возможна интеграция с собственными мобильными приложениями, системами мониторинга, платёжными шлюзами и сервисными платформами.

Важное уточнение: новые методы CRM не гарантируют доступ ко всем сторонним сервисам.

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

10. REST API 3.0 и предыдущая версия: основные отличия

ВозможностьПредыдущий RESTREST 3.0
Адрес вызова/rest//rest/api/
Имена стандартных полей CRMЧасто верхний регистрcamelCase
Ответ создания сделкиID в resultID в result.id
Работа со смарт-процессамиЧасто через crm.item.*Тип в имени метода
Список полейПрежние методыНовые методы field.*
Защита повторных операцийЗависит от реализацииМеханизм Idempotency-Key
Схема документацииДокументация прежних методовOpenAPI для поддерживаемых методов
Поддержка всех функций CRMШирокая, накопленнаяПока неполная

Нужно ли срочно переписывать существующие интеграции?

Нет.

Официальная документация подтверждает, что старая и новая версии REST API могут работать одновременно.

Поэтому действующую интеграцию можно модернизировать постепенно.

Например, перевести создание и чтение сделок на REST 3.0, сохранив старые методы для операций, которые ещё не поддерживаются новой версией.

Это позволяет избежать неоправданного риска для работающих бизнес-процессов.

11. Какие ограничения REST 3.0 ещё существуют?

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

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

Следовательно, не все интеграции можно полностью перенести на REST 3.0.

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

Также следует учитывать:

  • Права доступа пользователя или приложения.

  • Скоупы авторизации.

  • Лимиты REST API.

  • Тарифные ограничения портала.

  • Требования к JSON-запросам.

  • Правильную обработку ошибок.

  • Защиту токенов и вебхуков.

  • Совместимость облачной или коробочной версии.

12. Безопасность интеграций: о чём нельзя забывать?

Любая интеграция, имеющая доступ к CRM, работает с данными компании и её клиентов.

Поэтому безопасность должна учитываться ещё на этапе проектирования.

Не храните вебхуки в JavaScript браузера. Секретный токен должен оставаться на серверной стороне.

Ограничивайте права. Интеграция должна иметь доступ только к необходимым операциям.

Проверяйте входящие данные. Не доверяйте значениям, полученным из публичных форм.

Не записывайте секреты в открытые журналы. Логи должны быть защищены.

Контролируйте повторные запросы. Для заказов и заявок необходимо предусматривать защиту от дублей.

Проверяйте обмен после обновлений. Изменения API и конфигурации портала могут влиять на поведение интеграции.

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

13. Что обновление REST API 3.0 означает для бизнеса Казахстана?

Для предпринимателя название метода crm.deal.add может не иметь большого значения.

Но результат работы интеграции — вполне конкретный.

Заявки не приходится переносить вручную.

Клиентские данные собираются в одной системе.

Отдел продаж и бухгалтерия могут работать с согласованной информацией.

Мобильные приложения могут взаимодействовать с CRM.

Сотрудники тратят меньше времени на повторяющиеся действия.

Именно в этом заключается основная польза API-интеграций.

Обновление REST 3.0 предоставляет разработчикам дополнительные инструменты для создания подобных решений.

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

AT Line Security — индивидуальные интеграции Битрикс24 в Казахстане

Ваш сайт работает отдельно от CRM? Менеджеры вручную переносят заказы из 1С? Данные из телефонии, мобильных приложений и других систем не связаны между собой?

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

AT Line Security — официальный партнёр Битрикс24 в Казахстане.

Мы занимаемся внедрением Битрикс24, разработкой сайтов, мобильных приложений и кастомных программных решений.

Наши специалисты работают с PHP, JavaScript, Java, MySQL и REST API.

Какие услуги мы предлагаем?

Интеграция сайта с Битрикс24. Передача заявок, создание сделок и контактов, обработка заказов.

Интеграция с 1С. Разработка обмена данными с учётом конфигурации учётной системы.

Настройка CRM. Создание воронок, стадий, пользовательских полей и индивидуальных карточек.

Автоматизация. Разработка роботов, триггеров и бизнес-процессов.

Интеграция телефонии. Подключение поддерживаемых виртуальных АТС и создание собственных обработчиков звонков.

Мобильные приложения. Разработка Android-приложений с доступом к данным CRM.

Собственные API. Создание серверных интерфейсов для взаимодействия нескольких программ.

Доработка коробочного Битрикс24. Разработка модулей, компонентов и пользовательских интерфейсов.

Модернизация существующих интеграций. Проверка совместимости и постепенный переход на новые методы REST API.

Сколько стоит внедрение и интеграция Битрикс24?

Комплексное внедрение Битрикс24 в AT Line Security — от 100 000 ₸.

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

Она зависит от количества систем, сложности обмена, структуры данных, требований к безопасности и объёма разработки.

Ваша компания использует несколько программ, которые не умеют обмениваться данными?

Расскажите нам о своей задаче.

Мы изучим существующие процессы, оценим доступные API и предложим архитектуру интеграции.

AT Line Security — объединяем ваши программы в единую систему автоматизации бизнеса..

Поделиться статьёйWhatsApp ↗Telegram ↗
← Все статьи
Свяжитесь с нами

Обсудим ваш проект

Расскажите, что нужно разработать или автоматизировать. Мы уточним задачу и предложим подходящий вариант реализации.

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