bizgo Developers

통합메시지 (Omni)

통합메시지는 messageFlow에 채널 우선순위를 지정하면, 앞 채널 발송이 실패했을 때 다음 채널로 자동 전환(Fallback)하는 발송 방식입니다.
발송 성공률을 극대화하고 비용을 최적화할 수 있습니다.

왜 통합메시지를 사용하나요?

상황문제통합메시지 해결 방식
카카오 미설치 수신자알림톡 발송 실패SMS로 자동 전환
RCS 미지원 단말 (iOS 등)RCS 발송 실패SMS로 자동 전환
채널 일시 장애특정 채널 발송 불가다음 채널로 자동 전환
수신 거부채널 수신 불가대체 채널로 전환

폴백 흐름 예시

1순위: 카카오 알림톡  ─── 발송 성공 → 완료
           │
           └── 실패 (미설치 · 수신 거부)
                    │
                    ▼
        2순위: RCS  ─── 발송 성공 → 완료
                    │
                    └── 실패 (미지원 단말)
                             │
                             ▼
                  3순위: SMS ─── 발송 완료

핵심 구조

통합메시지의 핵심은 destinations와 messageFlow 두 필드입니다.

  • destinations: 수신자 목록 (번호, 치환어)
  • messageFlow: 채널 우선순위 배열. 인덱스 순서대로 발송을 시도하며, 앞 채널이 실패하면 다음으로 자동 전환됩니다.

발송 구조를 더 자세히 이해하려면 아래 문서를 확인하세요.

발송 요청 구조 이해

destinations, messageFlow, Fallback 구조를 한 페이지에서 확인합니다.

구조 이해하기 →

과금 방식

폴백 발송 시 최종 성공한 채널의 단가로만 과금됩니다.
시도만 하고 실패한 채널은 과금되지 않습니다.

카카오 알림톡 (실패) → SMS (성공) → SMS 단가로만 과금

다음 단계