notifications.sendMass ✎ Дополнить на GitHub

Отправляет сообщение с оповещением всем пользователям приложения, чьи профили соответствуют указанным критериям

НазваниеОбязательныйТипОписание
text Да String

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

expires Да String

Дата и время истечения срока действия этого оповещения. Формат: гггг.ММ.дд ЧЧ:мм

Примечание: дата истечения срока действия должна составлять менее 14 дней от текущей даты. Используемый часовой пояс: MSK(UTC+03:00)

status Нет String

Одно из значений:

  • PUBLIC или P - оповещение показывается пользователям приложения (используется как значение по умолчанию, если параметр опущен)
  • ADMINS_ONLY или A - оповещение показывается только разработчикам приложения
gender Нет String

Одно из значений:

  • MALE или M
  • FEMALE или F
age_range Нет String

Диапазон возраста (включительно). Формат: <минимальный возраст="">-<максимальный возраст="">

birthday_range Нет String

Диапазон дней рождения (включительно). Формат: ММ.дд-ММ.дд

country Нет String

Код страны в профиле пользователя.

city Нет String

Код города, возвращаемый в параметре «location.city» метода users.getInfo.

first_access_range Нет String

Диапазон дат первого запуска приложения пользователем (включительно). Формат: гггг.ММ.дд-гггг.ММ.дд

last_access_range Нет String

Диапазон дат последнего запуска приложения пользователем (включительно). Формат: гггг.ММ.дд-гггг.ММ.дд

has_email Нет Boolean

Если параметр задан, ограничивает пользователей следующим образом:

  • true - пользователи, указавшие адрес эл. почты в своем профиле
  • false - пользователи, не указавшие адрес эл. почты в своем профиле
mask Нет Long

Маска размерностью 32 бита. Подается как десятичное число. Нотификация дойдет в том случае, если результат операции побитового AND сравнения с маской пользователя не равно 0. (user.mask & notification.mask > 0)

maskExactMatch Нет Boolean

Использовать строгое совпадение битов в mask и маски пользователя. (user.mask == notification.mask)

mark Нет String

Метка, которая будет передана приложению в параметре custom_args при переходе по нотификации

Авторизация

Сессия запрещена

Необходимые права:

  • VALUABLE_ACCESS

Перед работой с нотификациями рекомендуется ознакомиться с ограничениями

Если указывается несколько критериев фильтрации, они комбинируются с использованием логического AND. Например, если отправлено gender=MALE&age_range=20-25, то оповещение будет показано пользователям, которые соответствуют обоим условиям: пользователям мужского пола в возрасте 20 - 25 лет. Значения начала и конца диапазона являются включительными, поэтому оповещение из предыдущего примера будет показано пользователям мужского пола, возраст которых равен любому из следующих значений: 20, 21, 22, 23, 24, 25. В статусе PUBLIC одновременно могут находится не более 5 массовых оповещений от приложения. При превышении данного лимита наиболее старые рассылки автоматически скрываются. Разрешается выполнять не более 30 рассылок в день.

Текст оповещения может содержать следующие заполнители, которые будут заменены данными пользователя, перед тем как оповещение будет показано. Поддерживаются следующие заполнители:

ЗаполнительОписание
${user.first-name}Имя пользователя. Пример: Ivan
${user.last-name}Фамилия пользователя. Пример: Petrov
${user.full-name}Полное имя пользователя. Пример: Ivan Petrov
${user.age}Возраст пользователя. Пример: 25

Ответ

String

Параметры приложения

Данные о сессии пользователя

Метод

Список параметров

Используем для подписи secret_key = session_secret_key
Используем для подписи secret_key = application_secret_key
Используем для подписи secret_key = MD5(access_token + application_secret_key)
secret_key =
Сортируем и склеиваем параметры запроса и secret_key
Рассчитываем MD5 от полученной строки и получаем параметр sig