# 푸시 알림 으로 바로 행동하세요.

> Pocket Alert로 푸시 알림에 액션 버튼을 추가해 보세요. 잠금 화면에서 바로 URL 열기, HTTP 요청 실행, 텍스트 복사까지 할 수 있어요. 배포와 AI 에이전트를 위한 원탭 승인 워크플로를 만들 수 있어요.

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

마지막 업데이트: 2026-10-25

푸시 알림에 버튼을 최대 세 개까지 붙일 수 있어요. 휴대폰 잠금을 풀거나 노트북을 열지 않고도 링크를 열고, HTTP 요청을 보내고, 값을 복사하세요.

문서: https://info.pocketalert.app/features/action-buttons.html

## 평범한 알림에서 한 번의 탭으로 끝나는 행동까지

1. **타입 고르기** — 버튼이 무엇을 할지 정하세요. URL 열기, 엔드포인트 호출, 값 복사 중에서 고르면 돼요.
2. **메시지에 추가하기** — 메시지에 actions 배열을 추가하고, 항목을 최대 세 개까지 넣으세요. 각 항목에는 type, label, value를 지정해요.
3. **휴대폰에서 한 번 누르기** — 메시지를 보내면 버튼이 알림과 앱 안의 메시지에 나타나요.

## 버튼 세 종류, 배열 하나

그냥 무슨 일이 일어났는지만 알려 주는 알림은 다른 곳에서 따로 처리해야 해요. 버튼은 그 간극을 메워 줘요.

- **원하는 곳으로 바로 이동** — view 버튼은 실패한 빌드, 주문, 대시보드 같은 URL을 바로 열어요. 탭을 찾아다닐 필요가 없어요.
- **백그라운드에서 요청 실행** — http 버튼은 지정한 메서드, 헤더, 본문으로 요청을 보내요. 한 번 누르면 서비스를 재시작하거나 장애를 확인 처리할 수 있어요.
- **번거롭지 않은 복사** — copy 버튼은 값을 클립보드에 넣어요. 일회용 인증 코드, 장애 ID, 토큰을 휴대폰에서 텍스트를 드래그하지 않고 복사할 수 있어요.
- **승인 워크플로** — 승인과 거절 라벨을 단 http 버튼 두 개면, 사람의 결정을 기다리는 모든 작업을 한 번의 탭으로 처리하는 제어판이 돼요.
- **배너가 사라져도 남아 있어요** — 버튼은 배너뿐 아니라 메시지 안에도 있어요. 알림을 밀어서 지워도 나중에 다시 사용할 수 있어요.
- **웹훅에서 만드는 버튼** — 웹훅 템플릿이 들어오는 페이로드로 버튼 URL을 채워요. 그래서 모든 알림이 해당 이슈, 주문, 빌드로 바로 연결돼요.

## 액션 버튼 작동 방식

    
푸시 알림 API, 웹훅, MCP 서버로 보내는 메시지에 `actions` 배열을 추가하세요. 각 항목에는 `type`, `label`, `value`가 있으며, `value`의 의미는 타입에 따라 달라요. `view`는 URL, `http`는 JSON 요청 설명, `copy`는 그대로 복사할 텍스트예요.

    
버튼은 푸시와 함께 전달되고 운영체제가 표시해요. 버튼을 누르면 앱이 로컬에서 처리해요. `http`와 `copy`는 아무 화면도 열지 않고 실행되고, `view`는 브라우저를 앞으로 가져와요.

    
## 승인 패턴

    
가장 먼저 만들어 볼 만한 구성은 Approve와 Decline 두 개의 `http` 버튼으로, 각각 직접 운영하는 두 엔드포인트를 가리키게 하는 거예요. 사람의 확인을 기다리며 멈추는 작업에 잘 맞아요. 예를 들어 수동 승인을 기다리는 배포 파이프라인, 기준 금액을 넘는 환불, 운영 환경을 감독 없이 건드리면 안 되는 AI 에이전트가 있어요.

    
요청이 휴대폰에서 엔드포인트로 직접 가기 때문에, 그 URL 뒤에 무엇을 두든 전적으로 여러분의 몫이에요. 인증도 마찬가지예요.

    
## 알아두면 좋은 제한 사항

    
버튼은 최대 세 개예요. `view`와 `http`는 유효한 http(s) URL이어야 하며, 그 외의 값은 `400`을 반환해요. 버튼은 앱이 열려 있든, 백그라운드에 있든, 종료되어 있든 시스템 알림에서 작동해요. 단, Pocket Alert 2.0.1 이상에서만 가능하고, 이전 앱 버전에서는 메시지 안에서만 보여요.

## 자주 묻는 질문

### 알림 하나에 버튼을 몇 개까지 넣을 수 있나요?

메시지당 최대 세 개예요. 보낸 순서대로 iOS와 안드로이드 모두에 표시되며, 배너를 닫은 뒤에도 메시지 안에서 계속 사용할 수 있어요.

### 버튼으로 무엇을 할 수 있나요?

세 가지 타입이 있어요. `view`는 URL을 열고, `http`는 직접 지정한 메서드, 헤더, 본문으로 백그라운드에서 HTTP 요청을 보내며, `copy`는 값을 클립보드에 복사해요. 앱을 전면에 띄우는 것은 `view`뿐이에요.

### HTTP 버튼은 요청을 어디로 보내나요?

휴대폰에서 엔드포인트로 바로 전송돼요. Pocket Alert가 요청을 중계하지 않으며 응답 본문도 보지 않아요. 엔드포인트가 요구하는 인증 헤더를 추가하면 버튼과 함께 전송돼요.

### iPhone에서도 버튼 라벨이 표시되나요?

네. iPhone과 안드로이드 모두 보낸 라벨을 그대로 알림과 메시지 안에 표시해요. iOS가 제시간에 커스텀 버튼을 준비하지 못하면 타입별 기본 라벨(Open, Run, Copy)로 대체되지만, 버튼은 그대로 작동해요.

### 웹훅으로 버튼을 자동 추가할 수 있나요?

네. 웹훅에는 들어오는 페이로드에서 값을 채우는 `%path%` 플레이스홀더가 있는 액션 템플릿을 넣을 수 있어요. 예를 들어 Sentry 알림이 도착하면 해당 이슈를 가리키는 Open issue 버튼이 함께 와요. 치환되는 값은 JSON 이스케이프 처리되므로 페이로드로 URL을 바꿀 수 없어요.

### 버튼을 두 번 누르면 어떻게 되나요?

버튼을 두 번 누르면 요청도 두 번 전송돼요. 중복 요청은 의도적으로 차단하지 않아요. 두 번 실행되면 문제가 되는 경우라면 엔드포인트를 멱등하게 만들어 주세요. 액션 버튼은 유료 기능이에요. 무료 플랜에서는 서버에서 버튼이 제거되고 버튼 없이 메시지가 전달돼요.
