국제메시지
해외 번호로 문자메시지를 발송하는 가이드입니다.
발송 흐름은 국내 문자메시지와 같지만 번호 형식과 과금 기준이 다릅니다.
번호 형식
수신번호는 국가코드를 포함한 E.164 형식으로 입력해야 합니다.
| 국가 | 국가코드 | 입력 예시 |
|---|---|---|
| 미국 | 1 | +12025551234 |
| 일본 | 81 | +819012345678 |
| 영국 | 44 | +447911123456 |
| 싱가포르 | 65 | +6591234567 |
국가코드를 포함하지 않거나 형식이 맞지 않으면 발송이 실패합니다.
과금 기준
국제 SMS는 메시지 인코딩에 따라 글자 수 기준이 달라지며, 초과 시 건 단위로 분할 과금됩니다.
| 인코딩 | 기본 길이 | 초과 시 분할 단위 | 최대 분할 |
|---|---|---|---|
| GSM-7 (영문·숫자 위주) | 160자 | 153자 단위 | 5건 |
| Unicode (한글 등) | 70자 | 67자 단위 | 5건 |
예: 영문 200자 → 2건 과금, 한글 80자 → 2건 과금
DLR (Delivery Report)
DLR은 실제 단말기 전송 결과를 의미합니다.
국내 리포트와 개념은 같지만, 국제메시지는 국제 중계사 접수 결과를 기본 리포트로 처리합니다. 이 접수 결과가 과금 기준이 됩니다.
요청에 따라 단말 전달 결과(DLR)를 추가로 수신할 수 있습니다.
| 리포트 | 의미 | 수신 조건 | 과금 기준 |
|---|---|---|---|
| 기본 리포트 | 국제 중계사 접수 결과 | 기본 제공 | O |
| DLR | 실제 단말기 전송 결과 | API 키별 별도 설정 필요 | X |
DLR을 활성화하면 메시지 1건당 기본 리포트(접수 결과)와 DLR(전송 결과)이 각각 1건씩, 총 2건 수집됩니다.
DLR 수신 전 확인 사항
- DLR 수신은 API 키별 별도 설정이 필요합니다. 사용 전 영업 담당자에게 요청해 주세요.
- 국가·해외 중계사에 따라 실제 DLR이 회신되지 않을 수 있습니다. 이 경우 비즈고가 최대 5일간 대기한 뒤 실패(Timeout) 코드로 내려주므로, 리포트 2건이 누락되지는 않습니다.
- 그래서 DLR의 실패(Timeout)를 단말 전달 실패로 해석하면 안 됩니다. 단말에 정상 도착했더라도 중계사 회신이 없으면 실패로 내려갈 수 있습니다. 과금은 접수 리포트를 기준으로 합니다.
- 접수 리포트와 DLR 리포트의 수신 순서는 보장되지 않습니다. 리포트 종류를 구분해 처리하세요.
운영 시 주의사항
국제메시지 발송 전 확인 사항
- 국가마다 발신자 ID 허용 방식이 다릅니다. 발송 전 대상 국가 규정을 먼저 확인하세요.
- Fallback 자동 전환이 어려우므로 재시도 정책을 별도로 구성하는 것이 좋습니다.
- 일부 국가는 마케팅 메시지 발송에 별도 규제가 있습니다.
연동 전에 발송 구조를 먼저 확인하세요
destinations와 messageFlow 구조를 이해하면 어떤 연동 방식을 쓰든 같은 방식으로 다룰 수 있습니다.
발송 요청 구조 이해
destinations, messageFlow, Fallback 구조를 한 페이지에서 확인합니다.
발송 구조 이해하기 →
어떻게 연동하시나요?
구조를 파악했다면 아래에서 연동 방식을 선택하세요.