국제메시지

국제 문자(SMS) 메시지 발송 규격입니다.

  • 장문 메시지를 보낼 경우 Concatenated SMS(분할 전송)로 전송됩니다.

  • 요청 시 DLR 정보를 수신 받을 수 있습니다. (영업담당자 문의)

  • 상세 Response 내용은 코드표를 참조해주시기 바랍니다.

수신번호 입력 시 국제수신번호규격(E.164)으로 전달 해야 합니다.

국제메시지 전송

curl -X POST https://omni.ibapi.kr/v1/send/international \
-H "content-type: application/json" \
-H "Accept: application/json" \
-H "Authorization:Bearer 발급받은 토큰" \
-d '{"from":"발신번호","text":"메시지 내용", "to":"수신번호(국제형식)", "ref":"참조필드"}' 

Request

Header

NameTypeDescription

Authorization

String

schema + “ “ + token

Content-Type

String

application/json

Accept

String

application/json

Body

NameTypeRequiredDescription

from

String

YES

발신번호

to

String

YES

수신번호(국제형식, +821000000000)

text

String(2000)

YES

메시지 내용

ref

String(200)

NO

참조필드

Response

Header

NameTypeDescription

Content-Type

String

application/json

Body

NameTypeDescription

code

String(4)

API호출 결과 코드

result

String

API호출 결과 설명

msgKey

String

메시지 키

ref

String(200)

참조필드(요청 시 입력한 데이터)

참고 사항

Concatenated SMS

해외는 국가별 통신 규격에 따라 SMS 길이만 지원하는 경우도 있고 국내의 LMS와 비슷하게 긴 문자 메시지를 지원하기도 합니다. 이를 Concatenated SMS라고 칭하며 긴 문자를 전송하시는 경우 최대 전송 가능 길이는 일반적으로 다음과 같으며 요금은 기본 SMS 길이의 배수로 과금 됩니다.

메시지 길이가 기본 메시지 길이인 160자(현지어 70자)를 초과하는 경우

  • 알파벳/숫자 전송 시 153자 단위로 과금 : 153자 * 5건 = 최대 765자

  • 현지어 전송 시 67자 단위로 과금 : 67자 * 5건 = 최대 335자

메시지 서명

해외로 메시지를 전송하는 경우 타 서비스 사칭이나 스팸 메시지를 차단하기 위해 메시지 내용에 메시지 전송자의 서비스명이나 회사명을 식별할 수 있는 내용을 반드시 삽입하도록 하는 경우가 있습니다. 이를 ‘메시지 서명’이라고 하며 사전 등록이 필요합니다. 중국이 대표적인 국가이며 【INFO中国】과 같은 형태로 문자 내용 맨 앞에 삽입해야 합니다.

Sender ID

메시지 발신자 정보로서 단말기에서 메시지 수신 시 보내는 사람 영역에 표현되는 숫자/문자를 Sender ID라고 합니다. 해외 일부 국가/통신사의 경우 Sender ID로 '15882460'과 같은 숫자 뿐만 아니라 'Korea'와 같은 문자열을 사용할 수 있습니다. 타 서비스를 사칭하거나 스팸 메시지를 차단하기 위해 기업이나 서비스 고유의 문자열을 해외 통신사에 미리 등록하고 메시지를 전송하도록 하는 경우가 있으며, 대표적인 예로 인도네시아, 인도, 필리핀, 태국 등이 있습니다. 상세한 정보는 영업 담당자를 통해 확인 가능하며 통상 등록에 2주~4주 정도 소요됩니다.

DLR(Delivery Report)

실제 단말기 전송 결과 입니다. 국내 리포트와 동일한 개념이지만 국제메시지의 경우 국제 중계사 접수 결과를 리포트로 처리하고 있습니다.(과금 기준) 요청에 의해 수신 가능하며 메시지 1건 당 기존 리포트(접수 결과)와 DLR(전송 결과) 각 1건 씩 총2건이 수집 됩니다.

Last updated