# 끝난 워크플로 결과로 휴대폰을 울리세요.

> GitHub Actions 결과를 푸시 알림으로 받아보세요. 워크플로에 Pocket Alert 스텝을 추가하면 빌드 실패나 배포 완료 소식을 1초 안에 휴대폰으로 확인할 수 있어요.

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

마지막 업데이트: 2026-08-11

Pocket Alert는 GitHub Actions 결과를 푸시 알림으로 휴대폰에 보내 드려요. 워크플로에 curl 단계를 하나 추가하면, 빌드, 배포, 릴리스가 끝나는 즉시 결과가 1초 안에 iPhone이나 Android에 도착해요. Actions 탭을 계속 볼 필요가 없어요.

## 휴대폰으로 GitHub Actions 알림을 받는 3단계

1. **애플리케이션 만들기** — Pocket Alert에서 애플리케이션을 추가하고 API 키를 POCKETALERT_API_KEY 저장소 시크릿으로 저장하세요.
2. **알림 단계 연결하기** — 메시지 API를 curl로 호출하는 알림 단계를 추가하고, if: failure()와 if: success()로 결과를 골라 주세요.
3. **정보 매핑 후 배포** — 저장소, sha, 워크플로 정보를 메시지에 넣으세요. 다음 실행부터 휴대폰이 울려요.

## 워크플로 실행에서 잠금 화면까지

워크플로는 이미 작업이 끝난 시점을 알고 있어요. Pocket Alert는 그 순간을 놓칠 수 없는 푸시 알림으로 바꿔 드려요.

- **워크플로의 단계 하나로 충분해요** — 메시지 API에 curl 호출 한 번이면 어떤 워크플로 단계든 푸시 알림이 돼요. 러너를 따로 설정할 필요도, 추가 서비스도 필요 없어요.
- **저장소 시크릿으로 보관하는 키** — ${{ secrets.POCKETALERT_API_KEY }}에서 API 키를 읽으면 로그에 노출되지 않고, 대시보드에서 교체할 수 있어요.
- **원하는 결과만 골라서 알림** — if: failure()와 if: success()를 함께 쓰면 빌드 실패와 배포 성공을 각각 구분된 메시지로 보낼 수 있어요.
- **저장소마다 채널 하나씩** — 애플리케이션마다 고유 ID가 있어서 저장소별, 환경별 실행 결과를 따로 나눠 받을 수 있어요.
- **1초 이내 전달** — 작업이 끝나는 순간 단계가 실행되어 결과가 1초 안에 휴대폰에 도착해요.
- **실행 정보 전체 포함** — github.repository, github.sha, github.workflow 값을 메시지에 넣으면 어떤 실행인지 정확히 알 수 있어요.

## GitHub Actions 알림을 휴대폰으로 받기

### 1. 애플리케이션을 만들고 API 키를 저장하세요

Pocket Alert에서 애플리케이션을 추가하고 API 키를 복사하세요. 설정 → Secrets and variables → Actions에서 `POCKETALERT_API_KEY`라는 이름의 저장소 시크릿으로 저장하세요.

### 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`를 추가하면 해당 앱으로만 푸시가 가요. TID는 대시보드에서 확인하세요:

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

메시지 API가 받는 모든 필드는 [시작하기 문서](https://info.pocketalert.app/getting-started.html)에서 확인할 수 있어요.

## 자주 묻는 질문

### GitHub Actions 알림을 휴대폰으로 받으려면 어떻게 하나요?

Token 헤더에 API 키를 넣고 https://api.pocketalert.app/v1/messages 로 curl을 호출하는 단계를 추가하세요. 작업 맨 끝에 두면 배포가 끝나거나 빌드가 실패할 때 휴대폰으로 바로 알림이 와요.

### API 키는 어떻게 안전하게 보관하나요?

API 키를 저장소 시크릿으로 저장하고 ${{ secrets.POCKETALERT_API_KEY }}로 읽어서 Token 헤더에 넣으세요. 키는 로그에 나타나지 않으며, Pocket Alert 대시보드에서 교체할 수 있어요.

### 실패했을 때만 알림을 받을 수 있나요?

단계 두 개에 각각 if: failure()와 if: success()를 설정하세요. 빌드가 실패하면 한 메시지가, 배포가 성공하면 다른 메시지가 발송되어 필요한 결과만 골라 알림을 받을 수 있어요.

### 저장소별로 알림을 나눌 수 있나요?

저장소나 환경마다 애플리케이션을 따로 만드세요. 프론트엔드, 백엔드, 릴리스 워크플로가 각각 별도 채널로 전달되어 개별적으로 알림을 끌 수 있어요.

### 커밋과 워크플로 정보도 포함할 수 있나요?

메시지 본문에 ${{ github.repository }}, ${{ github.sha }}, ${{ github.workflow }} 같은 실행 정보를 넣으세요. 푸시 알림만 봐도 어떤 실행이 끝났는지 정확히 알 수 있어요.

### 이 단계는 어떤 엔드포인트를 호출하나요?

이 단계는 Token 헤더와 title, message 값을 담은 JSON 본문으로 https://api.pocketalert.app/v1/messages 를 호출해요. 특정 앱으로 보내려면 application_id를 추가하세요.

### 실패한 빌드 알림을 성공 알림보다 크게 줄 수 있나요?

실패 단계의 본문에 "level":"high"를 추가하면 iPhone에서는 집중 모드를 뚫고, Android에서는 눈에 띄게 울려요. "level":"critical"을 쓰면 방해 금지 모드도 무시해요. 배포 성공 알림은 "level":"silent"로 보내면 진동 없이 기록에만 남아요.
