> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-15.md).

# 메시지 발송 관리

## 메세지 정보를 검증합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 메세지 정보를 검증합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 메세지 정보를 검증합니다.\
> &#x20; \* 메세지 정보를 수정하기 전 메세지 정보를 검증합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/system/sendMessageMgmt/validateSendMessageBaseInfo":{"post":{"tags":["메시지 발송 관리"],"summary":"메세지 정보를 검증합니다.","description":"  ## 기능 설명\n  * 메세지 정보를 검증합니다.\n  ---\n  ## 상세 설명\n  * 메세지 정보를 검증합니다.\n  * 메세지 정보를 수정하기 전 메세지 정보를 검증합니다.\n","operationId":"validateSendMessageBaseInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메세지 발송 대상 정보를 검증합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 메세지 발송 대상 정보를 검증합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 메세지 발송 대상 정보를 검증합니다.\
> &#x20; \* 메세지 발송 대상 정보를 등록하기 전에 해당 대상이 이미 등록된 회원인지 체크합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/system/sendMessageMgmt/validateInsertSendMessageTargetMember":{"post":{"tags":["메시지 발송 관리"],"summary":"메세지 발송 대상 정보를 검증합니다.","description":"  ## 기능 설명\n  * 메세지 발송 대상 정보를 검증합니다.\n  ---\n  ## 상세 설명\n  * 메세지 발송 대상 정보를 검증합니다.\n  * 메세지 발송 대상 정보를 등록하기 전에 해당 대상이 이미 등록된 회원인지 체크합니다.\n","operationId":"validateInsertSendMessageTargetMember","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 테스트 메세지를 발송합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 테스트 메세지를 발송합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 테스트 메세지를 발송합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/system/sendMessageMgmt/sendTestMessage":{"post":{"tags":["메시지 발송 관리"],"summary":"테스트 메세지를 발송합니다.","description":"  ## 기능 설명\n  * 테스트 메세지를 발송합니다.\n  ---\n  ## 상세 설명\n  * 테스트 메세지를 발송합니다.\n","operationId":"sendTestMessage","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메세지 수신 대상 등록

> &#x20;   \## 기능 설명\
> &#x20;   \* 수신 대상 일괄 등록 시 데이터롤 저장합니다.\
> &#x20;   \---\
> &#x20;   \## 상세 설명\
> &#x20;   \* 수신 대상 일괄 등록 시 최초에 발송 여부 'N'으로 저장합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"ResponseInteger":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"integer","format":"int32","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/system/sendMessageMgmt/saveStMsgTgtMbrInfoExcel":{"post":{"tags":["메시지 발송 관리"],"summary":"메세지 수신 대상 등록","description":"    ## 기능 설명\n    * 수신 대상 일괄 등록 시 데이터롤 저장합니다.\n    ---\n    ## 상세 설명\n    * 수신 대상 일괄 등록 시 최초에 발송 여부 'N'으로 저장합니다.\n","operationId":"saveStMsgTgtMbrInfoExcel","parameters":[{"name":"msgSndNo","in":"query","description":"메세지 발송 번호","required":true,"schema":{"type":"String"}},{"name":"mbrId","in":"query","description":"회원ID","required":true,"schema":{"type":"String"}},{"name":"applyYn","in":"query","description":"적용여부","required":true,"schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseInteger"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메세지 대상 회원을 등록합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 메세지 대상 회원을 등록합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 메세지 대상 회원을 등록합니다.\
> &#x20; \* 메세지에 등록되지 않은 회원 정보를 등록합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/sendMessageMgmt/insertSendMessageTargetMember":{"post":{"tags":["메시지 발송 관리"],"summary":"메세지 대상 회원을 등록합니다.","description":"  ## 기능 설명\n  * 메세지 대상 회원을 등록합니다.\n  ---\n  ## 상세 설명\n  * 메세지 대상 회원을 등록합니다.\n  * 메세지에 등록되지 않은 회원 정보를 등록합니다.\n","operationId":"insertSendMessageTargetMember","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메세지 기본 정보를 등록/수정합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 메세지 기본 정보를 등록/수정합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 메세지 기본 정보를 등록/수정합니다.\
> &#x20; \* 등록하려는 메세지 번호가 기등록되어있는 경우 수정합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/system/sendMessageMgmt/insertSendMessageBaseInfo":{"post":{"tags":["메시지 발송 관리"],"summary":"메세지 기본 정보를 등록/수정합니다.","description":"  ## 기능 설명\n  * 메세지 기본 정보를 등록/수정합니다.\n  ---\n  ## 상세 설명\n  * 메세지 기본 정보를 등록/수정합니다.\n  * 등록하려는 메세지 번호가 기등록되어있는 경우 수정합니다.\n","operationId":"insertSendMessageBaseInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메세지 수신 대상 유효성 검증

