Kakao
카카오 메시지 발송 상세 조회
카카오톡 메시지 발송 그룹의 상세 정보를 조회합니다. 발송 상태, 성공/실패 건수, 포인트 사용 내역 등을 확인할 수 있습니다.
get/v2/messages/kakao/groups/{groupId}
Path parameters
groupIdstring required
Example:12345678-90ab-4567-8901-234567890abc
조회할 메시지 그룹의 ID입니다. 메시지 발송 시 반환받은 UUID 형식의 그룹 ID를 사용하세요.
Response
메시지 그룹 상세 조회 요청의 처리 결과입니다. 그룹의 발송 상태와 통계 정보가 포함됩니다.
Example response
{
"code": 200,
"message": "성공",
"data": {
"userId": 12345,
"profileId": "profile_abc123",
"groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111",
"message": "안녕하세요 고객님, 주문이 완료되었습니다.",
"messageType": "AT",
"requestDomain": "api.example.com",
"senderNumber": "01011112222",
"reservedStatus": "COMPLETED",
"groupStatus": "COMPLETED",
"countRequest": 1000,
"messageCount": 950,
"succeededCount": 900,
"failedCount": 30,
"canceledCount": 20,
"fallbackCount": 25,
"unitCost": 15,
"vatPoint": 150,
"totalPoint": 1650,
"refundPoint": 450,
"fallback": {
"type": "LMS",
"senderNumber": "01011112222",
"message": "주문이 완료되었습니다. 자세한 내용은 앱을 확인해주세요.",
"title": "주문 완료 알림",
"images": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"groupId": "004a6217-f06c-40f6-8f39-bf35b3f76222"
},
"messageContents": {
"AT": {
"body": "고객님의 주문이 완료되었습니다. 배송 준비 중입니다.",
"buttons": [
{
"name": "자세히 보기",
"linkMobile": "https://example.com/mobile",
"linkPc": "https://example.com/pc",
"schemeIos": "myapp://product/123",
"schemeAndroid": "myapp://product/123"
}
],
"templateId": "template_123456",
"templateCode": "TempCode001",
"templateExtra": "특별 이벤트 알림"
},
"AE": {
"body": "[중요] 고객님의 주문이 완료되었습니다. 배송 준비 중입니다.",
"buttons": [
{
"name": "자세히 보기",
"linkMobile": "https://example.com/mobile",
"linkPc": "https://example.com/pc",
"schemeIos": "myapp://product/123",
"schemeAndroid": "myapp://product/123"
}
],
"templateId": "template_emphasis_123456",
"templateCode": "EmpCode001",
"templateExtra": "긴급 알림",
"templateTitle": "주문 완료 안내",
"templateSubtitle": "배송 정보를 확인해주세요"
},
"AI": {
"body": "고객님의 주문이 완료되었습니다. 상품 이미지를 확인해보세요.",
"buttons": [
{
"name": "자세히 보기",
"linkMobile": "https://example.com/mobile",
"linkPc": "https://example.com/pc",
"schemeIos": "myapp://product/123",
"schemeAndroid": "myapp://product/123"
}
],
"templateId": "template_image_123456",
"templateCode": "ImgCode001",
"templateExtra": "신상품 안내",
"templateImageUrl": "https://example.com/product_image.jpg"
},
"FT": {
"body": "안녕하세요! 새로운 소식을 전해드립니다.",
"messageType": "FT",
"buttons": [
{
"name": "자세히 보기",
"linkMobile": "https://example.com/mobile",
"linkPc": "https://example.com/pc",
"schemeIos": "myapp://product/123",
"schemeAndroid": "myapp://product/123"
}
]
},
"FI": {
"body": "새로운 상품을 소개합니다! 이미지를 확인해보세요.",
"buttons": [
{
"name": "자세히 보기",
"linkMobile": "https://example.com/mobile",
"linkPc": "https://example.com/pc",
"schemeIos": "myapp://product/123",
"schemeAndroid": "myapp://product/123"
}
],
"imageUrl": "https://example.com/friend_image.jpg"
},
"FW": {
"body": "특별한 이벤트를 소개합니다! 와이드 이미지로 더 생생하게 확인하세요.",
"buttons": [
{
"name": "자세히 보기",
"linkMobile": "https://example.com/mobile",
"linkPc": "https://example.com/pc",
"schemeIos": "myapp://product/123",
"schemeAndroid": "myapp://product/123"
}
],
"imageUrl": "https://example.com/wide_image.jpg"
}
},
"isUseApi": true,
"createdAt": "2024-01-15T09:00:00Z",
"updatedAt": "2024-01-15T10:30:00Z"
}
}