Разрешение на уведомления SmartPush

Обновлено 16 ноября 2023

Получите разрешение пользователя, чтобы отправлять push-уведомления.

Формат запроса

Отправьте в сессии диалога сообщение с "messageName": "GET_RUNTIME_PERMISSIONS" и "type": ["service_push"].

Пример:

{
    "messageName": "GET_RUNTIME_PERMISSIONS",
    "sessionId": "86024848-c12b-4056-b58b-93c69b412314",
    "messageId": 1,
    "uuid": {
        "userChannel": "B2C",
        "sub": "d2d6da62-6bdd-452b-b5dd-a145090075ba",
        "userId": "123"
    },
    "payload": {
        "server_action": {
            "parameters": {
                "need_actions": {
                    "types": ["service_push"]
                }
            }
        }
    }
}

Формат ответа

Ответ возвращается в формате TAKE_RUNTIME_PERMISSIONS.

Пример:

{
  "messageId": "1605196199186625000",
  "sessionId": "0062530b-5521-42cc-90b0-a9d65dea4e98",
  "messageName": "TAKE_RUNTIME_PERMISSIONS"
  "payload": {
    "permitted_actions": [
      "service_push"
    ],
    "status_code": {
      "code": 1,
      "description": "success"
    }
  },
  "uuid": {
    "userId": "ec8a9097-1508-4bec-8d97-67f2329c03e0",
    "userChannel": "B2C"
  }
}

Информация о разрешении

Если пользователь ранее дал согласие на отправку push-уведомлений, вы будете получать эту информацию в переменной permitted_actions со значением service_push в любом входящем сообщении в ваш смартап.

Пример:

{
  "messageId": "1605196199186625000",
  "sessionId": "0062530b-5521-42cc-90b0-a9d65dea4e98",
  "messageName": "MESSAGE_TO_SKILL"
  "payload": {
    "permitted_actions": [
      "service_push"
    ]
  },
  "uuid": {
    "userId": "ec8a9097-1508-4bec-8d97-67f2329c03e0",
    "userChannel": "B2C"
  }
}

Коды ошибок

Код	Описание
001 SUCCESS	Данные существуют и получено клиентское согласие
101 CLIENT DENIED	Клиент отклонил разрешение
102 FORBIDDEN	Запрещенный вызов от смартапа для GET_RUNTIME_PERMISSIONS