시작하기
Posmit은 카카오 알림톡, SMS, FCM 푸시, 이메일 등 여러 채널의 알림 발송을 하나의 API와 대시보드로 통합하는 알림 발송 플랫폼입니다. 채널마다 여러 공급자(Aligo, SOLAPI, AWS SES 등)를 연결해 우선순위 기반 라우팅과 자동 폴백을 구성할 수 있고, 템플릿 관리 · 발송 큐 · 전송 시도 로그 · 감사 로그까지 발송 운영에 필요한 도구를 한곳에서 제공합니다.
회원가입과 로그인
Posmit 대시보드는 Google 계정 로그인을 지원합니다. 별도의 회원가입 절차는 없으며, 처음 로그인하는 계정은 자동으로 생성됩니다.
- 로그인 페이지에서 Google로 로그인 버튼을 누릅니다. Google 계정 선택 팝업이 열립니다.
- 팝업이 차단된 환경에서는 자동으로 리다이렉트 방식으로 전환되어 로그인이 이어집니다.
- 로그인에 성공하면 소속된 워크스페이스가 있는 경우 대시보드로, 없는 경우 워크스페이스 허브(
/hub)로 이동합니다.
이메일 · 비밀번호 로그인은 현재 제공되지 않습니다. Google 계정으로 로그인해 주세요.
워크스페이스 생성과 선택
Posmit의 모든 리소스(공급자 연결, 라우팅, 템플릿, API 키, 로그)는 워크스페이스 단위로 격리되어 관리됩니다. 대시보드를 사용하려면 반드시 하나의 워크스페이스를 선택해야 합니다.
허브에서 선택하기
워크스페이스 허브(/hub)에는 참여 중인 워크스페이스가 카드 목록으로 표시됩니다.
카드에는 이름, 슬러그, 생성일과 함께 내 역할 배지가 보이며, 카드를 클릭하면 해당 워크스페이스로 전환되어 대시보드로 이동합니다.
대시보드 안에서도 사이드바 상단의 워크스페이스 스위처로 언제든 다른 워크스페이스로 전환할 수 있습니다.
새 워크스페이스 만들기
허브의 새 워크스페이스 만들기 카드(/hub/new)에서 생성합니다.
| 입력 | 필수 | 설명 |
|---|---|---|
| 이름 | 필수 | 최대 120자. 예: “우리 팀 알림” |
| 슬러그 | 선택 | URL에 사용되는 식별자. 소문자 · 숫자 · 하이픈만 허용되며, 비워두면 자동 생성됩니다. |
생성이 완료되면 별도의 선택 단계 없이 새 워크스페이스로 자동 전환되어 대시보드로 진입합니다.
역할별 권한
역할은 워크스페이스 단위로 부여됩니다. 워크스페이스를 직접 만들면 오너(owner)가 됩니다.
| 역할 | 라벨 | 할 수 있는 일 |
|---|---|---|
owner | 오너 | 모든 권한. 워크스페이스 삭제(위험 구역)는 오너만 가능합니다. |
admin | 관리자 | API 키 발급 · 재발급 · 폐기, 워크스페이스 이름 · 슬러그 수정, 요청 제한 · 발송 속도 제한 설정 + 일반 편집 전체 |
operator | 운영자 | 공급자 연결 · 라우팅, 템플릿, 웹훅 등 일반 편집. API 키와 조직 설정 · 제한 정책은 변경할 수 없습니다. |
viewer | 조회자 | 조회 전용. 모든 화면을 볼 수 있지만 어떤 것도 변경할 수 없습니다. |
API 키 관리와 조직 설정(요청 제한, 발송 속도 제한 포함)은 오너 또는 관리자만 가능합니다. 운영자는 채널 · 템플릿 · 웹훅 같은 일반 리소스만 편집할 수 있습니다.
첫 발송까지의 흐름
Posmit에서 알림을 처음 발송하기까지는 세 단계면 충분합니다.
채널 연결
셋업 › 채널 메뉴에서 발송할 채널(SMS, 이메일 등)에 공급자 계정을 연결하고 라우팅 우선순위를 설정합니다. 공급자 상세 화면의 테스트 발송으로 설정이 올바른지 바로 확인할 수 있습니다. 자세한 절차는 채널 연결 문서를 참고하세요.
API 키 발급
거버넌스 › API 키 메뉴에서 발급합니다(오너 · 관리자 전용). 발송에는 notifications:send 스코프가 필요합니다.
발급 직후 Key ID / Key Secret / HMAC Secret 세 값이 단 한 번만 표시됩니다. 페이지를 떠나면 다시 볼 수 없으므로 비밀 저장소(1Password, Vault 등)에 즉시 보관하세요. 분실했다면 키를 재발급(로테이션)해 새 시크릿을 받아야 합니다.
알림 발송
발급받은 키로 알림 발송 API를 호출합니다. 모든 요청은 HMAC 서명이 필요합니다.
curl -X POST https://api.posmit.io/v1/notifications \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_KEY_ID.YOUR_KEY_SECRET" \
-H "x-timestamp: 1720000000" \
-H "x-nonce: 4f9d2c1e-1234-5678-9abc-def012345678" \
-H "x-signature: YOUR_HMAC_SIGNATURE" \
-d '{
"channel": "sms",
"recipient": { "address": "01012345678", "name": "홍길동" },
"content": { "text": "인증번호는 123456 입니다." }
}'x-signature는 YOUR_HMAC_SECRET으로 요청을 서명한 값입니다.
서명 생성 방법은 인증, 요청 본문 상세는 알림 발송 API를 참고하세요.
발송 이후에는 모니터링 › 발송 큐 / 전송 시도 화면에서 처리 상태와 결과를 추적할 수 있습니다. 운영 · 모니터링 문서에서 자세히 다룹니다.