# Сделайте так, чтобы завершённый workflow вибрировал ваш телефон.

> Получайте результаты GitHub Actions в виде push-уведомлений. Добавьте шаг Pocket Alert в workflow и узнавайте о упавших сборках и завершённых деплоях на телефоне меньше чем за секунду.

<!-- source: https://pocketalert.app/ru/use-cases/github-actions-alerts -->

Обновлено: 2026-08-11

Pocket Alert отправляет результаты GitHub Actions на ваш телефон в виде push-уведомлений. Добавьте в workflow один шаг curl, и когда сборка, деплой или релиз завершится, результат придёт на iPhone или Android меньше чем за секунду — без необходимости следить за вкладкой Actions.

## Три шага до уведомлений GitHub Actions на телефоне

1. **Создайте приложение** — Добавьте приложение в Pocket Alert и сохраните API-ключ как секрет репозитория POCKETALERT_API_KEY.
2. **Настройте шаг** — Добавьте шаг уведомления, который вызывает API сообщений через curl, и используйте if: failure() и if: success() для выбора исходов.
3. **Подключите и запустите** — Передайте repo, sha и workflow в сообщение. Следующий запуск заставит ваш телефон вибрировать.

## От запуска workflow до экрана блокировки

Ваш workflow и так знает, когда job завершился. Pocket Alert превращает этот момент в push-уведомление, которое невозможно пропустить.

- **Один шаг в workflow** — Один вызов curl к API сообщений превращает любой шаг workflow в push-уведомление. Никакой настройки раннера и никакого дополнительного сервиса.
- **Ключ как секрет репозитория** — Читайте API-ключ из ${{ secrets.POCKETALERT_API_KEY }}, чтобы он не попадал в логи и менялся на панели.
- **Уведомления о нужных исходах** — Комбинируйте if: failure() и if: success(), чтобы отправлять упавшие сборки и успешные деплои как отдельные, чётко подписанные сообщения.
- **Отдельный канал на каждый репозиторий** — У каждого приложения свой ID, поэтому запуски по репозиториям и окружениям остаются в отдельных каналах.
- **Доставка за доли секунды** — Шаг срабатывает в момент завершения job, так что результат попадает на телефон меньше чем за секунду.
- **Полный контекст запуска** — Передавайте github.repository, github.sha и github.workflow в сообщение, чтобы точно знать, какой это был запуск.

## Отправляйте уведомления GitHub Actions на телефон

### 1. Создайте приложение и сохраните API-ключ

Добавьте приложение в Pocket Alert и скопируйте API-ключ. Сохраните его как секрет репозитория с именем `POCKETALERT_API_KEY` в разделе Settings → Secrets and variables → Actions.

### 2. Добавьте шаг уведомления, который вызывает API сообщений

```
- name: Notify on failure
  if: failure()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Build failed","message":"${{ github.workflow }} on ${{ github.ref_name }} (${{ github.sha }})","level":"high"}'

- name: Notify on success
  if: success()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Deploy succeeded","message":"${{ github.repository }}@${{ github.sha }}"}'
```

### 3. Направьте уведомление в конкретное приложение

Добавьте `application_id` в тело запроса, чтобы отправить push-уведомление в одно приложение (TID найдёте на панели):

```
-d '{"title":"Release shipped","message":"${{ github.repository }} ${{ github.ref_name }}","application_id":"qm47b9pzxzxg"}'
```

В [документации по началу работы](https://info.pocketalert.app/getting-started.html) описаны все поля, которые принимает API сообщений.

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

### Как получать уведомления GitHub Actions на телефон?

Добавьте шаг, который выполняет curl к https://api.pocketalert.app/v1/messages с вашим API-ключом в заголовке Token. Поставьте его в конец job, чтобы завершённый деплой или упавшая сборка сразу отправляли push-уведомление на телефон.

### Как сохранить ключ в секрете?

Сохраните API-ключ как секрет репозитория и читайте его через ${{ secrets.POCKETALERT_API_KEY }}, передавая в заголовке Token. Ключ не попадает в логи, а менять его можно на панели Pocket Alert.

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

Используйте if: failure() и if: success() в двух отдельных шагах. Упавшая сборка отправит одно сообщение, успешный деплой — другое, так что можно подключить только нужные исходы.

### Можно ли разделить уведомления по репозиториям?

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

### Можно ли добавить коммит и название workflow?

Добавляйте контекст запуска, например ${{ github.repository }}, ${{ github.sha }} и ${{ github.workflow }}, в текст сообщения, чтобы push-уведомление точно показывало, какой запуск завершился.

### К какому эндпоинту обращается шаг?

Шаг обращается к https://api.pocketalert.app/v1/messages с заголовком Token и JSON-телом с полями title и message. Добавьте application_id, чтобы направить push-уведомление в конкретное приложение.

### Может ли уведомление о сбое быть громче, чем об успехе?

Добавьте "level":"high" в тело шага при сбое, и push-уведомление пробьётся через Фокусирование на iPhone и будет заметно звонить на Android; "level":"critical" идёт дальше и полностью обходит режим Не беспокоить. Уведомления об успешном деплое можно отправлять с "level":"silent", чтобы они попадали в историю без вибрации.
