웹훅

어떤 웹훅이든 휴대폰으로, 즉시.

Pocket Alert은 HTTP 웹훅을 아이폰이나 안드로이드의 푸시 알림으로 바꿔 줘요. Stripe, GitHub, n8n, 또는 직접 운영하는 백엔드를 수신 URL에 연결하면 이벤트가 1초 이내에 휴대폰에 도착해요. 중간 미들웨어도, 이메일 요약도 필요 없어요.

1초 미만에 푸시HTTP POST면 충분Stripe · GitHub · Sentry · n8n 업데이트
기능

휴대폰에 도착하는 웹훅

Pocket Alert은 이미 발생하고 있는 웹훅을 휴대폰의 푸시 알림으로 바꿔 줘요.

순수 HTTP, SDK 불필요

HTTP POST 한 번이면 충분해요. 페이로드가 도착하는 즉시 푸시 알림이 돼요.

어떤 것이든 연결

Stripe, GitHub, Sentry, Zapier, Make, n8n, IFTTT, 직접 운영하는 백엔드까지 모두 웹훅을 사용해요. 여기서 전부 작동해요.

어떤 페이로드든 매핑

메시지 템플릿의 GJSON 플레이스홀더가 중첩된 JSON에서 값을 꺼내서, 푸시에는 중요한 내용만 보여줘요.

중간 미들웨어 생략

원본 서비스에서 URL을 바로 지정하거나, 데이터 형식을 바꿔야 할 때만 자동화 도구를 거치세요.

범위 제한 및 보안

수신 URL은 하나의 웹훅과 애플리케이션에 한정되고, 추측할 수 없는 슬러그를 쓰며, HTTPS로 동작해요.

1초 이내 전달

수신한 웹훅은 1초 이내에 아이폰이나 안드로이드에 도착해요.

시작하기

첫 웹훅 푸시까지 세 단계

1

웹훅 만들기

웹훅 페이지에서 GJSON 메시지 템플릿으로 웹훅을 만드세요.

2

이벤트 POST하기

수신 URL을 복사한 뒤, 어떤 서비스에서든 또는 curl로 JSON 본문을 POST하세요.

3

푸시 알림 받기

휴대폰이 울려요. GJSON 플레이스홀더가 중첩된 페이로드 필드를 푸시 알림에 담아 줘요.

첫 웹훅 보내기

1. 웹훅 만들기

Webhooks 페이지에서 또는 API로 웹훅을 만드세요. 이때 name, application_id, 그리고 들어오는 페이로드에 대해 GJSON 플레이스홀더를 사용하는 message 템플릿을 지정해요:

curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"GitHub Push","message":"Push to %repository.name%: %head_commit.message%","application_id":"qm47b9pzxzxg"}'

2. 수신 URL 복사하기

Pocket Alert은 고유 슬러그가 포함된 수신 URL을 반환해요. 서비스는 여기에 자체 JSON을 POST하면 돼요:

https://p4a.me/wh/1234abcd

3. 서비스에서 이 URL 지정하기

수신 URL을 Stripe 웹훅, GitHub 웹훅, 또는 Make / n8n의 HTTP 단계에 붙여 넣으세요. 웹훅이 실행되면 Pocket Alert이 페이로드에 맞춰 템플릿을 렌더링해요. GJSON 경로로 중첩 필드(%object.field%), 배열 항목(%items.0.name%), 개수(%users.#%), 또는 전체 본문(*)에 접근할 수 있어요. 모든 플레이스홀더는 웹훅 설정 문서에서 확인하세요.

4. 음량 설정하기

발신 서비스의 JSON에 "level" 필드를 넣으면 — silent부터 critical까지 — 푸시가 그 우선순위를 따라요. 그래서 결제 실패는 방해 금지 모드를 뚫고 도착하고, 일상적인 알림은 조용히 머물 수 있어요. 또는 웹훅에 default_level을 한 번 설정해 두고 잊어버려도 돼요.

FAQ

궁금한 점을 답해드려요

Pocket Alert에서 메시지 템플릿과 함께 웹훅을 만들면 https://p4a.me/wh/1234abcd 같은 수신 URL이 발급돼요. HTTP POST를 보낼 수 있는 서비스라면 무엇이든 이 URL을 호출할 수 있어요. Stripe, GitHub, Make, n8n, 직접 운영하는 백엔드 모두 가능해요. 전달된 페이로드는 휴대폰의 푸시 알림으로 표시돼요.

네. 메시지 템플릿에서 %repository.name%이나 %head_commit.message% 같은 GJSON 플레이스홀더를 사용하면 중첩된 JSON에서 값을 꺼낼 수 있어요. 그래서 Stripe 이벤트나 GitHub 페이로드에서 필요한 필드만 정확히 표시할 수 있어요.

HTTP 요청을 보낼 수 있는 서비스라면 모두 연결할 수 있어요. Stripe, GitHub, GitLab, Sentry, Zapier, Make.com, n8n, IFTTT, 직접 만든 스크립트까지 가능해요.

원본 서비스에서 Pocket Alert 웹훅 URL을 바로 지정하면 돼요. 데이터를 먼저 변환해야 한다면 Zapier나 Make를 거쳐 전달할 수도 있어요.

수신 URL마다 하나의 웹훅과 하나의 애플리케이션에 연결되고, 슬러그는 추측할 수 없어요. 트래픽은 HTTPS로 전송되며, 웹훅 페이지에서 언제든지 웹훅을 삭제하고 다시 만들 수 있어요.

네. 서비스가 보내는 JSON에 "level" 필드를 넣으세요. 값은 silent, low, default, high, critical 중 하나예요. 푸시는 그 우선순위를 따라요. critical 웹훅은 안드로이드에서 방해 금지 모드를 뚫고, 아이폰에서는 집중 모드를 통과해요. 웹훅 자체에 default_level을 설정하면 발신 측을 건드리지 않고도 전달되는 모든 알림의 음량을 맞출 수 있어요.

모든 웹훅을 휴대폰으로.

웹훅을 만들고 어디서든 POST 요청을 보내면, 이벤트가 휴대폰에 바로 도착해요.