Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Событие при изменении пользовательского поля onCrmContactUserFieldUpdate», проанализируем лучшие практики и покажем, как правильно использовать событие изменении в реальных задачах.
Событие при изменении пользовательского поля onCrmContactUserFieldUpdate
> Scope: crm
>
> Кто может подписаться: любой пользователь
Событие onCrmContactUserFieldUpdate срабатывает при изменении пользовательского поля у контактов.
События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения
Что получает обработчик
Данные передаются в виде POST-запроса {.b24-info}
{
"event": "ONCRMCONTACTUSERFIELDUPDATE",
"event_handler_id": "15",
"data": {
"FIELDS": {
"ID": "554",
"ENTITY_ID": "CRM_CONTACT",
"FIELD_NAME": "UF_CRM_1724771514"
}
},
"ts": "1724775198",
"auth": {
"access_token": "s6p6eclrvim6da22ft9ch94ekreb52lv",
"expires_in": "3600",
"scope": "crm",
"domain": "some-domain.bitrix24.com",
"server_endpoint": "https://oauth.bitrix24.tech/rest/",
"status": "F",
"client_endpoint": "https://some-domain.bitrix24.com/rest/",
"member_id": "a223c6b3710f85df22e9377d6c4f7553",
"refresh_token": "4s386p3q0tr8dy89xvmt96234v3dljg8",
"application_token": "51856fefc120afa4b628cc82d3935cce"
}
}Параметртип | Описание |
|---|---|
eventstring | Символьный код события. В данном случае — |
event_handler_idinteger | Идентификатор обработчика события |
dataobject | Объект, содержащий информацию об измененном пользовательском поле Содержит единственный ключ |
data.FIELDSobject | Объект содержащий информацию о полях измененного пользовательского поля Структура описана ниже |
tstimestamp | Дата и время отправки события из очереди событий |
authobject | Объект, содержащий параметры авторизации и данные о портале, на котором произошло событие. Структура описана ниже |
Параметр FIELDS {#fields}
Параметртип | Описание |
|---|---|
IDinteger | Идентификатор измененного пользовательского поля |
ENTITY_IDuserFieldEntityId | Тип объекта CRM, к которому привязано пользовательское поле. В данном случае — |
FIELD_NAMEstring | Код измененного пользовательского поля |
Параметр auth {#auth}
- [](./index)
- [](./on-crm-contact-user-field-add)
- [](./on-crm-contact-user-field-set-enum-values)
- [](./on-crm-contact-user-field-delete)
💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к событие изменении, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «Событие при изменении пользовательского поля onCrmContactUserFieldUpdate».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru
