본문으로 건너뛰기

그룹 메시지 추가

PUT
/messages/v4/groups/:groupId/messages
:groupId메시지 그룹 아이디


그룹에 메시지를 추가합니다. 접수 실패건은 저장되지만 발송은 되지 않습니다.

그룹메시지 추가 API에 다음 3가지 제한사항이 있습니다.

  • 하나의 요청의 총 데이터 크기는 15MB를 넘을 수 없습니다.
  • 하나의 요청에 수신번호는 10,000 개를 넘을 수 없습니다.
  • 하나의 그룹에 담을 수 있는 메시지는 1,000,000 개 제한입니다.

홈페이지의 문자발송 내역에서 전송결과 내역을 확인하실 수 있습니다. (로그인 필요)

전송 내역(메시지 그룹, 메시지 목록)의 보관기간은 생성일 기준 6개월 입니다. 6개월이 지난 내역은 조회가 불가능합니다.

Body Params

NameTypeRequiredDescription
messages
Array<Object>
O
발송할 메시지 내용

Response

NameTypeShould ReturnDescription
errorCount
number
-
접수 실패 카운트
resultList
Array<Object>
-
모든 메시지의 접수 결과 목록

Structures

{1 properties
"messages":
[1 items...]
{15 properties...}
"to": "string",
"from": "string",
"text": "string",
"type": "string",
"country": "string",
"subject": "string",
"imageId": "string",
"kakaoOptions":
{17 properties...}
"pfId": "string",
"templateId": "string",
"senderKey": "string",
"title": "string",
"adFlag": "boolean",
"templateCode": "string",
"buttonName": "string",
"buttonUrl": "string",
"disableSms": "boolean",
"imageId": "string",
"variables":
{
}
,
"quickReplies":
[1 items...]
{8 properties...}
"name": "string",
"linkType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string",
"chatExtra": "string",
"targetOut": "boolean"
}
]
,
"highlight":
{
}
,
"header": "string",
"item":
{
}
,
"buttons":
[1 items...]
{8 properties...}
"buttonName": "string",
"buttonType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string",
"chatExtra": "string",
"targetOut": "boolean"
}
]
,
"bms":
{1 properties...}
"targeting": "string"
}
}
,
"naverOptions":
{5 properties...}
"talkId": "string",
"templateId": "string",
"disableSms": "boolean",
"variables":
{
}
,
"buttons":
[1 items...]
{7 properties...}
"buttonCode": "string",
"buttonName": "string",
"buttonType": "string",
"linkMo": "string",
"linkPc": "string",
"linkAnd": "string",
"linkIos": "string"
}
]
}
,
"rcsOptions":
{9 properties...}
"brandId": "string",
"templateId": "string",
"copyAllowed": "boolean",
"variables":
{
}
,
"mmsType": "string",
"commercialType": "boolean",
"disableSms": "boolean",
"additionalBody":
[1 items...]
{4 properties...}
"title": "string",
"description": "string",
"imageId": "string",
"buttons":
[1 items...]
{12 properties...}
"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":
[1 items...]
{12 properties...}
"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":
{1 properties...}
"fileIds":
[1 items...]
{
}
]
}
,
"voiceOptions":
{6 properties...}
"voiceType": "string",
"headerMessage": "string",
"tailMessage": "string",
"replyRange": "number",
"counselorNumber": "string",
"variables":
{
}
}
,
"customFields":
{
}
,
"autoTypeDetect": "boolean",
"hint":
{
}
}
]
}
{2 properties
"errorCount": "number",
"resultList":
[1 items...]
{8 properties...}
"to": "string",
"from": "string",
"type": "string",
"country": "string",
"messageId": "string",
"statusCode": "string",
"statusMessage": "string",
"accountId": "string"
}
]
}