bizgo Developers
API 레퍼런스커뮤니케이션 API카카오 비즈메시지

카카오 비즈메시지(공통)

카카오 비즈메시지 공통 API는 알림톡, 브랜드메시지, 상담톡에서 함께 사용하는 발신프로필과 운영 상태를 조회하거나 관리하는 API입니다.

발신프로필 관리

발신프로필은 카카오 비즈메시지 발송의 기준 정보입니다. 발신프로필 키를 기준으로 상태를 확인하거나 휴면 상태를 해제할 때 사용합니다.

발신프로필 키로 조회

GET/api/comm/v1/center/kakao/sender
샌드박스로 테스트하기

발신프로필 키를 기준으로 카카오 발신프로필 정보를 조회합니다. 알림톡, 브랜드메시지, 상담톡에서 사용하는 senderKey 상태를 확인할 때 사용합니다.

Query Parameters

senderKey

필수String

발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender?senderKey={senderKey}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode": "A000",
4 "authResult": "Success",
5 "infobankTrId": "Infobank-Tracking-Id"
6 },
7 "data": {
8 "code": "A000",
9 "result": "Success",
10 "data": {
11 "kakao": {
12 "senderProfile": {
13 "senderKey": "{senderKey}"
14 }
15 }
16 }
17 }
18}

발신프로필 휴면 해제

POST/api/comm/v1/center/kakao/sender/recover
샌드박스로 테스트하기

휴면 상태의 발신프로필을 해제합니다. 카카오 비즈메시지 발송 전 발신프로필 상태 복구가 필요한 경우 사용합니다.

Body Parameters

{} JSON

senderKey

필수String

휴면 해제할 발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/recover" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "senderKey": "{senderKey}"
6 }'

응답 예시

1{
2 "common": {
3 "authCode": "A000",
4 "authResult": "Success",
5 "infobankTrId": "Infobank-Tracking-Id"
6 },
7 "data": {
8 "code": "A000",
9 "result": "Success"
10 }
11}

발신프로필 카테고리 관리

카카오 비즈메시지에서 사용하는 발신프로필 카테고리 정보를 조회하는 API입니다. 발신프로필 등록이나 운영 정책 확인 시 함께 참고합니다.

카테고리 전체조회

GET/api/comm/v1/center/kakao/sender/category/list
샌드박스로 테스트하기

발신프로필 등록 시 사용할 수 있는 카카오 비즈메시지 카테고리 목록을 조회합니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category/list" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode": "A000",
4 "authResult": "Success",
5 "infobankTrId": "Infobank-Tracking-Id"
6 },
7 "data": {
8 "code": "A000",
9 "result": "Success",
10 "data": {
11 "kakao": {
12 "categories": [
13 {
14 "code": "001",
15 "name": "쇼핑"
16 },
17 {
18 "code": "002",
19 "name": "금융"
20 }
21 ]
22 }
23 }
24 }
25}

카테고리 상세조회

GET/api/comm/v1/center/kakao/sender/category
샌드박스로 테스트하기

카테고리 코드를 기준으로 카카오 비즈메시지 카테고리 상세 정보를 조회합니다.

Query Parameters

code

필수String

조회할 카테고리 코드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category?code={code}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode": "A000",
4 "authResult": "Success",
5 "infobankTrId": "Infobank-Tracking-Id"
6 },
7 "data": {
8 "code": "A000",
9 "result": "Success",
10 "data": {
11 "kakao": {
12 "category": {
13 "code": "001",
14 "name": "쇼핑"
15 }
16 }
17 }
18 }
19}

발신프로필 그룹 관리

발신프로필 그룹은 여러 발신프로필을 묶어서 운영할 때 사용하는 관리 단위입니다. 그룹 소속을 조회하거나 그룹에서 발신프로필을 제외할 때 사용합니다.

발신프로필키로 그룹 조회

GET/api/comm/v1/center/kakao/group
샌드박스로 테스트하기

발신프로필 키를 기준으로 연결된 그룹 정보를 조회합니다. senderKey를 생략하면 조회 가능한 그룹 정보를 기준으로 응답합니다.

