При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Событие при добавлении пользователя onUserAdd», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.
Событие при добавлении пользователя onUserAdd
> Scope: базовый
>
> Кто может подписаться: любой пользователь
Событие onUserAdd вызывается при добавлении пользователя в Битрикс24. Событие срабатывает не после приглашения, а после того, как пользователь зайдет на портал и зарегистрируется до конца.
События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения
Что получает обработчик
Данные передаются в виде POST-запроса {.b24-info}
{
"event": "ONUSERADD",
"data": {
"ID": 123,
"ACTIVE": "Y",
"EMAIL": "user@example.ru",
"NAME": "Иван",
"LAST_NAME": "Иванов",
"PERSONAL_GENDER": "M",
"PERSONAL_BIRTHDAY": "1990-01-01",
"UF_DEPARTMENT": [1, 2],
"DATE_REGISTER": "2024-04-05T10:00:00+03:00",
"WORK_POSITION": "Разработчик",
"UF_EMPLOYMENT_DATE": "2024-04-05"
},
"ts": "1466439714",
"auth": {
"domain": "some-domain.bitrix24.ru",
"server_endpoint": "https://oauth.bitrix24.tech/rest/",
"client_endpoint": "https://some-domain.bitrix24.ru/rest/",
"member_id": "a223c6b3710f85df22e9377d6c4f7553"
}
}Параметры запроса
Названиетип | Описание |
|---|---|
eventstring | Символьный код события — ONUSERADD |
dataarray | Данные добавленного пользователя. Структура описана ниже |
tstimestamp | Дата и время отправки события |
autharray | Данные авторизации и портала. Структура описана ниже |
Параметр data {#data}
Названиетип | Описание | |
|---|---|---|
IDinteger | Идентификатор пользователя | |
ACTIVEstring | Флаг активности. Возможные значения: | |
EMAILstring | Email пользователя | |
NAMEstring | Имя пользователя | |
LAST_NAMEstring | Фамилия пользователя | |
PERSONAL_GENDERstring | Пол: M — мужской, F — женский | |
PERSONAL_BIRTHDAYstring | Дата рождения в формате YYYY-MM-DD | |
UF_DEPARTMENTarray\ | null | Массив ID подразделений. Может отсутствовать для пользователей Экстранет |
DATE_REGISTERstring | Дата регистрации в формате ISO 8601 | |
WORK_POSITIONstring | Должность пользователя | |
UF_EMPLOYMENT_DATEstring | Дата приема на работу в формате YYYY-MM-DD |
Некоторые поля могут отсутствовать или иметь значение null, если у приложения нет доступа к ним.
Параметр auth {#auth}
Названиетип | Описание |
|---|---|
access_tokenstring | Токен для обращения к API |
expires_ininteger | Время в секундах до истечения срока действия токена |
scopestring | Скоуп, в рамках которого произошло событие |
domainstring | Адрес Битрикс24, на котором произошло событие |
server_endpointstring | Адрес сервера авторизации Битрикс24, необходимый для обновления токенов OAuth 2.0 |
statusstring | Статус приложения, подписавшегося на это событие: — |
client_endpointstring | Общий путь для вызовов методов API для Битрикс24, на котором произошло событие |
member_idstring | Идентификатор Битрикс24, на котором произошло событие |
refresh_tokenstring | Токен продления авторизации OAuth 2.0 |
application_token*string | Токен для безопасной обработки событий |
- [](../../events/index)
- [](../../events/event-bind)
- [](./on-app-install)
- [](./on-app-payment)
- [](./on-app-method-confirm)
- [](./on-app-uninstall)
💡 Экспертное мнение и рекомендации
Ключевые выводы по теме «Событие при добавлении пользователя onUserAdd»:
Использование современных стандартов D7 при работе с битрикс позволяет писать чистый, масштабируемый и безопасный код. Не забывайте обрабатывать исключения (try/catch) и проверять права доступа текущего пользователя перед выполнением критических операций.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru