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

알림톡

알림톡은 카카오가 승인한 템플릿을 기반으로 고객에게 정보성 메시지를 발송하는 카카오 비즈메시지 채널입니다. 발송 규격과 함께 템플릿 등록, 이미지 업로드, 검수 요청 등의 운영 API를 함께 제공합니다.

알림톡 발송

POST/api/comm/v1/send/omni
메시지 발송 체험하기 샌드박스로 테스트하기

알림톡은 단일 발송 규격을 사용하며, messageFlow[].alimtalk.msgType 값(AT/AI)으로 텍스트형과 이미지형을 구분합니다.

Body Parameters

{}JSON

destinations

필수 Object Array

수신 정보 배열입니다. 동보발송 최대 200건입니다.

messageFlow

필수 Object Array

메시지를 추가하면 순서대로 자동 Fallback 메시지 처리됩니다.

paymentCode

String

정산용 부서 코드입니다.

groupKey

String

메시지 인사이트 에서 그룹으로 묶어서 통계를 확인하기 위해 설정하는 키입니다.

idempotencyKey

String

요청에 대한 멱등함을 구분하는 멱등성 키 필드입니다.

idempotencyTtl

Integer

멱등 처리키 유효시간 입니다.

ref

String

요청 참조 필드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "/api/comm/v1/send/omni" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "destinations": [{ "to": "01012345678", "replaceWords": { "name": "홍길동" } }],
6 "messageFlow": [{
7 "alimtalk": {
8 "msgType": "AT",
9 "senderKey": "PROFILE_KEY",
10 "templateCode": "BG_pticket_issued_notice",
11 "text": "#{name}님의 예약이 접수되었습니다.",
12 "attachment": {
13 "button": [{
14 "type": "WL",
15 "name": "예약 조회",
16 "urlMobile": "https://bizgo.io/m/reservation/123",
17 "urlPc": "https://bizgo.io/reservation/123"
18 }]
19 }
20 }
21 }],
22 "ref": "alimtalk-at-20260331-001"
23 }'

응답 예시

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 "destinations": [{
12 "to": "01012345678",
13 "msgKey": "AT20260331-000001",
14 "code": "A000",
15 "result": "Success"
16 }]
17 },
18 "ref": "alimtalk-at-20260331-001"
19 }
20}

템플릿 자동 치환 발송

POST/api/comm/v1/send/omni
메시지 발송 체험하기 샌드박스로 테스트하기

템플릿 전문을 요청 본문에 직접 입력하지 않고, 템플릿 코드와 치환 변수만 전달해 발송합니다. Bizgo API가 템플릿 코드에 맞는 전문을 생성한 뒤 destinations[].replaceWords 값을 치환해 알림톡을 발송합니다.

Body Parameters

{} JSON

destinations

필수Object Array

수신 정보 배열입니다.

messageFlow

필수Object Array

메시지 규격 배열입니다.

ref

String

요청 참조 필드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/send/omni" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "destinations": [{
6 "to": "01000000000",
7 "replaceWords": {
8 "name": "홍길동",
9 "orderName": "비즈고 이용권",
10 "status": "결제완료"
11 }
12 }],
13 "messageFlow": [{
14 "alimtalk": {
15 "senderKey": "{senderKey}",
16 "templateCode": "{templateCode}",
17 "sendType": "template"
18 }
19 }],
20 "ref": "alimtalk-template-001"
21 }'

응답 예시

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 "destinations": [{
12 "to": "01000000000",
13 "msgKey": "AT20260408-000001",
14 "code": "A000",
15 "result": "Success"
16 }]
17 },
18 "ref": "alimtalk-template-001"
19 }
20}

템플릿 관리

알림톡 템플릿은 발송 전에 등록과 수정, 이미지 준비가 필요한 운영 자산입니다. 템플릿 구성과 등록에 필요한 API를 함께 제공합니다.

템플릿 조회

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

발신프로필 키와 템플릿 코드를 기준으로 알림톡 템플릿 상세 정보를 조회합니다.

Query Parameters

senderKey

필수String

발신프로필 키입니다.

templateCode

필수String

템플릿 코드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template?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 "alimtalk": {
12 "senderKey": "{senderKey}",
13 "msgType": "AT",
14 "templateCode": "{templateCode}",
15 "text": "#{name}님, 주문이 완료되었습니다."
16 }
17 }
18 }
19}

