Создать персональное уведомление
Создает персональное уведомление пользователю
- Параметры
- Расширенный вызов ?
Функция СоздатьПерсональноеУведомление(Знач URL, Знач IDПользователя, Знач Текст, Знач Тег = "", Знач Вложения = "", Знач Токен = "") Экспорт
| Параметр | CLI опция | Тип | Обяз. | Назначение |
|---|---|---|---|---|
| URL | --url | Строка | ✔ | URL внешнего вебхука или адрес Bitrix24 при использовании токена |
| IDПользователя | --user | Строка, Число | ✔ | ID пользователя для отправки уведомления |
| Текст | --text | Строка | ✔ | Текст уведомления |
| Тег | --tag | Строка | ✖ | Тег уникальности Если уже существует, то другие увед. будут удалены |
| Вложения | --blocks | Массив из Структура | ✖ | Массив блоков вложений |
| Токен | --token | Строка | ✖ | Токен авторизации, если используется не вебхук |
Возвращаемое значение
Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrix24
| Параметр | Описание |
|---|---|
| proxy | ИнтернетПрокси или структура полей Протокол, Сервер, Порт, Пользователь, Пароль, ИспользоватьАутентификациюОС |
| timeout | Таймаут выполнения запроса |
| adv_response | Оформляет ответ в виде полной структуры HTTP-ответа с полями code, body и headers |
| retries | Число попыток отправки HTTP-запроса при коде 5** или внутренних ошибках клиента |
| dontwait | Создает фоновое задание и возвращает его данные (только для 1С и OneScript) |
подсказка
Метод в документации API: im.notify.personal.add
Пример использования для 1С:Предприятие/OneScript
IDПользователя = 1;
URL = "https://b24-ar17wx.bitrix24.by/rest/1/av5...";
Текст = "Текст сообщения";
Картинка = "https://raw.githubusercontent.com/Bayselonarrend/OpenIntegrations/main/service/test_data/picture.jpg";
Файл = "https://github.com/Bayselonarrend/OpenIntegrations/raw/main/service/test_data/document.docx";
Вложения = Новый Массив;
Вложения.Добавить(OPI_Bitrix24.ПолучитьБлокКартинки("Картинка1", Картинка));
Вложения.Добавить(OPI_Bitrix24.ПолучитьБлокФайла("Файл1.docx" , Файл));
Результат = OPI_Bitrix24.СоздатьПерсональноеУведомление(URL, IDПользователя, Текст, , Вложения);
URL = "b24-ar17wx.bitrix24.by";
Токен = "a5b00469006e9f06006b12e400000001000...";
Тег = "Новый";
IDПользователя = 10;
Результат = OPI_Bitrix24.СоздатьПерсональноеУведомление(URL, IDПользователя, Текст, Тег, , Токен);
- Bash
- CMD/Bat
oint bitrix24 СоздатьПерсональноеУведомление \
--url "b24-ar17wx.bitrix24.by" \
--user 10 \
--text "Текст сообщения" \
--tag "Новый" \
--token "***"
oint bitrix24 СоздатьПерсональноеУведомление ^
--url "b24-ar17wx.bitrix24.by" ^
--user 10 ^
--text "Текст сообщения" ^
--tag "Новый" ^
--token "***"
Результат
{
"result": 95000,
"time": {
"start": 1779818198,
"finish": 1779818198.88516,
"duration": 0.885164976119995,
"processing": 0,
"date_start": "2026-05-26T17:56:38+00:00",
"date_finish": "2026-05-26T17:56:38+00:00",
"operating_reset_at": 1779818798,
"operating": 0
}
}