2.7 예약발송 관리

목차

• 1. 예약 발송 조회
• 2. 예약 발송 취소
• Appendix

1. 예약 발송 조회

예약된 메시지 발송 목록을 조회합니다. 현재 시점 이후로 예약된 모든 메시지의 상태를 확인할 수 있습니다.

📌 주의사항

1. 예약 발송 조회는 최대 90일 이내의 데이터만 조회 가능합니다.
2. 발송 완료된 메시지는 조회 결과에서 제외됩니다.
3. 예약 시간은 서버 시간 기준으로 처리됩니다.
4. 상태값은 ‘SEND_WAIT’(대기), ‘ING’(처리중), ‘FAIL’(실패), ‘COMPLETED’(완료) 중 하나입니다.

---

1) 요청 (Request)

URL

GET /msg/v1.1/resv/sendList HTTP/1.1

Headers

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

---

2) 응답 (Response)

Response Body

Name	Type	설명
code	String	결과 코드
message	String	결과 메시지
data.resvSendList	Array	예약 발송 목록
data.resvSendList[].webReqId	String	웹 요청 아이디
data.resvSendList[].ch	String	채널
data.resvSendList[].senderCnt	String	발송 건 수
data.resvSendList[].callback	String	발신번호
data.resvSendList[].status	String	예약 상태
data.resvSendList[].resvSenderYn	String	예약 발송 여부
data.resvSendList[].delYn	String	삭제 여부
data.resvSendList[].resvCnclReason	String	예약취소사유
data.resvSendList[].reqDt	String	예약 등록 일시

---

3) 요청 예시 (Sample)

Curl

curl -X GET "https://api.msghub.uplus.co.kr/msg/v1.1/resv/sendList" \
  -H "accept: */*" \
  -H "Authorization: Bearer {token}"

Response

{
  "code": "10000",
  "message": "성공",
  "data": {
    "resvSendList": [
      {
        "webReqId": "SYdJaVckL6K",
        "ch": "SMS",
        "senderCnt": "1",
        "callback": "01000001000",
        "status": "COMPLETED",
        "resvSenderYn": "N",
        "delYn": "N",
        "resvCnclReason": "",
        "reqDt": "2025-07-03T03:05:22"
      }
    ]
  }
}

2. 예약 발송 취소

예약된 메시지 발송을 취소합니다. 발송 전 예약된 메시지만 취소 가능합니다.

📌 주의사항

1. 이미 발송이 시작된 메시지는 취소할 수 없습니다.
2. 취소 사유는 필수 입력 항목입니다.
3. 취소된 메시지는 재발송이 불가능합니다.
4. 취소 처리 후에는 즉시 반영되어 조회됩니다.

---

1) 요청 (Request)

URL

POST /msg/v1/resv/sendCancel HTTP/1.1

Headers

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

Request Body

Name	Type	필수	설명
webReqId	String	●	웹 요청 아이디
resvCnclReason	String	●	예약 취소 사유

---

2) 응답 (Response)

Response Body

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

---

3) 요청 예시 (Sample)

Curl

curl -X POST "https://api.msghub.uplus.co.kr/msg/v1/resv/sendCancel" \
  -H "accept: */*" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
    "webReqId": "SMS1rQTUiu",
    "resvCnclReason": "마케팅 일정 변경으로 인한 발송 취소"
  }'

Response

{
  "code": "10000",
  "message": "성공"
}

Appendix

예약 상태 코드

상태	설명
SEND_WAIT	발송 대기
ING	처리중
FAIL	실패
COMPLETED	발송 완료

결과 코드

• 결과 코드