메시지 접수 및 처리

메시지 처리 방식

메시지는 그룹 단위로 접수 및 처리됩니다.
발송 요청 시 시스템이 자동으로 그룹을 생성하며, 이후 모든 처리(요청, 발송, 정산 등)는 해당 그룹을 기준으로 진행됩니다.

발송 내역에서는 그룹 전체 처리 상태와 개별 메시지 처리 상태를 각각 확인하실 수 있습니다.

• 그룹: 발송 요청 1회를 묶는 단위입니다.
  한 번의 발송 요청이 곧 1개의 그룹이 되며, 시스템은 이 그룹을 기준으로 접수/처리/결과를 관리합니다.

• 메시지: 그룹 안에서 수신번호 1건마다 개별적으로 생성되는 발송 단위입니다.
  예를 들어 수신번호 100건을 1회 요청하면, 1개의 그룹 안에 100개의 메시지가 생성됩니다.

발송 방식 별 안내

웹 발송 시

웹을 통한 메시지 발송은 1회 요청 시 수신번호 입력 건수에 제한이 없습니다.

API/SDK 발송 시

📌주의 사항
API/ SDK를 이용 대량 발송 시에는 반드시 여러 건을 묶어 1회 호출로 요청해 주세요.
1건씩 반복 호출하는 방식은 클라이언트 및 서버에 불필요한 부하를 유발하여 전체 처리 속도가 저하될 수 있습니다.

대량 발송 전 확인 사항

대량 메시지 발송 전, 아래 항목을 반드시 점검해 주세요.

• 하루 발송 한도 잔여 건수 확인 : 발송 예정 건수가 잔여 한도 이내인지 사전에 확인합니다.

• 발송 가능 건수 초과 여부 점검 : 일일 한도를 초과하는 경우, 해당 요청 전체가 접수 및 발송 실패 처리됩니다. 필요 시 사전에 발송 한도를 조정하세요.

메시지 처리 과정

발송 요청된 메시지는 아래 4단계를 거쳐 최종 처리됩니다.

1. 접수 및 그룹 생성

발신자가 메시지를 요청하면 시스템이 자동으로 그룹을 생성하고, 메시지를 그룹 단위로 구성합니다.

입력 정보가 규칙에 맞지 않거나 등록된 데이터와 불일치하는 경우(예: 수신번호 입력 오류, 메시지 타입 오류 등) 메시지는 처리되지 않으며, 상태코드 (1XXX) 로 반환됩니다.
이 경우 메시지 접수는 실패 처리됩니다.

2. 플랫폼 내부 검토

접수된 메시지는 이통사 전달 전에 솔라피 플랫폼에서 1차 검토를 진행합니다.

잔액 부족 또는 일일 발송 한도 초과로 인해 발송이 불가한 경우, 메시지는 발송대기(2000) 상태로 보관되며 이후 재발송이 가능합니다.
이 외 정책, 메시지 형식, 계정 상태 등의 검증 단계에서 발송이 실패하는 경우, 상태코드 (2XXX)로 반환되며 발송은 진행되지 않습니다.

3. 이통사 전달

내부 검토를 통과한 메시지는 이통사로 전달되며, 이 시점부터 메시지 상태는 발송중(3000) 으로 표시됩니다.
이통사는 수신자에게 메시지 전달을 위해 최대 24시간에서 72시간까지 재시도를 진행합니다.

⚠️ 이 단계 이후부터는 발송 취소가 불가합니다.
메시지가 이미 외부 시스템(이통사)으로 전달된 상태이므로, 이후 처리는 이통사 및 수신자 단말 환경에 따라 결정됩니다.

4. 이통사 처리 결과

이통사 처리 완료 후 결과 리포트가 플랫폼으로 전달되며, 그룹 상태는 처리 완료로 표시됩니다. 메시지 결과는 아래와 같이 구분됩니다.

• 발송 성공 (4000): 수신자에게 정상 전달 완료 (과금 대상)

• 발송 실패 (3xxx): 수신 실패 (사유 다양, 환급 대상)
  

발송 실패 원인 조회가 필요한 경우
발송 실패 사유는 수신번호별로 다를 수 있습니다.
정확한 원인 확인이 필요한 경우 고객지원팀으로 아래 정보를 포함하여 문의해 주세요.

• 접수 시간 (생성일)

• 수신번호

처리결과 확인하기

발송 내역 페이지에서 접수된 그룹 및 메시지의 처리 상태와 결과를 실시간으로 확인할 수 있습니다.

가이드 확인하기

• 그룹 단위 처리 결과

• 개별 메시지 처리 결과