> &#x20;   \## 기능 설명\
> &#x20;   \* 수신 대상 일괄 등록 시 대상 회원의 유효성을 검증합니다.\
> &#x20;   \---\
> &#x20;   \## 상세 설명\
> &#x20;   \* 수신 대상 일괄 등록 유효성 검증 후 applyYn, errorCode, errorMsg 결과를 반환합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/sendMessageMgmt/getMbrInfoValidation":{"post":{"tags":["메시지 발송 관리"],"summary":"메세지 수신 대상 유효성 검증","description":"    ## 기능 설명\n    * 수신 대상 일괄 등록 시 대상 회원의 유효성을 검증합니다.\n    ---\n    ## 상세 설명\n    * 수신 대상 일괄 등록 유효성 검증 후 applyYn, errorCode, errorMsg 결과를 반환합니다.\n","operationId":"getMbrInfoValidation","parameters":[{"name":"msgSndNo","in":"query","description":"메세지 발송 번호","required":true,"schema":{"type":"String"}},{"name":"mbrId","in":"query","description":"회원ID","required":true,"schema":{"type":"String"}},{"name":"mbrNm","in":"query","description":"회원명","required":true,"schema":{"type":"String"}},{"name":"validationType","in":"query","description":"유효성 검증 타입","required":true,"schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메세지 대상 회원을 삭제합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 메세지 대상 회원을 삭제합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 메세지 대상 회원을 삭제합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/system/sendMessageMgmt/deleteSendMessageTargetMember":{"post":{"tags":["메시지 발송 관리"],"summary":"메세지 대상 회원을 삭제합니다.","description":"  ## 기능 설명\n  * 메세지 대상 회원을 삭제합니다.\n  ---\n  ## 상세 설명\n  * 메세지 대상 회원을 삭제합니다.\n","operationId":"deleteSendMessageTargetMember","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 단축 URL 조회

