--- title: "카카오 메시지 발송 상세 조회" method: GET path: "/v2/messages/kakao/groups/{groupId}" tags: ["Kakao"] --- # 카카오 메시지 발송 상세 조회 `GET /v2/messages/kakao/groups/{groupId}` 카카오톡 메시지 발송 그룹의 상세 정보를 조회합니다. 발송 상태, 성공/실패 건수, 포인트 사용 내역 등을 확인할 수 있습니다. ## Path parameters - `groupId` string, required ## Response `200` 메시지 그룹 상세 조회 요청의 처리 결과입니다. 그룹의 발송 상태와 통계 정보가 포함됩니다. - object — 메시지 그룹 상세 조회 요청의 처리 결과입니다. 그룹의 발송 상태와 통계 정보가 포함됩니다. - `code` number — 응답 코드 - `message` string — 응답 메시지 - `data` object, required — 카카오톡 메시지 그룹의 상세 정보를 담은 스키마입니다. 발송 현황, 비용 정보, 메시지 내용 등이 포함됩니다. - `userId` number, required — 메시지를 발송한 사용자 ID입니다. - `profileId` string, required — 카카오 채널(발신프로필) ID입니다. 메시지 발송에 사용된 채널을 나타냅니다. - `groupId` string, required — 메시지 그룹 ID입니다. 동일한 발송 요청에 포함된 모든 메시지들을 그룹화하는 UUID 형식의 ID입니다. - `message` string, required — 발송된 메시지의 내용입니다. 실제 수신자에게 전달된 텍스트 내용을 나타냅니다. - `messageType` 'AT' | 'AI' | 'AE' | 'BMT' | 'BMI' | 'BMW' | 'BMWL' | 'BMCF' | 'FT' | 'FI' | 'FW', required — 발송된 메시지의 타입입니다. 알림톡, 친구톡, 브랜드메시지 등 다양한 카카오톡 메시지 유형을 나타냅니다. - `requestDomain` string, required — 메시지 발송을 요청한 도메인입니다. API 호출이 발생한 서버의 도메인 정보입니다. - `senderNumber` string, required — 메시지 발송에 사용된 발신 번호입니다. 카카오톡의 경우 채널을 최초 등록한 계정의 전화번호입니다. - `reservedStatus` 'RESERVED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED', nullable, required — 예약 발송의 현재 상태입니다. null인 경우 즉시 발송되었으며, 값이 있으면 예약 발송 상태를 나타냅니다. - `groupStatus` 'RESERVED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED', required — 메시지 그룹 전체의 발송 상태입니다. 그룹 내 모든 메시지의 처리 결과를 종합한 상태입니다. - `countRequest` number, required — 발송 요청된 총 메시지 수입니다. 중복된 전화번호도 포함하여 계산된 전체 요청 건수입니다. - `messageCount` number, required — 실제로 처리된 메시지의 총 개수입니다. 중복 제거 및 유효성 검사를 거친 실제 발송 대상 메시지 수입니다. - `standbyCount` number, required — 발송 대기 중인 메시지의 수입니다. 아직 통신사로 전송되지 않고 대기열에 있는 메시지 수입니다. - `sendingCount` number, required — 현재 발송 중인 메시지의 수입니다. 통신사로 전송되었지만 아직 최종 결과가 나오지 않은 메시지 수입니다. - `succeededCount` number, required — 성공적으로 발송 완료된 메시지의 수입니다. 수신자에게 정상적으로 전달된 메시지 개수입니다. - `failedCount` number, required — 발송에 실패한 메시지의 수입니다. 네트워크 오류, 잘못된 번호 등으로 전달되지 못한 메시지 수입니다. - `canceledCount` number, required — 사용자가 직접 취소한 메시지의 수입니다. 예약 발송 중 취소 요청으로 발송되지 않은 메시지 수입니다. - `fallbackCount` number, required — 카카오톡 발송 실패로 SMS/LMS/MMS로 대체 발송된 메시지의 수입니다. - `unitCost` number, required — 메시지 발송에 적용된 단위 비용입니다. 메시지 타입별로 책정된 건당 발송 비용을 나타냅니다. - `vatPoint` number, required — 메시지 발송으로 차감된 부가세(VAT) 포인트입니다. 전체 사용 포인트에서 부가세에 해당하는 금액입니다. - `totalPoint` number, required — 메시지 발송으로 차감된 총 포인트입니다. 부가세(VAT)가 포함된 최종 차감 포인트 금액입니다. - `refundPoint` number, required — 발송 취소나 실패로 환급된 포인트 총액입니다. 부가세(VAT)가 포함된 최종 환급 포인트 금액입니다. - `fallback` object — 카카오톡 메시지 발송 실패 시 대체로 발송된 SMS/LMS/MMS의 상세 정보입니다. 대체 발송이 없으면 이 필드는 없습니다. - `type` 'SMS' | 'LMS' | 'MMS', required — 카카오톡 발송 실패 시 대체로 발송된 메시지의 유형입니다. SMS는 단문, LMS는 장문, MMS는 멀티미디어 메시지입니다. - `isAd` boolean, required — 대체 발송 메시지가 광고성 메시지인지 여부입니다. true인 경우 광고성 메시지로 분류됩니다. - `senderNumber` string, required — 대체 발송에 사용된 발신자 전화번호입니다. SMS/LMS/MMS 발송 시 표시되는 번호입니다. - `message` string, required — 대체 발송된 메시지의 내용입니다. 카카오톡 발송 실패 시 SMS/LMS/MMS로 전송된 텍스트입니다. - `title` string, nullable, required — 대체 발송 메시지의 제목입니다. LMS나 MMS 발송 시에만 사용됩니다. - `images` string[], nullable, required — MMS 대체 발송 시 첨부된 이미지들의 URL 배열입니다. - `groupId` string, nullable, required — 카카오톡 메시지 발송 실패 시 대체 발송된 SMS/LMS 메시지의 그룹 ID입니다. - `messageContents` object, required — 발송된 메시지의 상세 내용 정보입니다. 메시지 타입에 따라 알림톡, 친구톡 등의 세부 정보가 포함됩니다. - `messageType` 'AT' | 'AI' | 'AE' | 'FT' | 'FI' | 'FW' | 'BMT' | 'BMI' | 'BMW' | 'BMWL' | 'BMCF', required — 발송된 메시지의 타입입니다. 알림톡, 브랜드메시지, 친구톡(deprecated) 등 다양한 카카오톡 메시지 유형을 나타냅니다. - `AT` object — 알림톡 정보 - `body` string, required — 알림톡 메시지의 본문 내용입니다. 실제 발송된 텍스트 메시지 내용을 나타냅니다. - `buttons` object[], required — 알림톡에 포함된 버튼들의 정보입니다. 사용자 액션을 유도하는 버튼 목록과 링크 정보가 포함됩니다. - `name` string, required — 버튼에 표시될 텍스트입니다. 사용자에게 보여지는 버튼명입니다. - `linkMobile` string — 모바일 환경에서 버튼 클릭 시 이동할 URL입니다. 웹 링크나 딥 링크를 설정할 수 있습니다. - `linkPc` string — PC 환경에서 버튼 클릭 시 이동할 URL입니다. 데스크톱 브라우저에서 열릴 링크를 설정합니다. - `schemeIos` string — iOS 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `schemeAndroid` string — Android 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `templateId` string, required — 알림톡 발송에 사용된 템플릿 ID입니다. - `templateCode` string, required — 알림톡 템플릿의 코드입니다. 템플릿 생성 시 확인 가능하며 템플릿 조회 API로도 확인할 수 있습니다. - `templateExtra` string — 알림톡 템플릿에 포함된 추가 정보입니다. 템플릿에 설정된 부가 정보나 메모 사항이 포함됩니다. - `AE` object — 알림톡 강조형 정보 - `body` string, required — 알림톡 강조형 메시지의 본문 내용입니다. 강조 표시가 적용된 알림톡의 텍스트 메시지입니다. - `buttons` object[], required — 알림톡 강조형에 포함된 버튼들의 정보입니다. 사용자 액션을 유도하는 버튼 목록과 링크 정보가 포함됩니다. - `name` string, required — 버튼에 표시될 텍스트입니다. 사용자에게 보여지는 버튼명입니다. - `linkMobile` string — 모바일 환경에서 버튼 클릭 시 이동할 URL입니다. 웹 링크나 딥 링크를 설정할 수 있습니다. - `linkPc` string — PC 환경에서 버튼 클릭 시 이동할 URL입니다. 데스크톱 브라우저에서 열릴 링크를 설정합니다. - `schemeIos` string — iOS 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `schemeAndroid` string — Android 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `templateId` string, required — 알림톡 강조형 발송에 사용된 템플릿 ID입니다. - `templateCode` string, required — 알림톡 강조형 템플릿의 코드입니다. 템플릿 생성 시 확인 가능하며 템플릿 조회 API로도 확인할 수 있습니다. - `templateExtra` string — 알림톡 강조형 템플릿에 포함된 추가 정보입니다. 템플릿에 설정된 부가 정보나 메모 사항이 포함됩니다. - `templateTitle` string — 알림톡 강조형의 제목입니다. 메시지 상단에 표시되는 대표 제목으로 강조 표시됩니다. - `templateSubtitle` string — 알림톡 강조형의 부제목입니다. 제목과 함께 메시지의 내용을 더 자세히 설명하는 보조 제목입니다. - `AI` object — 알림톡 이미지형 정보 - `body` string, required — 알림톡 이미지형 메시지의 본문 내용입니다. 이미지와 함께 표시되는 텍스트 메시지입니다. - `buttons` object[], required — 알림톡 이미지형에 포함된 버튼들의 정보입니다. 사용자 액션을 유도하는 버튼 목록과 링크 정보가 포함됩니다. - `name` string, required — 버튼에 표시될 텍스트입니다. 사용자에게 보여지는 버튼명입니다. - `linkMobile` string — 모바일 환경에서 버튼 클릭 시 이동할 URL입니다. 웹 링크나 딥 링크를 설정할 수 있습니다. - `linkPc` string — PC 환경에서 버튼 클릭 시 이동할 URL입니다. 데스크톱 브라우저에서 열릴 링크를 설정합니다. - `schemeIos` string — iOS 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `schemeAndroid` string — Android 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `templateId` string, required — 알림톡 이미지형 발송에 사용된 템플릿 ID입니다. - `templateCode` string, required — 알림톡 이미지형 템플릿의 코드입니다. 템플릿 생성 시 확인 가능하며 템플릿 조회 API로도 확인할 수 있습니다. - `templateExtra` string — 알림톡 이미지형 템플릿에 포함된 추가 정보입니다. 템플릿에 설정된 부가 정보나 메모 사항이 포함됩니다. - `templateImageUrl` string — 알림톡 이미지형에 포함된 이미지의 URL입니다. 메시지와 함께 표시되는 이미지의 웹 주소입니다. - `FT` object — 친구톡 정보 - `body` string, required — 친구톡 메시지의 본문 내용입니다. 자유로운 형태의 텍스트 메시지로 발송됩니다. - `messageType` 'FT', required — 메시지 유형이 친구톡(FT)임을 나타내는 고정값입니다. - `buttons` object[], required — 친구톡에 포함된 버튼들의 정보입니다. 사용자 액션을 유도하는 버튼 목록과 링크 정보가 포함됩니다. - `name` string, required — 버튼에 표시될 텍스트입니다. 사용자에게 보여지는 버튼명입니다. - `linkMobile` string — 모바일 환경에서 버튼 클릭 시 이동할 URL입니다. 웹 링크나 딥 링크를 설정할 수 있습니다. - `linkPc` string — PC 환경에서 버튼 클릭 시 이동할 URL입니다. 데스크톱 브라우저에서 열릴 링크를 설정합니다. - `schemeIos` string — iOS 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `schemeAndroid` string — Android 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `isAd` boolean, required — 친구톡이 광고성 메시지인지 여부입니다. true인 경우 광고성 메시지로 분류되어 특별한 표시가 됩니다. - `FI` object — 친구톡 이미지형 정보 - `body` string, required — 친구톡 이미지형 메시지의 본문 내용입니다. 이미지와 함께 표시되는 텍스트 메시지입니다. - `buttons` object[], required — 친구톡 이미지형에 포함된 버튼들의 정보입니다. 사용자 액션을 유도하는 버튼 목록과 링크 정보가 포함됩니다. - `name` string, required — 버튼에 표시될 텍스트입니다. 사용자에게 보여지는 버튼명입니다. - `linkMobile` string — 모바일 환경에서 버튼 클릭 시 이동할 URL입니다. 웹 링크나 딥 링크를 설정할 수 있습니다. - `linkPc` string — PC 환경에서 버튼 클릭 시 이동할 URL입니다. 데스크톱 브라우저에서 열릴 링크를 설정합니다. - `schemeIos` string — iOS 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `schemeAndroid` string — Android 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `isAd` boolean, required — 친구톡 이미지형이 광고성 메시지인지 여부입니다. true인 경우 광고성 메시지로 분류되어 특별한 표시가 됩니다. - `imageUrl` string — 친구톡 이미지형에 포함된 이미지의 URL입니다. 메시지와 함께 표시되는 이미지의 웹 주소입니다. - `FW` object — 친구톡 와이드이미지형 정보 - `body` string, required — 친구톡 와이드이미지형 메시지의 본문 내용입니다. 큰 크기의 이미지와 함께 표시되는 텍스트 메시지입니다. - `buttons` object[], required — 친구톡 와이드이미지형에 포함된 버튼들의 정보입니다. 사용자 액션을 유도하는 버튼 목록과 링크 정보가 포함됩니다. - `name` string, required — 버튼에 표시될 텍스트입니다. 사용자에게 보여지는 버튼명입니다. - `linkMobile` string — 모바일 환경에서 버튼 클릭 시 이동할 URL입니다. 웹 링크나 딥 링크를 설정할 수 있습니다. - `linkPc` string — PC 환경에서 버튼 클릭 시 이동할 URL입니다. 데스크톱 브라우저에서 열릴 링크를 설정합니다. - `schemeIos` string — iOS 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `schemeAndroid` string — Android 앱으로 이동하기 위한 커스텀 URL 스킴입니다. 앱이 설치되어 있을 때 앱을 직접 실행합니다. - `isAd` boolean, required — 친구톡 와이드이미지형이 광고성 메시지인지 여부입니다. true인 경우 광고성 메시지로 분류되어 특별한 표시가 됩니다. - `imageUrl` string — 친구톡 와이드이미지형에 포함된 와이드 이미지의 URL입니다. 큰 크기로 표시되는 이미지의 웹 주소입니다. - `isUseApi` boolean — API를 통해 메시지가 발송되었는지 여부입니다. true이면 API 호출로 발송, false이면 웹 콘솔을 통한 발송입니다. - `createdAt` string, date-time, nullable, required — 메시지 그룹이 생성된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다. - `updatedAt` string, date-time, nullable, required — 메시지 그룹이 마지막으로 수정된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다. --- [API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/versions/525dedc81a05/schema)