> 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/store-front-api/common-api/undefined.md).

# 알림메시지

## 알림메시지 단건 전송

> &#x20;         \## 기능설명\
> &#x20;         \* 알림메시지를 전송합니다.\
> &#x20;         \---\
> &#x20;         \## 상세설명\
> &#x20;         \* 전송할 메시지 템플릿의 변수를 담은 dto에 MessageCommonDto 클래스를 상속해 필수정보를 담아줘야합니다.\
> &#x20;         \* langCd를 보내지 않으면 쿠키 값의 langCd 기준으로 템플릿을 조회합니다.\
> &#x20;         \* 템플릿ID에 일치하는 템플릿이 존재하지 않을 시 전송 불가합니다.\
> &#x20;         \* 공통코드 ST010에 포함되어있는 템플릿의 변수는 자동으로 입력됩니다.\
> &#x20;         \* 90 bytes 이상 메시지에 대해 SMS 전송 시 LMS로 전송됩니다.\
> &#x20;         \* 알림메시지 유형별 필수 파라미터\
> &#x20;            \* 알림톡: 템플릿ID(tmplId), 수신번호(rcvgTlphNo)\
> &#x20;            \* SMS: 템플릿ID(tmplId), 수신번호(rcvgTlphNo)\
> &#x20;            \* 알림함: 템플릿ID(tmplId), 회원번호(mbrNo)\
> \---\
> &#x20;         \## 수정번호\
> &#x20;         \* \`\`\`Release v1.01\_231010\`\`\`: 90bytes 이상 SMS 전송 시 LMS로 변경\
> &#x20;         \* \`\`\`Release v2.00\_240425\`\`\`: 멀티 사이트 확장에 따라, 템플릿 조회 시 사이트 조건 추가<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Common API","version":"v1"},"servers":[{"url":"https://api-common.x2bee.com/api/common/","description":"prd"}],"paths":{"/v1/common/sendMessage":{"post":{"tags":["알림메시지"],"summary":"알림메시지 단건 전송","description":"          ## 기능설명\n          * 알림메시지를 전송합니다.\n          ---\n          ## 상세설명\n          * 전송할 메시지 템플릿의 변수를 담은 dto에 MessageCommonDto 클래스를 상속해 필수정보를 담아줘야합니다.\n          * langCd를 보내지 않으면 쿠키 값의 langCd 기준으로 템플릿을 조회합니다.\n          * 템플릿ID에 일치하는 템플릿이 존재하지 않을 시 전송 불가합니다.\n          * 공통코드 ST010에 포함되어있는 템플릿의 변수는 자동으로 입력됩니다.\n          * 90 bytes 이상 메시지에 대해 SMS 전송 시 LMS로 전송됩니다.\n          * 알림메시지 유형별 필수 파라미터\n             * 알림톡: 템플릿ID(tmplId), 수신번호(rcvgTlphNo)\n             * SMS: 템플릿ID(tmplId), 수신번호(rcvgTlphNo)\n             * 알림함: 템플릿ID(tmplId), 회원번호(mbrNo)\n---\n          ## 수정번호\n          * ```Release v1.01_231010```: 90bytes 이상 SMS 전송 시 LMS로 변경\n          * ```Release v2.00_240425```: 멀티 사이트 확장에 따라, 템플릿 조회 시 사이트 조건 추가\n","operationId":"sendMessage","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"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"}}}}}}
````

## 알림메시지 다건 전송

> \## 기능설명\
> \* 알림메시지를 다건으로 전송합니다.\
> \---\
> \## 상세설명\
> \* 전송할 메시지 템플릿의 변수를 담은 dto에 MessageCommonDto 클래스를 상속해 필수정보를 담아줘야합니다.\
> \* langCd를 보내지 않으면 쿠키 값의 langCd 기준으로 템플릿을 조회합니다.\
> \* 템플릿ID에 일치하는 템플릿이 존재하지 않을 시 전송 불가합니다.\
> \* 공통코드 ST010에 포함되어있는 템플릿의 변수는 자동으로 입력됩니다.\
> \* 90 bytes 이상 메시지에 대해 SMS 전송 시 LMS로 전송됩니다.\
> \* 알림메시지 유형별 필수 파라미터\
> &#x20;  \* 알림톡: 템플릿ID(tmplId), 수신번호(rcvgTlphNo)\
> &#x20;  \* SMS: 템플릿ID(tmplId), 수신번호(rcvgTlphNo)\
> &#x20;  \* 알림함: 템플릿ID(tmplId), 회원번호(mbrNo)\
> \---\
> \## 수정번호\
> \* \`\`\`Release v1.01\_231010\`\`\`: 90bytes 이상 SMS 전송 시 LMS로 변경\
> \* \`\`\`Release v2.00\_240425\`\`\`: 멀티 사이트 확장에 따라, 템플릿 조회 시 사이트 조건 추가<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Common API","version":"v1"},"servers":[{"url":"https://api-common.x2bee.com/api/common/","description":"prd"}],"paths":{"/v1/common/sendMessageList":{"post":{"tags":["알림메시지"],"summary":"알림메시지 다건 전송","description":"## 기능설명\n* 알림메시지를 다건으로 전송합니다.\n---\n## 상세설명\n* 전송할 메시지 템플릿의 변수를 담은 dto에 MessageCommonDto 클래스를 상속해 필수정보를 담아줘야합니다.\n* langCd를 보내지 않으면 쿠키 값의 langCd 기준으로 템플릿을 조회합니다.\n* 템플릿ID에 일치하는 템플릿이 존재하지 않을 시 전송 불가합니다.\n* 공통코드 ST010에 포함되어있는 템플릿의 변수는 자동으로 입력됩니다.\n* 90 bytes 이상 메시지에 대해 SMS 전송 시 LMS로 전송됩니다.\n* 알림메시지 유형별 필수 파라미터\n   * 알림톡: 템플릿ID(tmplId), 수신번호(rcvgTlphNo)\n   * SMS: 템플릿ID(tmplId), 수신번호(rcvgTlphNo)\n   * 알림함: 템플릿ID(tmplId), 회원번호(mbrNo)\n---\n## 수정번호\n* ```Release v1.01_231010```: 90bytes 이상 SMS 전송 시 LMS로 변경\n* ```Release v2.00_240425```: 멀티 사이트 확장에 따라, 템플릿 조회 시 사이트 조건 추가\n","operationId":"sendMessageList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{}}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"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"}}}}}}
````
