# 알림메시지

## 알림메시지 단건 전송

> &#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"}}}}}}
````


---

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