> &#x20; \## 기능 설명\
> &#x20; \* 단축 URL 정보를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 단축 URL 정보를 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"SendMessageMgmtResponse":{"type":"object","description":"메시지 발송 Response","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"msgTitle":{"type":"string","description":"메시지제목"},"msgConts":{"type":"string","description":"메시지내용"},"msgTypCd":{"type":"string","description":"메시지유형코드"},"msgTypCdNm":{"type":"string","description":"메시지유형명"},"msgSndTypCd":{"type":"string","description":"발송유형코드"},"msgSndTypCdNm":{"type":"string","description":"발송유형명"},"msgSndMethCd":{"type":"string","description":"발송방식코드"},"msgSndMethCdNm":{"type":"string","description":"발송방식명"},"msgSndStatCd":{"type":"string","description":"발송상태코드"},"msgSndStatCdNm":{"type":"string","description":"발송상태명"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송예약일시"},"sndCnt":{"type":"integer","format":"int32","description":"대상 수"},"notSentCnt":{"type":"integer","format":"int32","description":"미발송 수"},"sucsCnt":{"type":"integer","format":"int32","description":"성공 수"},"failCnt":{"type":"integer","format":"int32","description":"실패 수"},"msgSndStrDtm":{"type":"string","format":"date-time","description":"발송시작일시"},"msgSndEndDtm":{"type":"string","format":"date-time","description":"발송종료일시"},"siteNm":{"type":"string","description":"사이트명"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"recvmnVetoNo":{"type":"string","description":"수신자거부번호"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"msgSndSeq":{"type":"string","description":"메시지발송순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"recvmnNo":{"type":"string","description":"수신 번호"},"sendResult":{"type":"string","description":"발송 결과"},"sendResultNm":{"type":"string","description":"발송 결과 명"},"failCaus":{"type":"string","description":"실패 사유"},"shortUrl":{"type":"string","description":"단축 URL"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/sendMessageMgmt/getShortUrl":{"get":{"tags":["메시지 발송 관리"],"summary":"단축 URL 조회","description":"  ## 기능 설명\n  * 단축 URL 정보를 조회합니다.\n  ---\n  ## 상세 설명\n  * 단축 URL 정보를 조회합니다.\n","operationId":"getShortUrl","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}},{"name":"linkUrl","in":"query","description":"URL 주소","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SendMessageMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메세지 발송 대상 정보 목록 조회

> &#x20; \## 기능 설명\
> &#x20; \* 메세지 발송 대상 목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 메세지 발송 대상 목록을 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"RealGridListResponseSendMessageMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SendMessageMgmtResponse"}}}},"SendMessageMgmtResponse":{"type":"object","description":"메시지 발송 Response","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"msgTitle":{"type":"string","description":"메시지제목"},"msgConts":{"type":"string","description":"메시지내용"},"msgTypCd":{"type":"string","description":"메시지유형코드"},"msgTypCdNm":{"type":"string","description":"메시지유형명"},"msgSndTypCd":{"type":"string","description":"발송유형코드"},"msgSndTypCdNm":{"type":"string","description":"발송유형명"},"msgSndMethCd":{"type":"string","description":"발송방식코드"},"msgSndMethCdNm":{"type":"string","description":"발송방식명"},"msgSndStatCd":{"type":"string","description":"발송상태코드"},"msgSndStatCdNm":{"type":"string","description":"발송상태명"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송예약일시"},"sndCnt":{"type":"integer","format":"int32","description":"대상 수"},"notSentCnt":{"type":"integer","format":"int32","description":"미발송 수"},"sucsCnt":{"type":"integer","format":"int32","description":"성공 수"},"failCnt":{"type":"integer","format":"int32","description":"실패 수"},"msgSndStrDtm":{"type":"string","format":"date-time","description":"발송시작일시"},"msgSndEndDtm":{"type":"string","format":"date-time","description":"발송종료일시"},"siteNm":{"type":"string","description":"사이트명"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"recvmnVetoNo":{"type":"string","description":"수신자거부번호"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"msgSndSeq":{"type":"string","description":"메시지발송순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"recvmnNo":{"type":"string","description":"수신 번호"},"sendResult":{"type":"string","description":"발송 결과"},"sendResultNm":{"type":"string","description":"발송 결과 명"},"failCaus":{"type":"string","description":"실패 사유"},"shortUrl":{"type":"string","description":"단축 URL"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/sendMessageMgmt/getSendMessageTargetMemberList":{"get":{"tags":["메시지 발송 관리"],"summary":"메세지 발송 대상 정보 목록 조회","description":"  ## 기능 설명\n  * 메세지 발송 대상 목록을 조회합니다.\n  ---\n  ## 상세 설명\n  * 메세지 발송 대상 목록을 조회합니다.\n","operationId":"getSendMessageTargetMemberList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}},{"name":"mbrNo","in":"query","description":"회원번호","schema":{"type":"String"}},{"name":"sndRes","in":"query","description":"발송결과","schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSendMessageMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메세지 발송 정보 목록 조회

