메시지 발송
작성일 2026.02.27 | 수정일 2026.02.27
POST
/messages/v4/send-many/detail하나 이상의 메시지를 발송하는 API입니다. 만 건을 초과하는 메시지 발송이 필요한 경우 TODO 그룹 메시지 API를 사용하는 것을 권장합니다.
lightbulb
메시지 타입별 비교
자동 타입 감지
messages[].autoTypeDetect 필드가 true(기본값)일 때, 시스템이 자동으로 메시지 타입을 결정합니다.
lightbulb
messages[].type 필드를 명시적으로 지정하면 autoTypeDetect를 무시하고 해당 타입으로 발송합니다.
Body Params
Structures
Request Structure
{
"messages": [
{
"to": "string",
"from": "string",
"text": "string",
"type": "string",
"country": "string",
"subject": "string",
"imageId": "string",
"kakaoOptions": {
"pfId": "string",
"templateId": "string",
"senderKey": "string",
"title": "string",
"adFlag": "boolean",
"templateCode": "string",
"buttonName": "string",
"buttonUrl": "string",
"disableSms": "boolean",
"imageId": "string",
"variables": {
"#{홍길동}": "string",
"#{010-0000-0000}": "string",
"#{2021년 6월 17일}": "string"
},
"quickReplies": [
{
"name": "string",
"linkType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string",
"chatExtra": "string",
"targetOut": "boolean"
}
],
"highlight": {
"title": "string"
},
"header": "string",
"item": {
"list": [
{
"description": "string"
}
],
"summary": {
"description": "string"
}
},
"buttons": [
{
"buttonName": "string",
"buttonType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string",
"chatExtra": "string",
"targetOut": "boolean"
}
],
"bms": {
"targeting": "string",
"chatBubbleType": "string",
"adult": "boolean",
"header": "string",
"imageId": "string",
"imageLink": "string",
"additionalContent": "string",
"content": "string",
"carousel": {},
"mainWideItem": {},
"subWideItemList": {},
"buttons": {},
"coupon": {},
"commerce": {},
"video": {}
}
},
"naverOptions": {
"talkId": "string",
"templateId": "string",
"disableSms": "boolean",
"variables": {
"#{홍길동}": "string",
"#{010-0000-0000}": "string",
"#{2021년 6월 17일}": "string"
},
"buttons": [
{
"buttonCode": "string",
"buttonName": "string",
"buttonType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string"
}
]
},
"rcsOptions": {
"brandId": "string",
"templateId": "string",
"copyAllowed": "boolean",
"variables": {
"{{홍길동}}": "string",
"{{010-0000-0000}}": "string",
"{{2021년 6월 17일}}": "string"
},
"mmsType": "string",
"commercialType": "boolean",
"disableSms": "boolean",
"additionalBody": [
{
"title": "string",
"description": "string",
"imageId": "string",
"buttons": [
{
"buttonType": "string",
"buttonName": "string",
"link": "string",
"latitude": "string",
"longitude": "string",
"label": "string",
"query": "string",
"title": "string",
"startTime": "date",
"endTime": "date",
"text": "string",
"phone": "string"
}
]
}
],
"buttons": [
{
"buttonType": "string",
"buttonName": "string",
"link": "string",
"latitude": "string",
"longitude": "string",
"label": "string",
"query": "string",
"title": "string",
"startTime": "date",
"endTime": "date",
"text": "string",
"phone": "string"
}
]
},
"faxOptions": {
"fileIds": [
{}
]
},
"voiceOptions": {
"voiceType": "string",
"headerMessage": "string",
"tailMessage": "string",
"replyRange": "number",
"counselorNumber": "string",
"variables": {}
},
"customFields": {
"key": "string"
},
"autoTypeDetect": "boolean",
"hint": {},
"replacements": [
{
"to": "string",
"from": "string",
"text": "string",
"customFields": {
"key": "string"
}
}
]
}
],
"scheduledDate": "date",
"strict": "boolean",
"agent": {
"appId": "string",
"osPlatform": "string",
"sdkVersion": "string"
},
"allowDuplicates": "boolean",
"showMessageList": "string"
}
Response Structure
{
"failedMessageList": [
{
"to": "string",
"from": "string",
"type": "string",
"country": "string",
"messageId": "string",
"statusCode": "string",
"statusMessage": "string",
"accountId": "string"
}
],
"groupInfo": {
"count": {
"total": "number",
"sentTotal": "number",
"sentFailed": "number",
"sentSuccess": "number",
"sentPending": "number",
"sentReplacement": "number",
"refund": "number",
"registeredFailed": "number",
"registeredSuccess": "number"
},
"countForCharge": {
"sms": {
"82": "number",
"101": "number"
},
"lms": {
"82": "number",
"101": "number"
},
"mms": {
"82": "number",
"101": "number"
},
"ata": {
"82": "number",
"101": "number"
},
"cta": {
"82": "number",
"101": "number"
},
"cti": {
"82": "number",
"101": "number"
},
"nsa": {
"82": "number",
"101": "number"
},
"rcs_sms": {
"82": "number",
"101": "number"
},
"rcs_lms": {
"82": "number",
"101": "number"
},
"rcs_mms": {
"82": "number",
"101": "number"
},
"rcs_tpl": {
"82": "number",
"101": "number"
},
"rcs_itpl": {
"82": "number",
"101": "number"
},
"rcs_ltpl": {
"82": "number",
"101": "number"
},
"fax": {
"82": "number",
"101": "number"
},
"voice": {
"82": "number",
"101": "number"
},
"bms_text": {
"82": "number",
"101": "number"
},
"bms_image": {
"82": "number",
"101": "number"
},
"bms_wide": {
"82": "number",
"101": "number"
},
"bms_wide_item_list": {
"82": "number",
"101": "number"
},
"bms_carousel_feed": {
"82": "number",
"101": "number"
},
"bms_premium_video": {
"82": "number",
"101": "number"
},
"bms_commerce": {
"82": "number",
"101": "number"
},
"bms_carousel_commerce": {
"82": "number",
"101": "number"
},
"bms_free": {
"82": "number",
"101": "number"
}
},
"balance": {
"requested": "number",
"replacement": "number",
"additional": "number",
"refund": "number",
"sum": "number"
},
"point": {
"requested": "number",
"replacement": "number",
"additional": "number",
"refund": "number",
"sum": "number"
},
"app": {
"profit": {
"sms": "number",
"lms": "number",
"mms": "number",
"ata": "number",
"cta": "number",
"cti": "number",
"nsa": "number",
"rcs_sms": "number",
"rcs_lms": "number",
"rcs_mms": "number",
"rcs_tpl": "number",
"rcs_itpl": "number",
"rcs_ltpl": "number",
"fax": "number",
"voice": "number",
"bms_text": "number",
"bms_image": "number",
"bms_wide": "number",
"bms_wide_item_list": "number",
"bms_carousel_feed": "number",
"bms_premium_video": "number",
"bms_commerce": "number",
"bms_carousel_commerce": "number",
"bms_free": "number"
},
"app": "string",
"version": "string"
},
"serviceMethod": "string",
"sdkVersion": "string",
"osPlatform": "string",
"log": [
{
"createAt": "date",
"message": "string",
"oldBalance": "number",
"newBalance": "number",
"oldPoint": "number",
"newPoint": "number",
"totalPrice": "number"
}
],
"status": "string",
"dateSent": "date",
"scheduledDate": "date",
"dateCompleted": "date",
"isRefunded": "boolean",
"flagUpdated": "boolean",
"prepaid": "boolean",
"strict": "boolean",
"masterAccountId": "string",
"allowDuplicates": "boolean",
"_id": "string",
"accountId": "string",
"apiVersion": "string",
"customFields": {
"key": "string"
},
"hint": "string",
"groupId": "string",
"price": {
"82": {
"sms": "number",
"lms": "number",
"mms": "number",
"ata": "number",
"cta": "number",
"cti": "number",
"nsa": "number",
"rcs_sms": "number",
"rcs_lms": "number",
"rcs_mms": "number",
"rcs_tpl": "number",
"rcs_itpl": "number",
"rcs_ltpl": "number",
"fax": "number",
"voice": "number",
"bms_text": "number",
"bms_image": "number",
"bms_wide": "number",
"bms_wide_item_list": "number",
"bms_carousel_feed": "number",
"bms_premium_video": "number",
"bms_commerce": "number",
"bms_carousel_commerce": "number",
"bms_free": "number"
}
},
"dateCreated": "date",
"dateUpdated": "date"
}
}