Оповещения всем пользователям приложения

Чтобы отправить оповещение пользователям приложения в Одноклассниках, чьи профили соответствуют заданным критериям, используйте метод API Одноклассников notifications.sendMass.

Подробнее о работе с API Одноклассников — в разделе Вызовы API на стороне сервера.

Ограничения

•
Оповещения получат только пользователи, которые запускали приложение не более 7 дней назад.
•
У пользователя может отображаться только одно оповещение от приложения, поэтому новое оповещение заменит предыдущее, если оно ещё не закрыто.

Параметры запроса

При обращении к API Одноклассников также необходимо передать общие параметры запроса.

Поле	Тип	Описание
`text`	`string`	Обязательное поле. Текст оповещения. Максимум 100 символов. Допускается не более 5 спецсимволов или эмодзи.
`expires`	`string`	Обязательное поле. Дата и время, до которых оповещение активно. Формат: `гггг.ММ.дд ЧЧ:мм`. Значение должно быть не более чем на 14 дней позже текущей даты. Часовой пояс MSK (UTC+03:00).
`status`	`string`	Видимость оповещения. Возможные значения: • `PUBLIC` или `P` — пользователи приложения (используется по умолчанию). • `ADMINS_ONLY` или `A` — разработчики приложения.
`gender`	`string`	Пол получателей по данным профиля. Возможные значения: • `MALE` или `M`. • `FEMALE` или `F`.
`age_range`	`string`	Возрастной диапазон получателей. Формат: `<мин>-<макс>`, например `20-25`.
`birthday_range`	`string`	Диапазон дат рождения получателей. Формат `ММ.дд-ММ.дд`.
`country`	`string`	Код страны в профиле пользователя.
`city`	`string`	Код города в профиле пользователя.
`custom_button_key`	`string`	Ключ кнопки действия в оповещении. По умолчанию `button_launch` (Начать играть).

Параметры ответа

Поле	Тип	Описание
`id`	`string`	Идентификатор рассылки в формате: `t12345678912345000_123_m`.

Пример

Отправить массовое оповещение «Вашему другу нужна помощь» всем пользователям, которые соответствуют критериям: пол мужской, возраст 20–25 лет. Оповещение будет активно до 12:00 5 августа 2026 года. В оповещении отобразится кнопка «Подробнее».

Если запрос выполнен успешно, в результате вернётся идентификатор рассылки в формате t12345678912345000_123_m.

CURL

Bash

curl 'https://api.ok.ru/fb.do' \
  -X POST \
  -F 'application_key=<публичный_ключ>' \
  -F 'method=notifications.sendMass' \
  -F 'text=Вашему другу нужна помощь' \
  -F 'expires=2026.07.30 12:00' \
  -F 'status=PUBLIC' \
  -F 'custom_button_key=button_more' \
  -F 'sig=<подпись_запроса>'

JavaScript (Node.js)

JavaScript

const params = {
    text: 'Вашему другу нужна помощь',
    expires: '2026.08.05 12:00',
    status: 'PUBLIC',
    gender: 'M',
    age_range: '20-25',
    custom_button_key: 'button_more'
};

callAPI('notifications.sendMass', params)
    .then(data => console.log(data));

Пример функции callAPI с формированием подписи запроса описан в разделе Работа с API Одноклассников.

Прекратить рассылку

Чтобы отменить рассылку оповещений, используйте метод notifications.stopSendMass. В поле id передайте идентификатор рассылки, полученный в ответе на запрос notifications.sendMass: