Перейти к содержанию

Настройки PUSH

Технология Push — один из вариантов распространения контента в Интернете, когда информация поступает от сервера к клиенту на основе ряда параметров, установленных клиентом. В основном эта технология используется для организации подписок.

ℹ️ Сертификаты для мобильного приложения: за сертификатами обратитесь в службу поддержки.

ℹ️ Если в компании используются несколько самостоятельных мобильных приложений 1F Mobile, для каждого нужно загрузить свой сертификат.

Для редактирования значений в выбранной строке нажмите кнопку редактирования (карандаш) в начале строки. Внесите необходимые изменения, затем нажмите кнопку сохранения (зелёная галочка), чтобы сохранить изменения, или кнопку отмены (красный крестик), чтобы отменить их.

Чтобы удалить запись, нажмите кнопку удаления (красный крестик) в конце соответствующей строки.

Чтобы добавить новую запись, нажмите кнопку Добавить. В открывшемся окне выберите приложение, нажмите кнопку Выберите файл и выберите файл с сертификатом для выбранного приложения, введите пароль и при необходимости отметьте флажок "Режим дебаг".  Чтобы сохранить введенные значения, нажмите кнопку сохранения (зелёная галочка) в начале строки — новая запись появится в общем списке. Чтобы отказаться от ввода, нажмите кнопку отмены (красный крестик).

Поля VOIP Сертификат и VOIP Пароль больше не используются, их можно заполнить произвольными значениями.

ℹ️ Раздел «Приоритеты push-уведомлений» устарел и не используется в текущей версии. Оставлен для справки.

Приоритеты push-уведомлений

Устаревшее, не используется. В новом режиме администрирования все push для Android имеют повышенный приоритет По кнопке Push приоритеты для Android открывается окно с настройкой приоритетов уведомлений для приложений на Android.

Приоритет может быть обычным или повышенным. Если телефон находится в спящем режиме, то уведомления с повышенным приоритетом "будят" его, а с обычным приоритетом — нет.

ℹ️ Согласно документации Android, если владелец телефона систематически не реагирует на пуш-уведомления с высоким приоритетом, такие уведомления со временем начинают блокироваться. Поэтому при поступлении жалоб от пользователей рекомендуется снять повышенные приоритеты у всех или у отдельных типов пуш-уведомлений.

Формирование JSON-контента для push-уведомлений (iOS/Android)

Логика формирования заголовков и текста уведомления

Title (заголовок):

  • Личный чат: имя собеседника (второго участника чата, не получателя сообщения).

  • Группа/задача: текст задачи (обрезается до 500 символов, переводы строк заменяются на пробелы).

Subtitle (подзаголовок):

  • Личный чат: пустая строка.

  • Группа/задача: маршрут комментария в формате "от кого → кому".

Body (основной текст):

  • По умолчанию — текст комментария.

  • Если текст пустой (есть вложения):

  • Несколько файлов: "вложены файлы".

  • Один файл: зависит от типа:

oИзображение — "изображение".

oВидео — "видео".

oАудио — "голосовое сообщение".

oДокумент — "\<название файла>".

Если в персональных настройках пользователя включена опция Скрывать текст чат-сообщения в пуш-уведомлении или Скрывать текст сообщения к задаче в пуш-уведомлении (кроме чатов)

  • title и subtitle — пустые строки.

  • body заменяется на стандартную фразу ("Новое сообщение")

Формат JSON для Android

{

"badge": "333",

"taskId": "12345",

"aId": "dev1dgud",

"userId": "8315",

"commentId": "26401753",

"threadId": "",

"isChat": "true",

"isPinnedToChat": "true",

"unreadCount": "363",

"muted": "false",

"alert": "Иванов Иван: Привет",

"title": "Иванов Иван",

"subtitle": "",

"body": "Привет",

"userName": "Иванов Иван"

}

Ключевые поля:

  • badge — число непрочитанных уведомлений.

  • taskId — ID задачи (если уведомление связано с ней).

  • threadId — ID обсуждения (пусто, если сообщение вне треда).

  • isChat — флаг чата (true/false).

  • alert — полный текст уведомления.

Формат JSON для iOS

{

"aps": {

"badge": 333,

"sound": "hello.m4a",

"alert": "Иванов Иван: Привет",

"thread-id": "12345",

"alert2": {

"title": "Иванов Иван",

"subtitle": "",

"body": "Привет"

}

},

"taskId": 67890,

"aId": "dev1dgud",

"userId": 111,

"commentId": 26401753,

"threadId": null,

"isChat": true,

"isPinnedToChat": true,

"unreadCount": 333,

"userName": "Иванов Иван"

}

Отличия от Android:

Данные внутри aps соответствуют требованиям Apple.

  • thread-id — строковый ключ для группировки уведомлений (например, по taskId). Обеспечивает объединение пушей одной задачи/чата.

  • Числа передаются без кавычек, threadId может быть null.