Перейти к основному содержимому

Как настроить шаблоны пуш-уведомлений

Обновлено: 27 марта 2026

Шаблон — это гибкий инструмент для настройки пуш-уведомлений. Он поддерживает динамические данные и учитывает особенности платформ, что позволяет точечно управлять содержимым и поведением пуш-уведомлений. Шаблон настраивается на этапе создания нового мобильного чата.

File IconКак подключить мобильный чат Android File IconКак подключить мобильный чат Huawei File IconКак подключить мобильный чат iOS

Общая информация​

Шаблон предназначен только для добавления дополнительной информации или переопределения свойств в пуш-уведомлениях — удалить информацию из уведомления нельзя.

Заполнение поля Шаблон выполняется в JSON-формате.

к сведению

Объект, в который будет добавлен новый параметр, зависит от платформы — Android, Huawei или iOS.

Пример простого шаблона​

В этом примере в пуш-уведомление будет добавлен параметр additional.

{
    "additional": "test"
}

Динамические параметры​

В шаблон можно подставлять динамические параметры. Для подстановки используется формат ${x}, где x — динамический параметр.

Значения, которые могут быть подставлены:

  • id — уникальный идентификатор сообщения, генерируемый автоматически при создании объекта.
  • externalId — внешний идентификатор сообщения из edna Chat Center API в формате UUID.
  • shortMessage — краткое текстовое содержание сообщения, используется для сообщения в пуш-уведомлении по умолчанию.
  • clientId — идентификатор клиента.

Пример шаблона с динамическим параметром​

В этом примере в пуш-уведомление будет добавлен параметр messageId с внешним идентификатором сообщения из edna Chat Center API в формате UUID.

{
    "messageId": "${externalId}"
}

Шаблоны Android и Huawei​

  • Новые параметры из шаблона добавляются в объект data пуш-уведомления.
  • Параметры body и message из состава объекта data могут быть переопределены.
  • Если значением параметра в шаблоне будет объект, то он будет преобразован в строку — сериализован.

Пример добавления нового параметра​

Например, в шаблоне указан новый параметр additional для добавления в пуш-уведомление.

{
    "additional": "test"
}

В результате параметр additional будет добавлен в объект data пуш-уведомления.

{
    ...
    "token": "push address",
    "data": {
        "message_id": "1234",
        "body": "body",
        "message": "message",
        "original": "threads",
        "additional": "test"
   },
   "android": {
        "priority": "HIGH",
        "ttl": "100s"
   },
    ...
}

Пример сериализации параметра​

Например, в шаблоне указан новый параметр additional для добавления в пуш-уведомление.

{
    "additional": {
        "test": "test"
    }
}

В результате значение параметра additional будет преобразовано в строку.

{
    ...
    "token": "push address",
    "data": {
        "message_id": "1234",
        "body": "body",
        "message": "message",
        "original": "threads",
        "additional": "{\"test\":\"test\"}"
   },
   "android": {
        "priority": "HIGH",
        "ttl": "100s"
   },
    ...
}

Шаблоны iOS​

  • Новые параметры добавляются на том же уровне, что и объект aps.
  • Поддерживаются параметры с типом данных object — значения параметров не сериализуются, в отличии от Android и Huawei.
  • Если новый параметр является объектом и этот объект уже существует в стандартном пуш-уведомлении, то объекты будут объединены, а значения параметров будут переопределены.

Пример добавления нового параметра​

Например, в шаблоне указан новый параметр mutable-content для обновления непрочитанного пуш-уведомления.

{
    "mutable-content": 1
}

В результате параметр mutable-content будет добавлен в пуш-уведомление на уровне aps.

{
    ...
   "aps":{
      "alert":"text",
   },
   "mutable-content": 1,
   "message_id":"123",
   "original":"threads"
   ...
}

Пример объединения объектов в пуш-уведомлении​

Например, в шаблоне указан параметр badge для обновления количества непрочитанных сообщений на иконке приложения.

{
  "aps": {
    "badge": 4
   }
}

В результате объекты будут объединены и параметр badge будет добавлен внутрь объекта aps.

{
    ...
   "aps":{
      "alert":"text",
      "badge":4
   },
   "message_id":"123",
   "original":"threads"
   ...
}