> &#x20; \## 기능 설명\
> &#x20; \* 메세지 발송 목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 메세지 발송 목록을 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"RealGridListResponseSendMessageMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SendMessageMgmtResponse"}}}},"SendMessageMgmtResponse":{"type":"object","description":"메시지 발송 Response","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"msgTitle":{"type":"string","description":"메시지제목"},"msgConts":{"type":"string","description":"메시지내용"},"msgTypCd":{"type":"string","description":"메시지유형코드"},"msgTypCdNm":{"type":"string","description":"메시지유형명"},"msgSndTypCd":{"type":"string","description":"발송유형코드"},"msgSndTypCdNm":{"type":"string","description":"발송유형명"},"msgSndMethCd":{"type":"string","description":"발송방식코드"},"msgSndMethCdNm":{"type":"string","description":"발송방식명"},"msgSndStatCd":{"type":"string","description":"발송상태코드"},"msgSndStatCdNm":{"type":"string","description":"발송상태명"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송예약일시"},"sndCnt":{"type":"integer","format":"int32","description":"대상 수"},"notSentCnt":{"type":"integer","format":"int32","description":"미발송 수"},"sucsCnt":{"type":"integer","format":"int32","description":"성공 수"},"failCnt":{"type":"integer","format":"int32","description":"실패 수"},"msgSndStrDtm":{"type":"string","format":"date-time","description":"발송시작일시"},"msgSndEndDtm":{"type":"string","format":"date-time","description":"발송종료일시"},"siteNm":{"type":"string","description":"사이트명"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"recvmnVetoNo":{"type":"string","description":"수신자거부번호"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"msgSndSeq":{"type":"string","description":"메시지발송순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"recvmnNo":{"type":"string","description":"수신 번호"},"sendResult":{"type":"string","description":"발송 결과"},"sendResultNm":{"type":"string","description":"발송 결과 명"},"failCaus":{"type":"string","description":"실패 사유"},"shortUrl":{"type":"string","description":"단축 URL"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/sendMessageMgmt/getSendMessageList":{"get":{"tags":["메시지 발송 관리"],"summary":"메세지 발송 정보 목록 조회","description":"  ## 기능 설명\n  * 메세지 발송 목록을 조회합니다.\n  ---\n  ## 상세 설명\n  * 메세지 발송 목록을 조회합니다.\n","operationId":"getSendMessageList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}},{"name":"searchPeriod","in":"query","description":"조회기간 타입","schema":{"type":"String"}},{"name":"sndStrDtm","in":"query","description":"조회기간 시작일","schema":{"type":"LocalDate"}},{"name":"sndEndDtm","in":"query","description":"조회기간 종료일","schema":{"type":"LocalDate"}},{"name":"msgSndMethCd","in":"query","description":"발송 방식(CM019)","schema":{"type":"String"}},{"name":"searchCondition","in":"query","description":"조회 조건(메시지 내용/번호)","schema":{"type":"String"}},{"name":"searchConditionContents","in":"query","description":"조회조건내용","schema":{"type":"String"}},{"name":"msgSndStatCd","in":"query","description":"발송 상태(CM018)","schema":{"type":"String"}},{"name":"msgTypCd","in":"query","description":"메시지 유형(CM021)","schema":{"type":"String"}},{"name":"msgSndTypCd","in":"query","description":"발송 유형(CM020)","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트 번호","schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSendMessageMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 메세지 기본 정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 메세지 기본 정보를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 메세지 기본 정보를 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SendMessageMgmtRequest":{"type":"object","description":"메시지 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date","description":"조회기간 종료일"},"msgSndMethCd":{"type":"string","description":"발송 방식(CM019)"},"searchCondition":{"type":"string","description":"조회 조건(메시지 내용/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"msgSndStatCd":{"type":"string","description":"발송 상태(CM018)"},"msgTypCd":{"type":"string","description":"메시지 유형(CM021)"},"msgSndTypCd":{"type":"string","description":"발송 유형(CM020)"},"sndRes":{"type":"string","description":"발송결과"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"msgTitle":{"type":"string","description":"메시지 제목"},"msgConts":{"type":"string","description":"메시지 내용"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"recvmnNo":{"type":"string","description":"휴대폰 번호"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrCellNo":{"type":"string","description":"휴대폰 번호"},"mbrStatCd":{"type":"string","description":"회원상태"},"smsRecvAgrYn":{"type":"string","description":"sms 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationMsgCnt":{"type":"integer","format":"int32","description":"메시지 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"linkUrl":{"type":"string","description":"URL 주소"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"SendMessageMgmtResponse":{"type":"object","description":"메시지 발송 Response","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"msgSndNo":{"type":"string","description":"메시지번호"},"msgTitle":{"type":"string","description":"메시지제목"},"msgConts":{"type":"string","description":"메시지내용"},"msgTypCd":{"type":"string","description":"메시지유형코드"},"msgTypCdNm":{"type":"string","description":"메시지유형명"},"msgSndTypCd":{"type":"string","description":"발송유형코드"},"msgSndTypCdNm":{"type":"string","description":"발송유형명"},"msgSndMethCd":{"type":"string","description":"발송방식코드"},"msgSndMethCdNm":{"type":"string","description":"발송방식명"},"msgSndStatCd":{"type":"string","description":"발송상태코드"},"msgSndStatCdNm":{"type":"string","description":"발송상태명"},"msgSndRsvDtm":{"type":"string","format":"date-time","description":"발송예약일시"},"sndCnt":{"type":"integer","format":"int32","description":"대상 수"},"notSentCnt":{"type":"integer","format":"int32","description":"미발송 수"},"sucsCnt":{"type":"integer","format":"int32","description":"성공 수"},"failCnt":{"type":"integer","format":"int32","description":"실패 수"},"msgSndStrDtm":{"type":"string","format":"date-time","description":"발송시작일시"},"msgSndEndDtm":{"type":"string","format":"date-time","description":"발송종료일시"},"siteNm":{"type":"string","description":"사이트명"},"recvmnVetoNoCd":{"type":"string","description":"수신자거부번호 코드"},"recvmnVetoNo":{"type":"string","description":"수신자거부번호"},"msgImgPathNm":{"type":"string","description":"메시지 이미지 경로명"},"msgImgFileNm":{"type":"string","description":"메시지 이미지 파일명"},"msgSndSeq":{"type":"string","description":"메시지발송순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"recvmnNo":{"type":"string","description":"수신 번호"},"sendResult":{"type":"string","description":"발송 결과"},"sendResultNm":{"type":"string","description":"발송 결과 명"},"failCaus":{"type":"string","description":"실패 사유"},"shortUrl":{"type":"string","description":"단축 URL"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/sendMessageMgmt/getSendMessageBaseInfo":{"get":{"tags":["메시지 발송 관리"],"summary":"메세지 기본 정보 조회","description":"  ## 기능 설명\n  * 메세지 기본 정보를 조회합니다.\n  ---\n  ## 상세 설명\n  * 메세지 기본 정보를 조회합니다.\n","operationId":"getSendMessageBaseInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SendMessageMgmtRequest"}},{"name":"msgSndNo","in":"query","description":"메시지 번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SendMessageMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 신규 메세지 번호 채번

> &#x20; \## 기능 설명\
> &#x20; \* 신규 메세지 번호를 채번합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 신규 메세지 번호를 채번합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/system/sendMessageMgmt/getNextMsgSndNo":{"get":{"tags":["메시지 발송 관리"],"summary":"신규 메세지 번호 채번","description":"  ## 기능 설명\n  * 신규 메세지 번호를 채번합니다.\n  ---\n  ## 상세 설명\n  * 신규 메세지 번호를 채번합니다.\n","operationId":"getNextMsgSndNo","responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
