# Push-уведомления на которые можно ответить.

> Добавляйте кнопки действий в push-уведомления с Pocket Alert. Открывайте URL, отправляйте HTTP-запрос или копируйте текст прямо с экрана блокировки. Стройте согласование в одно касание для деплоев и AI-агентов.

<!-- source: https://pocketalert.app/ru/features/action-buttons -->

Обновлено: 2026-10-25

Прикрепите до трёх кнопок к любому push-уведомлению. Откройте ссылку, отправьте HTTP-запрос или скопируйте значение — без разблокировки телефона и без открытия ноутбука.

Документация: https://info.pocketalert.app/features/action-buttons.html

## От простого оповещения до действия в одно касание

1. **Выберите тип** — Решите, что должна делать кнопка: открыть URL, вызвать эндпоинт или скопировать значение.
2. **Добавьте его в сообщение** — Добавьте в сообщение массив actions с тремя элементами максимум, каждый с type, label и value.
3. **Нажмите на телефоне** — Отправьте сообщение. Кнопки появятся в уведомлении и внутри сообщения в приложении.

## Три типа кнопок, один массив

Уведомление, которое только сообщает о событии, заставляет вас искать действие где-то в другом месте. Кнопки закрывают этот разрыв.

- **Сразу к нужному месту** — Кнопка view открывает URL — упавшую сборку, заказ, панель — без поиска нужной вкладки.
- **Запрос в фоне** — Кнопка http отправляет запрос с вашими методом, заголовками и телом. Перезапустите сервис или подтвердите инцидент одним нажатием.
- **Копирование без лишних действий** — Кнопка copy помещает значение в буфер обмена. Одноразовые коды, ID инцидентов и токены — без выделения текста на телефоне.
- **Сценарии согласования** — Две HTTP-кнопки «Approve» и «Decline» превращают push-уведомление в пульт управления в одно касание для всего, что ждёт решения человека.
- **Переживают баннер** — Кнопки находятся внутри сообщения, а не только в баннере. Смахните уведомление, и кнопки останутся доступны позже.
- **Кнопки из вебхуков** — Шаблоны вебхуков подставляют URL кнопок из входящих данных, поэтому каждое оповещение ведёт к своей ошибке, заказу или сборке.

## Как работают кнопки действий

    
Добавьте массив `actions` в любое сообщение, которое вы отправляете через API, вебхук или MCP-сервер. Каждый элемент содержит `type`, `label` и `value`, значение которого зависит от типа: URL для `view`, JSON-описание запроса для `http` и текст для `copy`.

    
Кнопки доставляются вместе с push-уведомлением и отрисовываются операционной системой. Когда вы нажимаете на одну из них, приложение обрабатывает нажатие локально: `http` и `copy` выполняются без открытия чего-либо, а `view` переводит на передний план браузер.

    
## Шаблон согласования

    
Первое, что стоит реализовать, — две кнопки `http`, «Approve» и «Decline», которые указывают на два ваших эндпоинта. Подойдёт всё, что ждёт решения человека: конвейер развёртывания, заблокированный до ручного подтверждения, возврат средств сверх порога или ИИ-агент, которому нельзя без присмотра трогать продакшен.

    
Поскольку запрос идёт с телефона напрямую на ваш эндпоинт, всё, что стоит за этими URL, полностью под вашим контролем, включая аутентификацию.

    
## Ограничения, которые стоит знать

    
Не более трёх кнопок. Для `view` и `http` требуется корректный URL http(s), иначе возвращается `400`. Кнопки работают в системном уведомлении независимо от того, открыто приложение, работает в фоне или закрыто, начиная с Pocket Alert 2.0.1; более старые версии приложения показывают их только внутри сообщения.

## Частые вопросы

### Сколько кнопок может быть в push-уведомлении?

До трёх на сообщение. Они отображаются в том порядке, в котором вы их отправили, на iOS и Android, и остаются доступны внутри сообщения даже после того, как баннер закрыт.

### Что может делать кнопка?

Три типа. `view` открывает URL, `http` отправляет HTTP-запрос в фоне с вашими методом, заголовками и телом, а `copy` помещает значение в буфер обмена. Только `view` выводит приложение на передний план.

### Куда HTTP-кнопка отправляет запрос?

Напрямую с вашего телефона на ваш эндпоинт. Pocket Alert не проксирует запрос и никогда не видит тело ответа. Добавьте любой заголовок аутентификации, который ожидает ваш эндпоинт, и он будет передаваться вместе с кнопкой.

### Будут ли подписи кнопок отображаться на iPhone?

Да. На iPhone и Android отображается именно та подпись, которую вы отправили, — и в уведомлении, и внутри сообщения. Если iOS не успевает подготовить пользовательские кнопки, она использует общую подпись для каждого типа (Open, Run или Copy), и кнопка продолжает работать.

### Могут ли вебхуки добавлять кнопки автоматически?

Да. Вебхук может содержать шаблон действий с плейсхолдерами `%path%`, которые заполняются из входящих данных, поэтому оповещение Sentry придёт с кнопкой «Open issue», ведущей именно к этой ошибке. Подставляемые значения экранируются в JSON, поэтому полезная нагрузка не может изменить URL.

### Что будет, если нажать кнопку дважды?

Двойное нажатие отправит запрос дважды — повторы намеренно не блокируются. Если повторный вызов обходится дорого, сделайте эндпоинт идемпотентным. Кнопки действий относятся к платным функциям: на бесплатных тарифах они удаляются на стороне сервера, а сообщение доставляется без них.
