Документация для разработчиков
Темная тема

AddByUsers

Описание и сигнатура

CPullStack::AddByUsers(
   $arrayUserId, Array(
      'module_id' => 'im',
      'command' => 'ping',
      'params' => Array(
         'message' => 'test'
   ),
));

Метод отправляет сообщения группе пользователей. Метод статический.

Метод за один раз выбирает все каналы пользователей, и пакетами по N сообщений отправляет за раз. (Количество отправляемых сообщений зависит от настройки модуля Push&Pull ).

Метод может отправлять push-уведомления на мобильные телефоны не отправляя для этого уведомления в мессенджер. Для этого нужно в массив параметров добавить ключ push с параметрами push-уведомления (для примера, таким образом ходят push-уведомления о новых сообщениях в чате).

Параметры

Параметр Описание С версии
UserId Массив получателей сообщения
module_id Модуль который отправляет команду
command Команда которая будет обработана в JS
params Любой набор данных, который будет обработан в JS

Пример

$users = [1,2,3];
\Bitrix\Pull\Push::add($users, Array(
                    'module_id' => 'some',
                    'push' => Array(
                        'message' => $pushText,
                        'expiry' => 0,
                        'send_immediately' => 'Y' // если не нужно чтобы проходил фильтр, надо Y
                    )
                ));

Рекомендуется использовать для решения задачи специальные уведомления. Они смогут дать возможность пользователю управлять что он хочет получать уведомление или push. Пример кода:

if (CModule::IncludeModule('im'))
{
    \CIMNotify::Add([
        "TO_USER_ID" => $USER->GetId(),
        "FROM_USER_ID" => 0, 
        "NOTIFY_TYPE" => IM_NOTIFY_SYSTEM, 
        "NOTIFY_MODULE" => "intranet", 
        "NOTIFY_EVENT" => "security_otp",
        "NOTIFY_MESSAGE" => "Совершена попытка входа в Ваш аккаунт через Мобильное устройство iPhone с IP 95.55.202.217 (Россия).[br][br]Код подтверждения входа: [b]722665[/b].[br][br] Используйте этот код для входа в ваш Битрикс24. Никому не передавайте его и не вводите на других сайтах![br][br]Если Вы не запрашивали код, срочно смените пароль в настройках.",
        "PUSH_MESSAGE" => "Код подтверждения входа: 722665. Если Вы не запрашивали код, срочно смените пароль в настройках.",
   "PUSH_IMPORTANT" => "N",
    ]);
}


Пользовательские комментарии

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх