Login
      내용 x
      SMS API
        • 인쇄
        • PDF
        내용

        SMS API

          • 인쇄
          • PDF
          Article Summary

          기본 정보

          API URL

          https://sens.apigw.ntruss.com/sms/v2

          SENS SMS API Swagger 바로가기

          API Header

          항목Mandatory설명
          Content-TypeMandatory요청 Body Content Type을 application/json으로 지정 (POST)
          x-ncp-apigw-timestampMandatory- 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타냄
          - API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
          x-ncp-iam-access-keyMandatory포털 또는 Sub Account에서 발급받은 Access Key ID
          x-ncp-apigw-signature-v2Mandatory- 위 예제의 Body를 Access Key Id와 맵핑되는 SecretKey로 암호화한 서명
          - HMAC 암호화 알고리즘은 HmacSHA256 사용

          NAVER Cloud Platform 인증키 및 Signature 생성 가이드

          메시지

          메시지 발송

          SMS / LMS / MMS 메시지를 발송합니다.

          요청 URL

          POST https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/messages

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

          Path Variables

          항목MandatoryType설명비고
          serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

          Headers

          API Header 바로가기

          요청 Body

          {
    "type":"(SMS | LMS | MMS)",
    "contentType":"(COMM | AD)",
    "countryCode":"string",
    "from":"string",
    "subject":"string",
    "content":"string",
    "messages":[
        {
            "to":"string",
            "subject":"string",
            "content":"string"
        }
    ],
    "files":[
        {
             "fileId": "string"
        }
    ],
    "reserveTime": "yyyy-MM-dd HH:mm",
    "reserveTimeZone": "string"
}
          항목MandatoryType설명비고
          typeMandatoryStringSMS TypeSMS, LMS, MMS (소문자 가능)
          contentTypeOptionalString메시지 Type- COMM: 일반메시지
          - AD: 광고메시지
          - default: COMM
          countryCodeOptionalString국가 번호- SENS에서 제공하는 국가로의 발송만 가능
          - default: 82
          - 국제 SMS 발송 국가 목록
          fromMandatoryString발신번호사전 등록된 발신번호만 사용 가능
          subjectOptionalString기본 메시지 제목LMS, MMS에서만 사용 가능
          - LMS, MMS: 최대 40byte
          contentMandatoryString기본 메시지 내용- SMS: 최대 90byte
          - LMS, MMS: 최대 2000byte
          messagesMandatoryObject메시지 정보- 아래 항목 참조 (messages.XXX)
          - 최대 100개
          messages.toMandatoryString수신번호붙임표 ( - )를 제외한 숫자만 입력 가능
          messages.subjectOptionalString개별 메시지 제목LMS, MMS에서만 사용 가능
          - LMS, MMS: 최대 40byte
          messages.contentOptionalString개별 메시지 내용- SMS: 최대 90byte
          - LMS, MMS: 최대 2000byte
          files.fileIdOptionalString파일 아이디MMS에서만 사용 가능
          파일 업로드 참조
          reserveTimeOptionalString예약 일시메시지 발송 예약 일시 (yyyy-MM-dd HH:mm)
          reserveTimeZoneOptionalString예약 일시 타임존- 예약 일시 타임존 (기본: Asia/Seoul)
          - 지원 타임존 목록
          - TZ database name 값 사용
          주의
          • 최대 지원 가능한 사이즈를 초과하면 일부 내용이 잘림 처리되어 발송됩니다.
          • 메시지(subject, content) 인코딩은 EUC-KR 기준으로 발송되며 지원하지 않는 이모지 문자를 포함하면 발송에 실패합니다.
          참고
          • messages 내에 subject, content를 정의하지 않으면 기본 subject, content로 지정된 값으로 발송됩니다.
          • messages 내에 subject, content가 기본 subject, content 보다 우선 순위가 높습니다.
          • MMS type이지만 첨부하려는 파일이 없으면 LMS로 발송됩니다.

          응답 Body

          {
    "requestId":"string",
    "requestTime":"string",
    "statusCode":"string",
    "statusName":"string"
}
          항목MandatoryType설명비고
          requestIdMandatoryString요청 아이디
          requestTimeMandatoryDateTime요청 시간yyyy-MM-dd'T'HH:mm:ss.SSS
          statusCodeMandatoryString요청 상태 코드- 202: 성공
          - 그 외: 실패
          - HTTP Status 규격을 따름
          statusNameMandatoryString요청 상태명- success: 성공
          - fail: 실패

          응답 Status

          HTTP StatusDesc
          202Accept (요청 완료)
          400Bad Request
          401Unauthorized
          403Forbidden
          404Not Found
          429Too Many Requests
          500Internal Server Error

          파일 업로드

          MMS 발송을 위한 파일을 업로드합니다.

          요청 URL

          POST https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/files

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

          Path Variables

          항목MandatoryType설명비고
          serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

          Headers

          요청 Body

          {
    "fileName":"string",
    "fileBody":"string"
}
          항목MandatoryType설명비고
          fileNameMandatoryString파일 이름- .jpg, .jpeg 확장자를 가진 파일 이름
          - 최대 40자
          fileBodyMandatoryString파일 바디- .jpg, .jpeg 이미지를 Base64로 인코딩한 값
          - 원 파일 기준 최대 300Kbyte
          - 해상도 최대 1500 * 1440
          참고

          업로드하려는 파일명과 파일크기와 동일한 파일이 이미 존재하는 경우, 동일한 파일로 인지하여 파일을 재사용 합니다. (6일 보관)

          응답 Body

          {
    "fileId":"string",
    "createTime":"string",
    "expireTime":"string"
}
          항목MandatoryType설명비고
          fileIdMandatoryString파일 아이디MMS 메시지 발송 시 활용
          createTimeMandatoryDateTime파일 업로드 시간
          expireTimeMandatoryDateTime파일 만료 시간

          응답 Status

          HTTP StatusDesc
          200OK (업로드 완료)
          400Bad Request
          401Unauthorized
          403Forbidden
          404Not Found
          429Too Many Requests
          500Internal Server Error

          메시지 발송 요청 조회

          메시지 발송 요청을 조회합니다.

          요청 URL

          GET https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/messages

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

          Path Variables

          항목MandatoryType설명비고
          serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

          Parameters

          항목MandatoryType설명비고
          requestIdMandatoryString요청 아이디발송 요청 아이디
          requestStartTimeMandatoryString조회 시간 시작 시각yyyy-MM-dd HH:mm:ss
          requestEndTimeMandatoryString조회 시간 종료 시각yyyy-MM-dd HH:mm:ss
          completeStartTimeMandatoryString발송 완료 시작 시간yyyy-MM-dd HH:mm:ss
          completeEndTimeMandatoryString발송 완료 종료 시간yyyy-MM-dd HH:mm:ss
          messageIdOptionalString메시지 아이디
          typeOptionalString메세지 타입SMS, LMS, MMS
          contentTypeOptionalString콘텐츠 타입- COMM: 일반 메시지
          - AD: 광고 메시지
          countryCodeOptionalString국가 코드
          statusOptionalString발송 요청 상태- READY: 대기
          - PROCESSING: 처리 중
          - COMPLETED: 처리 완료
          fromOptionalString메세지 발신 번호붙임표 (-)를 제외한 번호
          toOptionalString메세지 수신 번호붙임표 (-)를 제외한 번호
          statusNameOptionalString단말 수신 상태- SUCCESS: 성공
          - FAIL: 실패
          pageIndexOptionalInteger페이지 번호default: 0
          pageSizeOptionalInteger페이지 크기default: 20, max: 100
          requestId를 포함한 조회시, default: 1000
          참고
          • 메시지 발송 이력은 최근 90일 이내의 이력만 조회할 수 있습니다.
          • requestId 또는 requestStartTime + requestEndTime 또는 completeStartTime + completeEndTime 중에 하나는 필수입니다.
          • requestStartTime + requestEndTime과 completeStartTime + completeEndTime은 동시에 사용할 수 없습니다.
          • requestStartTime ~ requestEndTime의 조회 범위는 최대 30일로 제한됩니다.
          • completeStartTime ~ completeEndTime의 조회 범위는 최대 24시간으로 제한됩니다.

          Headers

          API Header 바로가기

          요청 Body

          없음

          응답 Body

          {
    "statusCode": "string",
    "statusName": "string",
    "messages": [
        {
            "requestId": "string",
            "campaignId": "string",
            "messageId": "string",
            "requestTime": "string",
            "contentType": "string",
            "type": "string",
            "countryCode": "string",
            "from": "string",
            "to": "string",
            "completeTime": "string",
            "telcoCode": "string",
            "status": "string",
            "statusCode": "string",
            "statusName": "string",
            "statusMessage": "string"
        }
    ],
    "pageIndex": "integer",
    "pageSize": "integer",
    "itemCount": "integer",
    "hasMore": "boolean"
}
          항목MandatoryType설명비고
          statusCodeMandatoryString메시징 서버로의 발송 요청 상태- 202: 성공
          - 그 외: 실패
          - HTTP Status 규격을 따름
          statusNameMandatoryString메시징 서버로의 발송 요청 상태명- success: 성공
          - reserved: 예약 중
          - fail: 실패
          messages.requestIdMandatoryString메시지 요청 아이디
          messages.messageIdMandatoryString메시지 아이디
          messages.requestTimeMandatoryString발송 요청 시간yyyy-MM-dd HH:mm:ss
          messages.contentTypeMandatoryString메시지 Type- COMM: 일반 메시지
          - AD: 광고 메시지
          messages.countryCodeMandatoryString국가 번호
          messages.fromMandatoryString발신번호
          messages.toMandatoryString수신번호
          messages.statusMandatoryString발송 요청 상태- READY: 대기
          - PROCESSING: 처리 중
          - COMPLETED: 처리 완료
          messages.statusCodeOptionalString단말 수신 상태 결과 코드- 0: 성공
          - 그 외: 실패 (오류 코드 표 참고
          messages.statusNameOptionalString단말 수신 상태 결과명- success: 성공
          - fail: 실패
          messages.statusMessageOptionalString단말 수신 상태 결과 메시지
          messages.completeTimeOptionalString발송 완료 시간yyyy-MM-dd HH:mm:ss
          messages.telcoCodeOptionalString통신사코드
          pageIndexMandatoryInteger페이지 인덱스 (0부터 시작)
          pageSizeMandatoryInteger페이지 사이즈
          itemCountMandatoryInteger조회한 페이지 내의 메시지 수
          hasMoreMandatoryBoolean다음 페이지 존재 여부
          참고

          요청 상태가 완료(status: COMPLETED)가 되기 전에는 수신 결과에 해당하는 아래 필드들은 조회되지 않습니다.

          • statusCode
          • statusName
          • statusMessage
          • completeTime
          • telcoCode

          메시징 서버로의 발송 요청 상태명이 reserved(예약중)인 경우에는, messages 필드들은 조회되지 않습니다.

          응답 Status

          HTTP StatusDesc
          200OK (요청 완료)
          400Bad Request
          401Unauthorized
          403Forbidden
          404Not Found
          500Internal Server Error

          메시지 발송 결과 조회

          메시지 발송 결과를 조회합니다.

          요청 URL

          GET https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/messages/{messageId}

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

          Path Variables

          항목MandatoryType설명비고
          serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디
          messageIdMandatoryString메시지 아이디메시지 발송 요청 조회 시 반환되는 메시지 식별자

          Headers

          API Header 바로가기

          요청 Body

          없음

          응답 Body

          {
    "statusCode":"string",
    "statusName":"string",
    "messages":[
        {
            "requestTime":"string",
            "contentType":"string",
            "content":"string",
            "countryCode":"string",
            "from":"string",
            "to":"string",
            "status":"string",
            "statusCode":"string",
            "statusMessage":"string",
            "statusName":"string",
            "completeTime":"string",
            "telcoCode":"string",
            "files":[
                {
                    "name":"string",
                    "fileId":"string"
                }
            ]
        }
    ]
}
          항목MandatoryType설명비고
          statusCodeMandatoryString메시징 서버로의 발송 요청 상태- 200: 성공
          - 그 외: 실패
          statusNameMandatoryString메시징 서버로의 발송 요청 상태명- success: 성공
          - fail: 실패
          messages.requestTimeMandatoryDateTime요청 시간yyyy-MM-dd HH:mm:ss
          messages.contentTypeMandatoryString메시지 Type- COMM: 일반 메시지
          - AD: 광고 메시지
          messages.contentMandatoryString메시지 내용발송 요청했던 content가 그대로 조회나 실제 발송은 type별 길이 제한에 맞춰 발송
          messages.countryCodeMandatoryString국가 번호
          messages.fromMandatoryString발신번호
          messages.toMandatoryString수신번호
          messages.statusMandatoryString메시징 서버에서의 발송 처리 상태- READY: 대기
          - PROCESSING: 처리 중
          - COMPLETED: 처리 완료
          messages.statusCodeMandatoryString단말 수신 상태 결과 코드- 0: 성공
          - 그 외: 실패 (오류 코드 표 참고
          messages.statusNameMandatoryString단말 수신 상태 결과명- success: 성공
          - fail: 실패
          messages.statusMessageMandatoryString단말 수신 상태 결과 메시지
          messages.completeTimeMandatoryDateTime발송 완료 시간yyyy-MM-dd HH:mm:ss
          messages.telcoCodeMandatoryString통신사코드
          files.nameOptionalString첨부한 파일 이름MMS에서만 조회 가능
          files.fileIdOptionalString첨부한 파일 아이디MMS에서만 조회 가능
          참고

          메시지 발송 결과 이력은 최근 90일 이내의 이력만 조회할 수 있습니다.

          응답 Status

          HTTP StatusDesc
          200OK (요청 완료)
          400Bad Request
          401Unauthorized
          403Forbidden
          404Not Found
          500Internal Server Error

          예약 메시지

          예약 메시지 상태 조회

          메시지 발송 예약 상태를 조회합니다.

          GET https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/reservations/{reserveId}/reserve-status

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

          Path Variables

          항목MandatoryType설명비고
          serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디
          reserveIdMandatoryString예약 메시지 아이디예약 발송 요청 조회 시 반환되는 메시지 식별자(requestId)

          Headers

          API Header 바로가기

          요청 Body

          없음

          응답 Body

          {
  "reserveId": "string",
  "reserveTimeZone": "string",
  "reserveTime": "string",
  "reserveStatus": "string"
}
          항목MandatoryType설명비고
          reserveIdMandatoryString예약 메시지 아이디예약 발송 요청 조회 시 반환되는 메시지 식별자(requestId)
          reserveTimeMandatoryString예약 일시메시지 발송 예약 일시 (yyyy-MM-dd HH:mm)
          reserveTimeZoneMandatoryString예약 일시 타임존- 예약 일시 타임존 (기본: Asia/Seoul)
          - 지원 타임존 목록
          - TZ database name 값 사용
          reserveStatusMandatoryString예약 상태- READY:발송 대기
          - PROCESSING: 발송 요청 중
          - CANCELED: 발송 취소
          - FAIL: 발송 요청 실패
          - DONE: 발송 요청 성공
          - STALE: 발송 요청 실패 (시간 초과)

          응답 Status

          HTTP StatusDesc
          200OK (조회 완료)
          400Bad Request
          401Unauthorized
          403Forbidden
          404Not Found
          500Internal Server Error

          예약 메시지 취소

          메시지 발송 예약을 취소합니다.

          DELETE https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/reservations/{reserveId}

x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

          Path Variables

          항목MandatoryType설명비고
          serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디
          reserveIdMandatoryString예약 메시지 아이디예약 발송 요청 조회 시 반환되는 메시지 식별자(requestId)

          Headers

          API Header 바로가기

          요청 Body

          없음

          응답 Body

          없음

          응답 Status

          HTTP StatusDesc
          204No Content (삭제 완료)
          400Bad Request
          401Unauthorized
          403Forbidden
          404Not Found
          500Internal Server Error

          080 수신거부 번호

          수신거부 번호 조회

          수신거부된 번호를 조회합니다.

          요청 URL

          GET https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/unsubscribes

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

          Path Variables

          항목MandatoryType설명비고
          serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

          Parameters

          항목MandatoryType설명비고
          clientTelNoOptionalString수신거부 번호080 서비스 번호에 등록된 수신거부 번호
          pageSizeOptionalInteger페이지 사이즈- default: 100
          - 0 ~ 100 사이의 숫자만 입력 가능
          pageIndexOptionalInteger페이지 인덱스default: 0
          startTimeOptionalInteger조회 시작 시간- 수신거부 등록 시간 기준
          - default: 전체
          endTimeOptionalInteger조회 종료 시간- 수신거부 등록 시간 기준
          - default: 전체

          Headers

          API Header 바로가기

          요청 Body

          없음

          응답 Body

          [
    {
     "clientTelNo": "string",
     "registerTime": "string",
     "registerType": "char"
    }
]
          항목MandatoryType설명비고
          clientTelNoMandatoryString수신거부 번호
          registerTimeMandatoryString등록 시간foramt: LocalDateTime
          registerTypeMandatoryChar등록 수단- M(manual): 수동 등록
          - C(call): 전화 등록

          응답 Status

          HTTP StatusDesc
          200OK
          400Bad Request
          401Unauthorized
          403Forbidden
          404Not Found
          429Too Many Requests
          500Internal Server Error

          수신거부 번호 등록

          수신거부할 번호를 등록합니다.

          요청 URL

          POST https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/unsubscribes

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

          Path Variables

          항목MandatoryType설명비고
          serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

          Parameters

          없음

          Headers

          API Header 바로가기

          요청 Body

          [
    {
        "clientTelNo":"string"
    }
]
          항목MandatoryType설명비고
          clientTelNoMandatoryString수신거부 번호한 번에 1,000건까지 요청 가능(List)

          응답 Body

          [
    {
        "clientTelNo": "string",
        "registerTime": "string",
        "registerType": "char"
    }
]
          항목MandatoryType설명비고
          clientTelNoMandatoryString수신거부 번호
          registerTimeMandatoryString등록 시간foramt: LocalDateTime
          registerTypeMandatoryChar등록 수단- M(manual): 수동 등록
          - C(call): 전화 등록

          응답 Status

          HTTP StatusDesc
          200OK
          400Bad Request
          401Unauthorized
          403Forbidden
          404Not Found
          429Too Many Requests
          500Internal Server Error

          수신거부 번호 삭제

          수신거부된 번호를 삭제합니다.

          요청 URL

          DELETE https://sens.apigw.ntruss.com/sms/v2/services/{serviceId}/unsubscribes

Content-Type: application/json; charset=utf-8
x-ncp-apigw-timestamp: {Timestamp}
x-ncp-iam-access-key: {Sub Account Access Key}
x-ncp-apigw-signature-v2: {API Gateway Signature}

          Path Variables

          항목MandatoryType설명비고
          serviceIdMandatoryString서비스 아이디프로젝트 등록 시 발급받은 서비스 아이디

          Parameters

          없음

          Headers

          API Header 바로가기

          요청 Body

          [
    {
        "clientTelNo":"string"
    }
]
          항목MandatoryType설명비고
          clientTelNoMandatoryString수신거부 번호한 번에 1,000건까지 요청 가능(List)

          응답 Body

          없음

          응답 Status

          HTTP StatusDesc
          204No Content(삭제 완료)
          400Bad Request
          401Unauthorized
          403Forbidden
          404Not Found
          429Too Many Requests
          500Internal Server Error

          메시지 발송 예제

          SMS 메시지

          일반 메시지

          {
    "type":"SMS",
    "contentType":"COMM",
    "countryCode":"82",
    "from":"01012345678",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

          예약 메시지

          {
    "reserveTime":"2019-07-25 17:09",
    "type":"SMS",
    "contentType":"COMM",
    "countryCode":"82",
    "from":"01012345678",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

          광고 메시지

          {
    "type":"SMS",
    "contentType":"AD",
    "countryCode":"82",
    "from":"01012345678",
    "content":"(광고) 업체명 내용 [무료 수신거부]08012345678",
    "messages":[
        {
            "to":"01012345678",
            "content":"(광고) 업체명 위의 content와 별도로 해당 번호로만 보내는 내용(optional) [무료 수신거부]08012345678"
        }
    ]
}

          LMS 메시지

          일반 메시지

          {
    "type":"LMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

          예약 메시지

          {
    "reserveTime":"2019-07-25 17:09",
    "type":"LMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ]
}

          광고 메시지

          {
    "type":"LMS",
    "contentType":"AD",
    "from":"01012345678",
    "subject":"제목",
    "content":"(광고) 업체명 내용 [무료 수신거부]08012345678",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"(광고) 업체명 위의 content와 별도로 해당 번호로만 보내는 내용(optional) [무료 수신거부]08012345678"
        }
    ]
}

          MMS 메시지

          일반 메시지

          {
    "type":"MMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ],
    "files":[
        {
            "fileId": "4fe2078b-5926-42f2-b6b3-0c7bab9b8c5a"
        }
    ]
}

          예약 메시지

          {
    "reserveTime":"2019-07-25 17:09",
    "type":"MMS",
    "contentType":"COMM",
    "from":"01012345678",
    "subject":"제목",
    "content":"내용",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"위의 content와 별도로 해당 번호로만 보내는 내용(optional)"
        }
    ],
    "files":[
        {
            "fileId": "4fe2078b-5926-42f2-b6b3-0c7bab9b8c5a"
        }
    ]
}

          광고 메시지

          {
    "type":"MMS",
    "contentType":"AD",
    "from":"01012345678",
    "subject":"제목",
    "content":"(광고) 업체명 내용 [무료 수신거부]08012345678",
    "messages":[
        {
            "to":"01012345678",
            "subject":"위의 content와 별도로 해당 번호로만 보내는 제목(optional)",
            "content":"(광고) 업체명 위의 content와 별도로 해당 번호로만 보내는 내용(optional) [무료 수신거부]08012345678"
        }
    ],
    "files":[
        {
            "fileId": "4fe2078b-5926-42f2-b6b3-0c7bab9b8c5a"
        }
    ]
}

          오류 코드

          EMMA v.3 수신 결과 코드

          • EMMA Version: EMMA V3.5.1 이상
          • IB G/W Report Code: 이통사 전송 후 받은 결과 코드
          • IB G/W Response Code: 중계사 G/W가 메시지 수신 후 주는 결과 코드
          • IB EMMA: EMMA가 메시지 전송 요청에 대해 처리한 오류 코드

          IB G/W Report Code

          코드분류의미
          0success성공
          2000failure전송 시간 초과
          2001failure전송 실패 (무선망단)
          2002failure전송 실패 (무선망 -> 단말기단)
          2003failure단말기 전원 꺼짐
          2004failure단말기 메시지 버퍼 풀
          2005failure음영지역
          2006failure메시지 삭제됨
          2007failure일시적인 단말 문제
          3000Invalid전송할 수 없음
          3001Invalid가입자 없음
          3002Invalid성인 인증 실패
          3003Invalid수신번호 형식 오류
          3004Invalid단말기 서비스 일시 정지
          3005Invalid단말기 호 처리 상태
          3006Invalid착신 거절
          3007InvalidCallback URL을 받을 수 없는 폰
          3008Invalid기타 단말기 문제
          3009Invalid메시지 형식 오류
          3010InvalidMMS 미지원 단말
          3011Invalid서버 오류
          3012Invalid스팸
          3013Invalid서비스 거부
          3014Invalid기타
          3015Invalid전송 경로 없음
          3016Invalid첨부파일 사이즈 제한 실패
          3017Invalid발신번호 변작 방지 세칙 위반
          3018Invalid발신번호 변작 방지 서비스에 가입된 휴대폰 개인가입자 번호
          3019InvalidKISA 또는 미래부에서 모든 고객사에 대하여 차단 처리 요청한 발신번호
          3022InvalidCharset Conversion Error
          3023Invalid발신번호 사전등록제를 통해 등록되지 않은 번호

          IB G/W Response Code

          코드의미
          1001Server Busy (RS 내부 저장 Queue Full)
          1002수신번호 형식 오류
          1003회신번호 형식 오류
          1004SPAM
          1005사용 건수 초과
          1006첨부 파일 없음
          1007첨부 파일 있음
          1008첨부 파일 저장 실패
          1009CLIENT_MSG_KEY 없음
          1010CONTENT 없음
          1011CALLBACK 없음
          1012RECIPIENT_INFO 없음
          1013SUBJECT 없음
          1014첨부 파일 KEY 없음
          1015첨부 파일 NAME 없음
          1016첨부 파일 크기 없음
          1017첨부 파일 Content 없음
          1018전송 권한 없음
          1019TTL 초과
          1020charset conversion error
          S000중계사 요청 실패 (서버 에러)
          S001중계사 요청 실패 (서버 에러)
          S002중계사 요청 실패 (잘못된 요청)
          S003중계사 요청 실패 (스팸 처리)
          S004쿼터 초과
          S005잘못된 MMS 파일
          S006MMS 파일을 찾을 수 없음
          S007MMS 파일 만료
          S008MMS 파일 크기 초과
          S009MMS 파일 해상도 초과
          S010MMS 파일 업로드 쿼터 초과
          S011MMS 파일 업로드 실패
          S012발신번호 세칙 오류
          S998예기치 못한 서버 오류
          S999기타 오류

          IB EMMA

          코드의미
          E900Invalid-IB 전송키가 없는 경우
          E901수신번호가 없는 경우
          E902동보인 경우) 수신번호순번이 없는 경우
          E903제목 없는 경우
          E904메시지가 없는 경우
          E905회신번호가 없는 경우
          E906메시지키가 없는 경우
          E907동보 여부가 없는 경우
          E908서비스 타입이 없는 경우
          E909전송 요청 시각이 없는 경우
          E910TTL 타임이 없는 경우
          E911서비스 타입이 MMS MT인 경우, 첨부파일 확장자가 없는 경우
          E912서비스 타입이 MMS MT인 경우, attach_file 폴더에 첨부파일이 없는 경우
          E913서비스 타입이 MMS MT인 경우, 첨부파일 사이즈가 0인 경우
          E914서비스 타입이 MMS MT인 경우, 메시지 테이블에는 파일그룹키가 있는데 파일 테이 블에 데이터가 없는 경우
          E915중복메시지
          E916인증서버 차단번호
          E917고객DB 차단번호
          E918USER CALLBACK FAIL
          E919발송 제한 시간인 경우, 메시지 재발송 처리가 금지 된 경우
          E920서비스 타입이 LMS MT인 경우, 메시지 테이블에 파일그룹키가 있는 경우
          E921서비스 타입이 MMS MT인 경우, 메시지 테이블에 파일그룹키가 없는 경우
          E922동보단어 제약문자 사용 오류
          E999기타오류
          이 문서가 도움이 되었습니까?
          What's Next
          Change password!
          Changing your password will log you out immediately. Use the new password to log back in.
          Change profile
          Success!
          First name must have atleast 2 characters. Numbers and special characters are not allowed.
          Last name must have atleast 1 characters. Numbers and special characters are not allowed.
          Enter a valid email
          Enter a valid password
          Your profile has been successfully updated.
          Logout