Событие при изменении настроек повторения регулярной сделки onCrmDealRecurringUpdate

Выберите инструмент для разработки с AI-агентом:

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

Scope: crm

Кто может подписаться: любой пользователь

Событие ONCRMDEALRECURRINGUPDATE сработает в трех случаях:

  • при изменении настроек повторения вручную или методом crm.deal.recurring.update
  • при создании сделки по шаблону, сразу после onCrmDealRecurringExpose
  • когда сделку по расписанию не удалось создать — Битрикс24 отключает повторение, и событие приходит без onCrmDealRecurringExpose

После создания сделки по шаблону Битрикс24 записывает в настройки счетчик повторов и дату последнего запуска. При запуске по расписанию он также пересчитывает дату следующего запуска.

Событие не вызывается при изменении полей самой сделки-шаблона, например названия или суммы. Такие изменения отслеживает событие onCrmDealUpdate.

Списка измененных настроек в событии нет — запросите текущие значения по ID из параметра FIELDS.

События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения

Что получает обработчик

Данные передаются в виде POST-запроса

{
    "event": "ONCRMDEALRECURRINGUPDATE",
    "event_handler_id": "679",
    "data": {
        "FIELDS": {
            "ID": "9",
            "RECURRING_DEAL_ID": "6791"
        }
    },
    "ts": "1741092489",
    "auth": {
        "access_token": "s6p6eclrvim6da22ft9ch94ekreb52lv",
        "expires_in": "3600",
        "scope": "crm",
        "domain": "some-domain.bitrix24.ru",
        "server_endpoint": "https://oauth.bitrix24.tech/rest/",
        "status": "L",
        "client_endpoint": "https://some-domain.bitrix24.ru/rest/",
        "member_id": "a223c6b3710f85df22e9377d6c4f7553",
        "application_token": "51856fefc120afa4b628cc82d3935cce"
    }
}

Параметр
тип

Описание

event
string

Символьный код события.

В данном случае — ONCRMDEALRECURRINGUPDATE

event_handler_id
integer

Идентификатор обработчика события

data
object

Объект, содержащий информацию об измененных настройках повторения.

Содержит единственный ключ FIELDS

data.FIELDS
object

Объект с идентификаторами измененных настроек повторения и сделки-шаблона.

Структура описана ниже

ts
timestamp

Дата и время отправки события из очереди событий

auth
object

Объект, содержащий параметры авторизации и данные о Битрикс24, в котором произошло событие.

Структура описана ниже

Параметр FIELDS

Параметр
тип

Описание

ID
integer

Идентификатор настроек повторения. Передайте его в параметр id метода crm.deal.recurring.get, чтобы получить настройки

RECURRING_DEAL_ID
integer

Идентификатор сделки-шаблона, из которой копируются значения полей. Совпадает с полем DEAL_ID в ответе crm.deal.recurring.get. Поля сделки-шаблона возвращает crm.deal.get

Параметр auth

Обязательные параметры отмечены *

Название
тип

Описание

access_token
string

Токен авторизации OAuth 2.0

expires_in
integer

Время в секундах до истечения срока действия токена

scope*
string

Скоуп, в рамках которого произошло событие

domain*
string

Адрес Битрикс24, на котором произошло событие

server_endpoint*
string

Адрес сервера авторизации Битрикс24, необходимый для обновления токенов OAuth 2.0

status*
string

Статус приложения, подписавшегося на это событие:

client_endpoint*
string

Общий путь для вызовов методов REST API для Битрикс24, на котором произошло событие

member_id*
string

Идентификатор Битрикс24, на котором произошло событие

refresh_token
string

Токен продления авторизации OAuth 2.0

application_token*
string

Токен для безопасной обработки событий

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

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

Продолжите изучение