Show/Hide Toolbars

Руководство администратора

dev_icon Скоро эта страница будет выглядеть по-новому

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

mobile_push_1

Список настроенных уведомлений

warning_icon  Сертификаты для мобильного приложения можно скачать в Руководстве по техподдержке

warning_icon Если в компании используются несколько самостоятельных мобильных приложений "Первая Форма", для каждого нужно загрузить свой сертификат

Для редактирования значений в выбранной строке нажмите иконку !pencil в начале строки. Внесите необходимые изменения, а затем нажмите иконку !green_check в начале строки чтобы сохранить изменения или иконку !RedCross_X чтобы их отменить.

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

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

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

apple_push_add

Добавление и редактирование сертификатов

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

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

По кнопке Push приоритеты для Android открывается окно с настройкой приоритетов уведомлений для приложений на Android.

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

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

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

Формирование 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.