3.5 통합메시지

목차

• 1. 템플릿 목록 조회
• 2. 템플릿 상세 화면 조회
• 3. 통합템플릿 상세 조회

1. 템플릿 목록 조회

메시지허브 콘솔에서 등록한 템플릿의 상세내용을 조회합니다.

1) 요청 (Request)

URL

GET https://mnt-api.msghub.uplus.co.kr/msg/v1/template/get HTTP/1.1

Headers

Name	Type	필수	설명
Authorization	String	●	사용자 인증 토큰

Query Parameters

Name	Type	필수	설명
ch	String	●	채널 (mms/rcs/alimtalk/friendtalk/push/smart)
listCntinteger	String	●	조회할 템플릿 목록 수
pageIdx	integer	●	페이지 번호

---

2) 응답 (Response)

Response Body

Name	Type	설명
code	String	결과 코드
message	String	결과 메시지
data	Object	결과 데이터 정보
data.ch	String	채널
data.tmpltId	String	템플릿 ID
data.tmpltName	String	템플릿명
data.senderType	String	발송유형
data.msgKind	String	메시지 구분
data.msgType	String	메시지 타입
data.tmpltStatus	String	템플릿 상태
data.regDt	String	템플릿 등록일시
data.updDt	String	템플릿 업데이트일시

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/msg/v1/template/all?ch=alimtalk&listCnt=2&pageIdx=1" \
  -H "accept: */*" \
  -H "Authorization: Bearer {token}"

JSON Response

{
  "code": "10000",
  "message": "성공",
  "data": [
   {
      "tmpltId": "TPJ..LP6",
      "tmpltName": "test001",
      "senderType": "Alimtalk",
      "msgKind": "정보성",
      "msgType": "",
      "tmpltStatus": "검수중",
      "regDt": "2025-08-11 09:52:36",
      "updDt": "2025-08-11 11:35:30"
    },
    {
      "tmpltId": "TPlcf..1",
      "tmpltName": "(테스트)템플릿 반려 알림 확인",
      "senderType": "Alimtalk",
      "msgKind": "광고성",
      "msgType": "",
      "tmpltStatus": "승인",
      "regDt": "2023-08-03 11:11:20",
      "updDt": "2024-09-06 14:22:49"
    }
  ]
}

2. 템플릿 상세 화면 조회

메시지허브 콘솔에서 등록한 템플릿의 상세내용을 조회합니다. (웹 팝업)

---

1) 요청 (Request)

URL

GET https://mnt-api.msghub.uplus.co.kr/msg/v1/template/detailPop HTTP/1.1

Headers

Name	Type	필수	설명
Authorization	String	●	사용자 인증 토큰

Query Parameters

Name	Type	필수	설명
ch	String	●	채널(mms/rcs/alimtalk/friendtalk/push/smart)
tmpltId	String	●	템플릿 ID

---

2) 응답 (Response)

Response Body

Name	Type	설명
code	String	결과 코드
message	String	결과 메시지

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/msg/v1/template/detailPop?ch=mms&tmpltId=1" \
  -H "accept: */*" \
  -H "Authorization: Bearer {token}"

JSON Response

성공시 응답

실패시 응답

{
  "code": "29009",
  "message": "요청한 데이터 없음"
}

3. 통합템플릿 상세 조회

메시지허브 콘솔에서 등록한 채널별 템플릿 목록을 조회합니다.

1) 요청 (Request)

URL

GET https://mnt-api.msghub.uplus.co.kr/msg/v1/template/get HTTP/1.1

Headers

Name	Type	필수	설명
Authorization	String	●	사용자 인증 토큰

Query Parameters

Name	Type	필수	설명
tmpltId	String	●	템플릿 ID

---

2) 응답 (Response)

Response Body

Name	Type	설명
code	String	결과 코드
message	String	결과 메시지
data	Object	결과 데이터 정보
data.tmpltCode	String	템플릿 코드
data.msgKind	String	발송 메시지 구분
data.tmpltTitle	String	템플릿명
data.msgType	String	발송 메시지 유형(기본:BASE, 이미지:IMAGE)
data.tmpltInfo	Object	템플릿 상태
data.tmpltInfo.ch	String	채널
data.tmpltInfo.data	Object	템플릿 정보
data.tmpltInfo.chTypeList	String	통합발송 채널 리스트

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://mnt-api.msghub.uplus.co.kr/msg/v1/template/get?tmpltId=TPL...ji" \
  -H "accept: */*" \
  -H "Authorization: Bearer {token}"

JSON Response

{
  "code": "10000",
  "message": "성공",
   "data": {
    "tmpltCode": "TPLO....i",
    "msgKind": "I",
    "msgType": "BASE",
    "tmpltTitle": "통합발송_테스트",
    "tmpltInfo": [
      {
        "ch": "RCS",
        "data": {
          "header": "0",
          "brandNm": "BR.d....uT",
          "buttons": [
            {}
          ],
          "agencyId": "....",
          "callback": "15440000",
          "mergeData": [
            {
              "description": "통합 발송 테스트\nRCS SMS 테스트 발송 입니다."
            }
          ],
          "rcsPrdType": "SMS",
          "copyAllowed": "false",
          "expiryOption": "2",
          "messagebaseId": "SS000000"
        },
        "chTypeList": "RCS,SMSMMS"
      },
      {
        "ch": "SMS",
        "data": {
          "msg": "통합 발송 테스트\nSMS 테스트 발송 입니다.",
          "callback": "15440000"
        },
        "chTypeList": "RCS,SMSMMS"
      }
    ]
  }
}

결과 코드

• 결과 코드