cURL로 보내는 푸시 알림.
스크립트가 끝나면 휴대전화가 울립니다.
cURL 호출 한 번으로 iPhone이나 Android 휴대전화에 푸시 알림을 보내세요. 배포, 백업, CI 작업, 오래 걸리는 학습 작업 끝에 붙여 넣기만 하면 어디에 있든 알림이 도착합니다.
앱을 출시할 필요도, Firebase 프로젝트도, APNs 인증서도 필요 없습니다. AgentsRoom에서 받은 편지함을 만들고 엔드포인트와 전송 전용 키를 복사하세요. 모든 알림은 데스크톱과 휴대전화에서 검색할 수 있는 기록으로도 남습니다.
$ curl POST /api/dev-inboxes/…/push
{"title":"배포 완료"}
202 Accepted
배포 완료
api v2.4가 프로덕션에 배포되었습니다
어떤 스크립트에서든 HTTPS 요청 한 번, 휴대전화에 알림 하나, 받은 편지함에 사본 하나.
오래 걸리는 작업은 대부분 조용히 끝납니다. 배포는 20분 전에 끝났고, 야간 백업은 새벽 3시에 실패했고, 마이그레이션은 여전히 당신을 기다리고 있는데, 직접 확인하러 가야만 알게 됩니다. 푸시 알림은 계속 확인하러 가지 않아도 되는 가장 간단한 방법이지만, 보통은 모바일 앱, Firebase 프로젝트, 갱신해야 하는 인증서가 필요합니다.
AgentsRoom은 이미 휴대전화에 있습니다. Push API는 이 앱을 수신기로 바꿔 줍니다. 받은 편지함마다 전용 HTTPS 엔드포인트와 전송 전용 키가 주어지고, cURL을 실행할 수 있는 것이라면 무엇이든 잠금 화면까지 알림을 보낼 수 있습니다. 셸 스크립트, GitHub Actions 단계, cron 작업, 직접 만든 앱의 서버 이벤트까지요.
모든 알림은 서버에도 저장되어, 데스크톱이나 휴대전화에서 검색할 수 있는 받은 편지함에 남습니다. 컴퓨터는 닫혀 있어도 됩니다. 엔드포인트, 받은 편지함, 전송은 모두 AgentsRoom 서버에서 실행됩니다.
알림에 필요한 모든 것, 호스팅은 필요 없음
JSON 본문 하나, 키를 담을 헤더 하나, 그리고 스크립트가 무인으로 돌아갈 때 중요한 몇 가지 보장.
제목, 본문, 링크, 이미지
최대 160자의 제목, 최대 16,000자의 본문, 열 링크, 공개 HTTPS 이미지를 보낼 수 있습니다. 휴대전화에는 짧은 미리보기가 표시되고, 받은 편지함에는 전체 텍스트가 남습니다.
소리 또는 무음
받은 편지함마다 기본 소리가 있고, 요청마다 이를 바꿀 수 있습니다. 백업 실패에는 기기 소리를, 정기 보고서에는 무음을.
스크립트가 재시도해도 중복 없음
Idempotency-Key 헤더를 추가하면 재시도된 요청이 같은 메시지를 반환하므로 휴대전화가 두 번 울리지 않습니다. 사용량에서도 다시 차감되지 않습니다.
폐기할 수 있는 전송 전용 키
스크립트에 넣은 키는 전송만 할 수 있습니다. 받은 편지함을 읽거나 설정을 바꿀 수 없습니다. 유출되면 다시 생성하고, 폐기하면 새 메시지를 즉시 막을 수 있습니다.
컴퓨터가 꺼져 있어도 작동
엔드포인트와 받은 편지함은 서버에서 실행됩니다. 같은 계정으로 AgentsRoom 모바일 앱에 로그인하고 알림을 허용한 뒤 노트북을 닫으세요.
비공개, 또는 원할 때만 공유
받은 편지함은 내 계정이나 하나의 프로젝트에 속합니다. Team 또는 Pro 그룹에서는 알림을 함께 받을 팀원을 선택할 수 있습니다. 팀원은 키를 절대 볼 수 없습니다.
연동은 요청 하나가 전부
받은 편지함 설정에서 복사하세요. 실제 엔드포인트와 키가 이미 채워져 있습니다.
POST /pushcurl -X POST https://agentsroom.dev/api/dev-inboxes/INBOX_ID/push \
-H 'Authorization: Bearer SENDING_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: deploy-2481' \
-d '{"title":"Deploy finished","body":"api v2.4 is live","sound":"default",
"linkUrl":"https://example.com/releases/2481"}'202 응답은 메시지가 받은 편지함에 저장되었다는 뜻입니다. 이후 휴대전화로의 전달은 운영체제, 알림 설정, 푸시 서비스에 따라 달라집니다. Windows에서는 복사 버튼으로 curl.exe를 호출하는 PowerShell 버전을 받을 수 있습니다.
처음부터 첫 알림까지
3단계, 약 2분, 다른 서비스 계정은 필요 없습니다.
푸시를 열고 받은 편지함 만들기
프로젝트에서 프로젝트 도크의 푸시를 클릭하거나 알림 설정에서 여세요. 내 계정이나 현재 프로젝트를 선택하고, ‘새 설치’나 ‘배포 완료’ 같은 템플릿으로 시작하세요.
cURL 명령 복사하기
‘연결 및 설정’에 엔드포인트, 전송 전용 키, 바로 실행할 수 있는 요청이 표시됩니다. 제목과 본문을 수정한 뒤 연동을 저장하면 같은 템플릿을 어느 컴퓨터에서나 쓸 수 있습니다.
스크립트에서 실행하기
배포 스크립트, CI 작업, cron 작업 끝에 명령을 붙여 넣으세요. 다음 실행 때 알림이 전송되고, 메시지는 데스크톱과 모바일의 푸시 탭에 표시됩니다.
개발자가 가장 먼저 연결하는 것
보고 있지 않을 때 끝나는 작업이라면 무엇이든 좋은 후보입니다.
배포 완료 또는 실패
배포 스크립트나 CI 작업 끝에 한 줄을 추가하고, 릴리스나 실패한 로그로 가는 링크를 함께 넣으세요.
새 사용자 또는 새 설치
누군가 가입하거나 앱을 설치하거나 업그레이드할 때 백엔드에서 엔드포인트를 호출하고, 휴대전화로 그 순간을 함께하세요.
백업과 cron 작업
야간 백업이 실패하면 기기 소리를, 성공하면 무음을 사용하세요. 기록을 보면 어느 밤에 문제가 있었는지 알 수 있습니다.
오래 걸리는 빌드, 가져오기, 학습 작업
10분마다 터미널을 확인하지 마세요. 자리를 비웠더라도 작업이 끝나면 알려 줍니다.
스크립트 안에서 쓰도록 설계
키는 URL이 아니라 Authorization 헤더로 전달되므로 프록시 로그에 남지 않습니다. 길이는 192비트이며, 조회를 위해 해시로 저장되고, 받은 편지함 소유자에게만 표시됩니다.
유출된 키는 클릭 한 번으로 차단됩니다. 다시 생성하면 다음 요청부터 이전 키가 거부되고, 폐기하면 받은 편지함이 아무것도 받지 않습니다. 이미 받은 메시지는 계속 읽을 수 있습니다.
도착한 내용은 신뢰할 수 없는 콘텐츠로 취급하세요. 이미지는 메시지를 열 때 공개 호스트에서 불러오고, 링크는 탭할 때만 열립니다.
연결은 에이전트에게 맡기세요
dev_inboxes_listdev_inbox_createdev_inbox_configuredev_inbox_membersdev_inbox_messagesdev_inbox_test“누가 내 앱을 설치하면 휴대전화로 알려 줘”라고 말하면, AI 코딩 에이전트가 AgentsRoom MCP 도구로 받은 편지함을 만들고, 템플릿을 설정하고, 코드에 호출을 추가합니다. CLI와 상관없이 모든 에이전트가 사용할 수 있습니다. Claude Code, Codex, Antigravity 등.
에이전트는 설정을 바꾸거나 받은 편지함을 공유하기 전에 먼저 묻고, 전송 키를 저장소에 커밋하지 않습니다.
AgentsRoom MCP 알아보기월간 푸시 사용량
달력 기준 월 단위로, 모든 받은 편지함을 합산해 계산합니다. 이메일은 별도의 사용량이 있습니다.
게스트
10
매월
무료
100
매월
Plus
200
매월
Pro
무제한
Team 좌석에는 Pro가 포함됩니다. 메시지는 90일 동안 보관되며, 삭제해도 사용한 알림 수는 돌아오지 않습니다.
서비스가 HTTP 요청 대신 이메일을 보내나요? 전용 주소를 만들어 주세요.
개발자 이메일 받은 편지함스크립트가 아니라 AI 에이전트가 턴을 마쳤을 때 알고 싶으신가요? 그건 별도로 기본 제공되는 알림입니다.
에이전트 알림푸시 알림 API: 자주 묻는 질문
cURL로 휴대전화에 푸시 알림을 보내려면 어떻게 하나요?
AgentsRoom에서 푸시 받은 편지함을 만들고, ‘연결 및 설정’에서 엔드포인트와 전송 전용 키를 복사한 뒤, 최소한 제목이 들어간 JSON 본문으로 POST 요청을 보내세요. 알림을 받으려면 같은 계정으로 AgentsRoom 모바일 앱에 로그인하고 알림을 허용하세요.
컴퓨터를 계속 켜 둬야 하나요?
아니요. 엔드포인트, 받은 편지함, 전송은 AgentsRoom 서버에서 실행됩니다. 노트북을 닫아도 알림은 휴대전화에 도착하고, 메시지는 받은 편지함에서 기다립니다.
iPhone과 Android 모두에서 작동하나요?
네. iOS와 Android의 AgentsRoom 모바일 앱에서 내 계정으로 로그인한 모든 기기에 알림이 전송됩니다. 알림을 탭하면 해당 받은 편지함에서 메시지가 열립니다.
알림에는 무엇을 담을 수 있나요?
최대 160자의 제목, 최대 16,000자의 본문, 선택 사항인 공개 HTTPS 이미지, 선택 사항인 HTTPS 링크, 그리고 소리(기기 기본값 또는 무음)입니다. 사용자 지정 사운드 파일은 지원하지 않습니다.
스크립트가 재시도할 때 중복 알림을 막으려면 어떻게 하나요?
배포 번호처럼 이벤트마다 고유한 값을 담은 Idempotency-Key 헤더를 보내세요. 같은 키로 재시도하면 원래 메시지가 반환되며, 두 번째 알림은 보내지지 않고 사용량도 다시 차감되지 않습니다.
전송 키가 유출되면 어떻게 되나요?
키로는 메시지를 보낼 수만 있고 읽을 수는 없습니다. 받은 편지함 설정에서 다시 생성하면 다음 요청부터 이전 키가 거부되고, 폐기하면 새 키를 만들 때까지 새 메시지가 차단됩니다.
알림은 몇 개까지 보낼 수 있나요?
달력 기준 월 단위로 모든 받은 편지함을 합산해 게스트는 10개, 무료 계정은 100개, Plus는 200개, Pro는 무제한입니다. Team 좌석에는 Pro가 포함됩니다. 이메일은 별도의 사용량이 있습니다.
팀원도 같은 알림을 받을 수 있나요?
네, Team 또는 Pro 그룹에서 가능합니다. 소유자가 받은 편지함을 읽고 알림을 받을 팀원을 선택합니다. 팀원은 전송 키를 볼 수 없고 설정도 바꿀 수 없습니다.
관련 기능
개발자 이메일 받은 편지함
프로젝트마다 전용 수신 이메일 주소를 만드세요. 서비스 알림, cron 보고서, 앱 이메일이 개인 메일함이 아닌 AgentsRoom에 도착하고, 데스크톱과 모바일에서 읽을 수 있습니다.
알림
읽지 않음 배지, 데스크톱 알림, Dock 카운트가 어떤 에이전트가 완료했는지 알려줍니다. 모바일 푸시에는 에이전트 아바타가 실려 있어 잠금을 풀기 전에 누구인지 알 수 있습니다.
트리거: 웹훅 모드
시계 대신 웹훅으로 AI 코딩 에이전트를 실행하세요. 공개 URL 하나를 GitHub, GitLab, Slack, Linear, Sentry 또는 JSON을 POST할 수 있는 아무 서비스에나 붙여 넣으면, 이벤트가 도착하는 순간 AgentsRoom이 에이전트를 시작합니다: pull request가 열렸을 때, 빌드가 깨졌을 때, 티켓이 생성됐을 때, 경보가 울렸을 때. 서명 검증, 선택적 페이로드 필터, 폭주 제한, 그리고 페이로드는 프롬프트 변수가 됩니다. 계속 확인하는 에이전트는 한 바퀴 돌 때마다 토큰을 씁니다. 웹훅 트리거는 아무 일도 일어나지 않는 동안 아무 비용도 들지 않습니다.
Mobile Companion
폰에서 프롬프트를 받아쓰고 파일을 첨부하세요. iOS나 Android에서 스크린샷을 공유하고 프로젝트를 선택해 에이전트로 보내거나 해당 프로젝트의 백로그에 저장하세요.
스크립트가 먼저 어깨를 두드리게 하세요
AgentsRoom을 다운로드하고 푸시 받은 편지함을 만들어 2분 만에 첫 알림을 보내세요.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.
버그와 요청을 공개 백로그로 바로 보내세요.