템플릿 등록

POST/api/comm/v1/center/alimtalk/template
샌드박스로 테스트하기

알림톡 템플릿을 등록합니다. 이미지형 또는 아이템리스트형 템플릿은 템플릿 이미지 업로드 API로 발급받은 imgUrl과 imgName을 함께 사용합니다.

Body Parameters

{} JSON

alimtalk

필수Object

알림톡 템플릿 정보입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "alimtalk": {
6 "senderKey": "{senderKey}",
7 "templateName": "주문 완료 안내",
8 "templateCode": "ORDER_DONE_001",
9 "templateMessageType": "BA",
10 "templateEmphasizeType": "NONE",
11 "text": "#{name}님, 주문이 완료되었습니다.",
12 "categoryCode": "001001"
13 }
14 }'

응답 예시

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 "alimtalk": {
12 "senderKey": "{senderKey}",
13 "msgType": "AT",
14 "templateCode": "ORDER_DONE_001",
15 "text": "#{name}님, 주문이 완료되었습니다."
16 }
17 }
18 }
19}

템플릿 수정

PUT/api/comm/v1/center/alimtalk/template
샌드박스로 테스트하기

등록된 알림톡 템플릿 정보를 수정합니다. 검수 상태와 카카오 정책에 따라 수정 가능한 범위가 달라질 수 있습니다.

Body Parameters

{} JSON

alimtalk

필수Object

알림톡 템플릿 정보입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X PUT "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "alimtalk": {
6 "senderKey": "{senderKey}",
7 "templateCode": "ORDER_DONE_001",
8 "templateName": "주문 완료 안내 수정",
9 "templateMessageType": "BA",
10 "templateEmphasizeType": "NONE",
11 "text": "#{name}님, 주문 접수가 완료되었습니다."
12 }
13 }'

응답 예시

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 "alimtalk": {
12 "senderKey": "{senderKey}",
13 "msgType": "AT",
14 "templateCode": "ORDER_DONE_001",
15 "text": "#{name}님, 주문 접수가 완료되었습니다."
16 }
17 }
18 }
19}

템플릿 삭제

DELETE/api/comm/v1/center/alimtalk/template/senderKey/{senderKey}/templateCode/{templateCode}
샌드박스로 테스트하기

발신프로필 키와 템플릿 코드를 기준으로 알림톡 템플릿을 삭제합니다.

Path Parameters

senderKey

필수String

발신프로필 키입니다.

templateCode

필수String

삭제할 템플릿 코드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X DELETE "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template/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 }
11}

템플릿 이미지 업로드

POST/api/comm/v1/file/alimtalk/template
샌드박스로 테스트하기

알림톡 이미지형, 와이드 이미지형, 아이템리스트형 템플릿 등록에 사용할 이미지를 업로드합니다. 메시지 발송용 이미지 업로드가 아니라 템플릿 등록을 위한 사전 이미지 등록 API입니다.

Body Parameters

FORM-DATA

file

필수Binary

업로드할 이미지 파일 바이너리입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/file/alimtalk/template" \
2 -H "Authorization: {ApiKey}" \
3 -F "file=@/path/template-image.jpg"

응답 예시

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 "imgUrl": "https://example.kakao.image/template-image.jpg",
12 "fileName": "template-image.jpg"
13 }
14 }
15}

템플릿 하이라이트 이미지 업로드

POST/api/comm/v1/file/alimtalk/itemHighlight
샌드박스로 테스트하기

아이템리스트형 알림톡 템플릿의 아이템 하이라이트 영역에 사용할 이미지를 업로드합니다. 템플릿 이미지 업로드와 동일하게 템플릿 등록을 위한 사전 이미지 등록 API입니다.

Body Parameters

FORM-DATA

file

필수Binary

업로드할 아이템 하이라이트 이미지 파일 바이너리입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/file/alimtalk/itemHighlight" \
2 -H "Authorization: {ApiKey}" \
3 -F "file=@/path/item-highlight.jpg"

응답 예시

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 "imgUrl": "https://example.kakao.image/item-highlight.jpg",
12 "fileName": "item-highlight.jpg"
13 }
14 }
15}

템플릿 카테고리 관리

