버튼 세 종류, 배열 하나
그냥 무슨 일이 일어났는지만 알려 주는 알림은 다른 곳에서 따로 처리해야 해요. 버튼은 그 간극을 메워 줘요.
원하는 곳으로 바로 이동
view 버튼은 실패한 빌드, 주문, 대시보드 같은 URL을 바로 열어요. 탭을 찾아다닐 필요가 없어요.
백그라운드에서 요청 실행
http 버튼은 지정한 메서드, 헤더, 본문으로 요청을 보내요. 한 번 누르면 서비스를 재시작하거나 장애를 확인 처리할 수 있어요.
번거롭지 않은 복사
copy 버튼은 값을 클립보드에 넣어요. 일회용 인증 코드, 장애 ID, 토큰을 휴대폰에서 텍스트를 드래그하지 않고 복사할 수 있어요.
승인 워크플로
승인과 거절 라벨을 단 http 버튼 두 개면, 사람의 결정을 기다리는 모든 작업을 한 번의 탭으로 처리하는 제어판이 돼요.
배너가 사라져도 남아 있어요
버튼은 배너뿐 아니라 메시지 안에도 있어요. 알림을 밀어서 지워도 나중에 다시 사용할 수 있어요.
웹훅에서 만드는 버튼
웹훅 템플릿이 들어오는 페이로드로 버튼 URL을 채워요. 그래서 모든 알림이 해당 이슈, 주문, 빌드로 바로 연결돼요.
평범한 알림에서 한 번의 탭으로 끝나는 행동까지
타입 고르기
버튼이 무엇을 할지 정하세요. URL 열기, 엔드포인트 호출, 값 복사 중에서 고르면 돼요.
메시지에 추가하기
메시지에 actions 배열을 추가하고, 항목을 최대 세 개까지 넣으세요. 각 항목에는 type, label, value를 지정해요.
휴대폰에서 한 번 누르기
메시지를 보내면 버튼이 알림과 앱 안의 메시지에 나타나요.
액션 버튼 작동 방식
푸시 알림 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뿐이에요.
휴대폰에서 엔드포인트로 바로 전송돼요. Pocket Alert가 요청을 중계하지 않으며 응답 본문도 보지 않아요. 엔드포인트가 요구하는 인증 헤더를 추가하면 버튼과 함께 전송돼요.
네. iPhone과 안드로이드 모두 보낸 라벨을 그대로 알림과 메시지 안에 표시해요. iOS가 제시간에 커스텀 버튼을 준비하지 못하면 타입별 기본 라벨(Open, Run, Copy)로 대체되지만, 버튼은 그대로 작동해요.
네. 웹훅에는 들어오는 페이로드에서 값을 채우는 %path% 플레이스홀더가 있는 액션 템플릿을 넣을 수 있어요. 예를 들어 Sentry 알림이 도착하면 해당 이슈를 가리키는 Open issue 버튼이 함께 와요. 치환되는 값은 JSON 이스케이프 처리되므로 페이로드로 URL을 바꿀 수 없어요.
버튼을 두 번 누르면 요청도 두 번 전송돼요. 중복 요청은 의도적으로 차단하지 않아요. 두 번 실행되면 문제가 되는 경우라면 엔드포인트를 멱등하게 만들어 주세요. 액션 버튼은 유료 기능이에요. 무료 플랜에서는 서버에서 버튼이 제거되고 버튼 없이 메시지가 전달돼요.