MO(인증/투표)

MO는 사용자가 특정 번호로 회신하거나 참여한 인증, 투표 성격의 수신 메시지를 의미합니다.
MO 메시지는 등록한 Webhook URL로 수신합니다.

수신받기(Webhook)

POST{등록한 Webhook URL}

사전에 등록한 Webhook URL로 MO 메시지를 전달받습니다. 실제 Webhook URI는 수신 시스템마다 다를 수 있으며, 본 문서는 POST body 규격을 설명합니다.

Header

X-IB-Timestamp

필수String

Webhook 전송 시점의 타임스탬프입니다. Unix epoch 밀리초(ms) 값을 문자열로 보냅니다(예: 1743381600000). 현재 시각과 300초 넘게 차이 나는 요청은 거부하세요.

X-IB-Signature

필수String

보안 서명입니다. X-IB-Timestamp 문자열을 secret으로 HMAC-SHA256 서명한 뒤 Base64로 인코딩한 값입니다(Base64(HmacSHA256(secret, X-IB-Timestamp))). 직접 계산한 값과 timingSafeEqual 같은 상수 시간 비교로 대조하세요. secret은 Webhook 검증 전용 시크릿 값입니다. 검증을 위해 값 확인이 필요한 경우 영업담당자에 요청해주세요.

필수String

application/json.

Content-Type

필수String

application/json.

Body Parameters

{}JSON

msgKey

필수String

메시지 키입니다.

serviceType

필수String

서비스 타입입니다.

msgType

필수String

메시지 타입입니다.

필수String

수신번호(MO 번호)입니다.

from

필수String

MO발신자가 수동으로 입력한번호(기본적으로 단말기번호).

carrier

필수String

이통사코드.

originator

필수String

MO 발신 단말기 번호.

content

필수String

MO 메시지 본문 내용입니다.

occurredTime

필수String

MO 발생 시각입니다.

Returns

msgKey

String

수신한 메시지 키를 그대로 반환합니다.

요청 예시

curl -X POST "https://client.example.com/webhooks/mo" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-IB-Timestamp: 1743381600000" \
  -H "X-IB-Signature: {Base64(HmacSHA256(secret, X-IB-Timestamp))}" \
  -d '{
    "msgKey":"20260423141101437PSM949194539147",
    "serviceType":"MO",
    "msgType":"SM",
    "to":"#000000",
    "from":"0100000000",
    "carrier":"10001",
    "originator":"0100000000",
    "content":"그랜드 오픈!!!",
    "occurredTime":"2026-04-23T14:11:01+09:00"
  }'

응답 예시

{
  "msgKey":"20260423141101437PSM949194539147"
}