Query Parameters

senderKey

String

조회 기준 발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/group?senderKey={senderKey}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode": "A000",
4 "authResult": "Success",
5 "infobankTrId": "Infobank-Tracking-Id"
6 },
7 "data": {
8 "code": "A000",
9 "result": "Success",
10 "data": {
11 "kakao": {
12 "groups": [
13 {
14 "groupKey": "{groupKey}",
15 "name": "기본 그룹"
16 }
17 ]
18 }
19 }
20 }
21}

그룹에 발신프로필 삭제

DELETE/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}
샌드박스로 테스트하기

발신프로필 그룹에서 특정 발신프로필을 삭제합니다.

Path Parameters

groupKey

필수String

그룹 키입니다.

senderKey

필수String

삭제할 발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X DELETE "https://mars.ibapi.kr/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode": "A000",
4 "authResult": "Success",
5 "infobankTrId": "Infobank-Tracking-Id"
6 },
7 "data": {
8 "code": "A000",
9 "result": "Success"
10 }
11}

제재 관리

제재 정보는 발신프로필, 그룹템플릿, 템플릿 단위로 운영 제한 여부를 확인하는 API입니다. 발송 전 사용 가능 상태를 점검할 때 활용합니다.

발신프로필 제재 조회

GET/api/comm/v1/center/kakao/abusing/block/sender
샌드박스로 테스트하기

특정 일자의 발신프로필 제재 정보를 조회합니다.

Query Parameters

date

필수String

조회 기준 날짜입니다.

senderKey

필수String

발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/sender?date={date}&senderKey={senderKey}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode": "A000",
4 "authResult": "Success",
5 "infobankTrId": "Infobank-Tracking-Id"
6 },
7 "data": {
8 "code": "A000",
9 "result": "Success",
10 "data": {
11 "kakao": {
12 "abusing": {
13 "restrictedAt": "2026-03-05 16: 33: 17",
14 "senderKey": "{senderKey}",
15 "reasonType": "POLICY"
16 }
17 }
18 }
19 }
20}

그룹템플릿 발신프로필 제외 조회

GET/api/comm/v1/center/kakao/abusing/block/senderGroup
샌드박스로 테스트하기

그룹템플릿에서 특정 발신프로필이 제외된 제재 정보를 조회합니다.

Query Parameters

date

필수String

조회 기준 날짜입니다.

senderKey

필수String

발신프로필 키입니다.

groupKey

필수String

그룹 발신프로필 키입니다.

templateCode

필수String

템플릿 코드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/senderGroup?date={date}&senderKey={senderKey}&groupKey={groupKey}&templateCode={templateCode}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode": "A000",
4 "authResult": "Success",
5 "infobankTrId": "Infobank-Tracking-Id"
6 },
7 "data": {
8 "code": "A000",
9 "result": "Success",
10 "data": {
11 "kakao": {
12 "abusing": {
13 "restrictedAt": "2026-03-05 16: 33: 17",
14 "senderKey": "{senderKey}",
15 "groupKey": "{groupKey}",
16 "templateCode": "{templateCode}"
17 }
18 }
19 }
20 }
21}

템플릿 제재 조회

GET/api/comm/v1/center/kakao/abusing/block/template
샌드박스로 테스트하기

특정 템플릿의 제재 정보를 조회합니다.

Query Parameters

date

필수String

조회 기준 날짜입니다.

senderKey

필수String

발신프로필 키입니다.

templateCode

필수String

템플릿 코드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/template?date={date}&senderKey={senderKey}&templateCode={templateCode}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode": "A000",
4 "authResult": "Success",
5 "infobankTrId": "Infobank-Tracking-Id"
6 },
7 "data": {
8 "code": "A000",
9 "result": "Success",
10 "data": {
11 "kakao": {
12 "abusing": {
13 "restrictedAt": "2026-03-05 16: 33: 17",
14 "senderKey": "{senderKey}",
15 "senderKeyType": "S",
16 "templateCode": "{templateCode}"
17 }
18 }
19 }
20 }
21}