채널 연결

알림을 발송하려면 채널마다 최소 하나의 공급자 계정을 연결하고 라우팅을 활성화해야 합니다. 모든 설정은 대시보드의 셋업 › 채널 메뉴에서 채널 단위로 관리합니다.

지원 채널

Posmit이 지원하는 채널과 각 채널에 연결할 수 있는 공급자는 다음과 같습니다.

카카오 비즈니스 채널을 통해 보내는 정보성 메시지입니다. 공급자로 Aligo 와 SOLAPI 를 연결할 수 있습니다. 발신프로필 동기화와 템플릿 검수 절차는 카카오 알림톡 문서에서 자세히 안내합니다.

단문과 장문 문자를 보냅니다. 공급자로 Aligo 와 SOLAPI 를 연결할 수 있으며, 두 공급자 모두 사전 등록한 발신번호만 사용할 수 있습니다.

Firebase Cloud Messaging 으로 앱 사용자에게 푸시 알림을 보냅니다. Firebase 콘솔에서 내려받은 서비스 계정 JSON으로 연결합니다.

HTML과 텍스트 형식의 트랜잭션 · 마케팅 이메일을 보냅니다. 공급자로 Resend , AWS SES , MailerSend 를 연결할 수 있습니다. 자체 도메인 인증은 이메일 발송(SES), 구독자 대상 대량 발송은 뉴스레터 문서를 참고하세요.

Webhook URL 또는 봇 토큰으로 Slack 채널에 메시지를 보냅니다. Webhook 방식은 받는 사람 주소가 필요 없으며, 등록한 URL에 연결된 채널로 그대로 전달됩니다.

Webhook URL 또는 봇 토큰으로 Discord 채널에 메시지를 보냅니다. Slack과 마찬가지로 Webhook 방식은 등록한 URL에 연결된 채널로 전달됩니다.

셋업 › 채널에서 채널을 선택한 뒤 공급자 연결 화면으로 이동합니다. 등록에는 운영자 이상의 권한이 필요합니다.

공급자를 고르면 필요한 자격 증명(API 키, 발신번호 등)이 화면에 안내되므로, 그대로 입력하면 됩니다. 입력한 자격 증명은 서버에 암호화되어 저장되며, 등록 후에는 평문으로 다시 조회할 수 없습니다. 비활성 상태로 등록한 계정은 라우팅에서 제외됩니다.

등록된 공급자 중 SOLAPI(잔액), Aligo(잔여 SMS 건수)는 채널 화면에서 잔여 발송량이 함께 표시됩니다.

같은 채널에 여러 공급자를 연결하면 우선순위 순서대로 발송을 시도합니다. 채널 화면의 라우팅 목록에서 다음과 같이 관리합니다.

발송 시 동작은 화면 안내 문구 그대로입니다 — “활성 공급자만 위에서부터 발송 시도, 실패 시 다음 공급자로 폴백”. 해당 채널에 활성 라우트가 하나도 없으면 발송 요청은 unsupported_channel 오류로 즉시 실패합니다.

라우트는 API로도 관리할 수 있습니다 — 라우팅과 폴백을 참고하세요.

공급자 상세 화면 하단의 테스트 / 인스턴스 발송 카드에서 해당 공급자만 지정해 단건을 발송할 수 있습니다. 라우팅과 폴백을 거치지 않으므로 이 공급자의 설정이 올바른지 그대로 검증됩니다. 조회자 권한으로는 발송할 수 없습니다.

모드	용도	비활성 공급자
테스트 발송 (`test`)	설정 점검용 1건 발송	허용
인스턴스 발송 (`instance`)	실제 알림 1건 즉시 발송(발송량 차감)	불가

채널은 따로 지정하지 않으며 공급자 종류에서 자동으로 결정됩니다. API 명세는 공급자 관리를 참고하세요. 채널별 주의사항은 다음과 같습니다.

알림톡: 자유 본문을 보낼 수 없습니다. 검수 승인(APPROVED)된 템플릿을 선택하고 변수만 채워 발송합니다. 템플릿 코드가 없으면 400, 다른 공급자에 바인딩된 템플릿이면 403 응답을 받습니다.
Webhook 채널(Slack/Discord Webhook): recipient를 생략합니다. 등록된 Webhook URL의 채널로 발송됩니다.
이메일: 억제 목록(수신 거부 · 반송 등)에 등재된 주소로는 테스트 발송을 포함한 모든 발송이 차단됩니다.

발송이 실패하면 공급자의 실패 메시지와 함께 502 응답이 반환되고, 시도 내역은 일반 발송과 동일하게 전송 시도 로그에 기록됩니다.

라우팅에 여러 공급자를 등록해 두면 장애 상황에서도 발송이 이어집니다.

우선순위가 낮은 숫자(목록 상단)부터 순서대로 시도합니다.
재시도 가능한 실패(잔액 소진, 공급자 속도 제한, 일시 장애 등)일 때만 다음 공급자로 폴백합니다.
잘못된 요청, 인증 오류처럼 재시도해도 소용없는 실패는 즉시 종료하며 다음 공급자를 시도하지 않습니다.
특정 공급자 계정이 5회 연속 실패하면 서킷브레이커가 60초간 해당 계정을 차단하고, 그동안 다음 우선순위 공급자로 폴백합니다.
모든 공급자가 실패하면 잡 레벨에서 재시도(기본 3회, 지수 백오프)한 뒤 최종 실패 처리되고 notification.failed 웹훅이 발행됩니다.

폴백 판정 규칙과 서킷브레이커의 상세 동작은 라우팅과 폴백 문서를 참고하세요.