GitHub Actions

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

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

Push за <1 сКлюч в секретеОдин шаг curlОбновлено
Возможности

От запуска 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

Создайте приложение

Добавьте приложение в Pocket Alert и сохраните API-ключ как секрет репозитория POCKETALERT_API_KEY.

2

Настройте шаг

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

3

Подключите и запустите

Передайте repo, sha и 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"}'

В документации по началу работы описаны все поля, которые принимает API сообщений.

FAQ

Ответы на вопросы

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

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

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

Для каждого репозитория или окружения создайте отдельное приложение. 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", чтобы они попадали в историю без вибрации.

Узнавайте, что деплой прошёл успешно, не следя за запуском.

Создайте приложение, возьмите API-ключ и добавьте шаг Pocket Alert в свой workflow.