2.6 통합발송

목차

• 1. 통합발송
• Appendix

1. 통합발송

Key-Value Data를 활용하여 다채널 순차발송 메시지를 발송합니다. 하나의 템플릿으로 여러 채널(SMS, LMS, MMS, 알림톡, 친구톡, Push 등)에 메시지를 발송할 수 있습니다.

📌 주의사항

1. 한 번에 최대 10명의 수신자에게 발송할 수 있습니다.
2. 예약발송은 현재 시점으로부터 최대 30일까지 가능합니다.
3. 단축URL 사용 시 메시지 길이가 제한될 수 있습니다.
4. 템플릿 코드는 사전에 승인된 것만 사용 가능합니다.
5. 채널별 발송 실패 시 다음 채널로 자동 전환됩니다.
6. kvData는 템플릿에 정의된 변수와 일치해야 합니다.

---

1) 요청 (Request)

URL

POST /msg/v1.1/send HTTP/1.1

Headers

Name	Type	필수	설명
Authorization	String	●	사용자 인증 토큰
Content-Type	String	●	application/json

Request Body

Name	Type	필수	설명	크기
clickUrlYn	String	-	단축URL 사용여부 (Y/N)	1자
resvYn	String	-	예약발송 여부 (Y/N)	1자
resvReqDt	String	-	예약발송 시간	-
agency	Object	-	대행사 정보	-
tmpltCode	String	●	스마트 템플릿 코드	20자
campaignId	String	-	캠페인 ID	20자
deptCode	String	-	부서 코드	20자
recvInfoLst	Array	●	수신자별 정보	10개

---

2) 응답 (Response)

Response Body

Name	Type	설명
code	String	결과 코드
message	String	결과 메시지
data	Array	결과 데이터 목록
data[].cliKey	String	클라이언트 키
data[].msgKey	String	메시지 키
data[].phone	String	수신번호
data[].code	String	결과 코드
data[].message	String	결과 메시지

---

3) 요청 예시 (Sample)

Curl

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1.1/send" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
        "clickUrlYn": "N",
        "resvYn": "N",
        "resvReqDt": "2025-07-13 13:15",
        "agency": {
          "kisaOrigCode": "123456789",
          "rcsAgencyId": "agencyId",
          "rcsAgencyKey": "AK.abcd1234"
        },
        "tmpltCode": "TPLN6dsLss",
        "deptCode": "MARKETING",
        "recvInfoLst": [
          {
            "cliKey": "test001",
            "callback": "07012341234",
            "phone": "01012341234",
            "kvData": {
              "이름": "홍길동",
              "날짜": "2024-03-15",
              "상품명": "U+ Cloud 서비스",
              "사용량": "1,000건",
              "한도": "1,000건",
              "링크": "https://m.uplus.co.kr/cloud/usage"
            }
          },
          {
            "cliKey": "test002",
            "callback": "07056785678",
            "phone": "01056785678",
            "cuid": "user456",
            "kvData": {
              "이름": "김철수",
              "날짜": "2024-03-15",
              "상품명": "U+ Cloud 서비스",
              "사용량": "1,200건",
              "한도": "1,000건",
              "링크": "https://m.uplus.co.kr/cloud/usage"
            }
          }
        ]
      }'

Response

{
  "code": "10000",
  "message": "성공",
  "data": [
    {
      "cliKey": "test001",
      "msgKey": "3jVnyk0m8U.6fKG1w",
      "phone": "01012341234",
      "code": "10000",
      "message": "성공"
    },
    ...
  ]
}

Appendix

Agency 객체

대행사 정보를 포함하는 객체입니다.

필드명	타입	필수	설명
kisaOrigCode	String	-	재판매사 KISA 최초식별코드
rcsAgencyId	String	-	RBC에 등록된 대행사ID
rcsAgencyKey	String	-	RBC에서 발급된 대행사키

recvInfoLst 객체

Name	Type	필수	설명	크기
cliKey	String	●	클라이언트키	30자
callback	String	-	발신번호	100자
phone	String	●	수신번호(국제문자 발송 시 맨 앞에 ‘0’이 없어야함)	20자
cuid	String	-	푸시 사용자아이디	50자
kvData	Object	-	개별화메시지 머지데이터	-

fbInfoLst 객체

Name	Type	필수	설명
ch	String	●	채널
title	String	-	제목(MMS의 경우 필수)
msg	String	●	메시지
fileId	String	-	파일아이디 (파일 아이디와 파일 아이디 목록 중 1개만 사용 가능)
fileIdLst	Array	-	파일 아이디 목록 (최대 3개)

결과 코드

• 결과 코드