# 메시지 발송 관리

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

>   \## 기능 설명\
>   \* 메세지 정보를 검증합니다.\
>   \---\
>   \## 상세 설명\
>   \* 메세지 정보를 검증합니다.\
> &#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"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api/back-office-api/system-bo-api/undefined-15.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.