템플릿 카테고리는 카카오 검수와 정책 기준에 맞는 템플릿 분류를 확인할 때 사용합니다. 등록 전 카테고리 선택 기준을 점검할 수 있습니다.

템플릿 카테고리 전체 조회

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

알림톡 템플릿 등록 시 사용할 수 있는 템플릿 카테고리 전체 목록을 조회합니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/category" \
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 "categories": [{
12 "code": "001001",
13 "name": "주문/예약",
14 "groupName": "커머스",
15 "inclusion": "주문, 예약, 결제 알림",
16 "exclusion": "광고성 안내"
17 }]
18 }
19 }
20}

템플릿 카테고리 조회

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

카테고리 코드를 기준으로 알림톡 템플릿 카테고리 상세 정보를 조회합니다.

Query Parameters

categoryCode

필수String

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

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/category?categoryCode={categoryCode}" \
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 "category": {
12 "code": "001001",
13 "name": "주문/예약",
14 "groupName": "커머스",
15 "inclusion": "주문, 예약, 결제 알림",
16 "exclusion": "광고성 안내"
17 }
18 }
19 }
20}

템플릿 검수

알림톡 템플릿은 카카오 검수 승인 이후에 사용할 수 있습니다. 검수 요청과 첨부 검수, 요청 취소 API를 순서대로 제공합니다.

템플릿 검수 요청

POST/api/comm/v1/center/alimtalk/template/request
샌드박스로 테스트하기

등록된 알림톡 템플릿을 카카오 검수로 요청합니다. 템플릿 상태가 대기이고 검수 상태가 등록인 경우 요청할 수 있습니다.

Body Parameters

{} JSON

alimtalk

필수Object

검수 요청할 알림톡 템플릿 정보입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template/request" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "alimtalk": {
6 "senderKey": "{senderKey}",
7 "templateCode": "{templateCode}",
8 "comment": "검수 요청합니다."
9 }
10 }'

응답 예시

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}

템플릿 검수 요청(파일첨부)

POST/api/comm/v1/center/alimtalk/template/request
샌드박스로 테스트하기

등록된 알림톡 템플릿을 첨부 파일과 함께 카카오 검수로 요청합니다. 파일 형식은 png, jpg, jpeg, gif, pdf, hwp, doc, docx를 사용할 수 있습니다.

Body Parameters

FORM-DATA

senderKey

필수String

발신프로필 키입니다.

senderKeyType

String

발신프로필 키 타입입니다.

templateCode

필수String

템플릿 코드입니다.

comment

필수String

검수 의견 또는 문의 사항입니다.

attachment

Binary

검수 요청에 첨부할 파일입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template/request" \
2 -H "Authorization: {ApiKey}" \
3 -F "senderKey={senderKey}" \
4 -F "templateCode={templateCode}" \
5 -F "comment=검수 요청합니다." \
6 -F "attachment=@/path/review-file.pdf"

응답 예시

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}

템플릿 검수 요청 취소

POST/api/comm/v1/center/alimtalk/template/request/cancel
샌드박스로 테스트하기

검수 요청된 알림톡 템플릿의 검수 요청을 취소합니다.

Body Parameters

{} JSON

alimtalk

필수Object

검수 요청 취소 대상 템플릿 정보입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/template/request/cancel" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "alimtalk": {
6 "senderKey": "{senderKey}",
7 "templateCode": "{templateCode}"
8 }
9 }'

응답 예시

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/alimtalk/public/template
샌드박스로 테스트하기

카카오에서 제공하는 공용템플릿 목록을 조회합니다. 공용템플릿을 참고해 템플릿 등록이나 운영 정책을 검토할 때 사용합니다.

Query Parameters

since

String

조회 기준 시각입니다.

page

Integer

조회 페이지 번호입니다.

count

Integer

페이지당 조회 건수입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/alimtalk/public/template?since=20250708000000&page=1&count=100" \
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 "templates": [{
12 "templateCode": "PUBLIC_ORDER_001",
13 "templateName": "주문 완료 안내",
14 "status": "APR",
15 "categoryCode": "001001",
16 "releaseDate": "2026-04-08 10: 00: 00",
17 "previewImageUrl": "https://example.kakao.image/public-template.png"
18 }]
19 }
20 }
21}