API
솔라피 시작하기
API

카카오톡

작성일 2026.03.05 | 수정일 2026.03.05

카카오톡 API는 SOLAPI 플랫폼에서 카카오톡 비즈니스 메시지(알림톡, 브랜드 메시지)를 발송하기 위한 사전 준비 과정을 지원합니다.
카카오톡 채널 연동부터 알림톡 템플릿 생성/검수, 채널 그룹 관리, 브랜드 템플릿 관리까지 메시지 발송에 필요한 모든 리소스를 API를 통해 관리할 수 있습니다.

알림톡과 브랜드 메시지

카카오톡 비즈니스 메시지는 크게 알림톡과 브랜드 메시지 두 가지로 나뉩니다.

구분알림톡브랜드 메시지
용도정보성 메시지
(주문 확인, 배송 알림 등)		다양한 형태의 비즈니스 메시지
(텍스트, 이미지, 와이드, 캐러셀 등)
수신 동의불필요
(전화번호만 있으면 발송 가능)		불필요
템플릿 검수카카오 사전 검수 필수검수 없이 바로 사용 가능
템플릿 종류알림톡 템플릿브랜드 템플릿
발송 식별자channelId + templateIdchannelId + brandTemplateId
메시지 형태텍스트 기반
(강조 표기, 아이템 리스트 등 지원)		다양한 버블 타입 지원
(TEXT, IMAGE, WIDE, CAROUSEL 등)

핵심 식별자

이 API에서 사용되는 주요 식별자들을 이해하면 전체 흐름을 파악하는 데 도움이 됩니다.

channelId (채널 ID)

  • 카카오톡 비즈니스 채널의 SOLAPI 내부 고유 식별자 입니다.

  • v1 API에서는 `pfId`(Plus Friend ID)라는 이름으로 사용되었으며, v2에서 `channelId`로 변경되었습니다.

  • 알림톡과 브랜드 메시지 발송 시 공통으로 사용됩니다.

  • 카카오 비즈니스센터에서 운영 중인 채널을 SOLAPI에 연동하면 자동으로 생성됩니다.

  • 형식 예시: `KA01PF230101000000001`

templateId (템플릿 ID)

  • 카카오 알림톡 템플릿의 SOLAPI 내부 고유 식별자 입니다.

  • 알림톡 발송 시에만 사용됩니다. 브랜드 메시지는 별도의 `brandTemplateId`를 사용합니다.

  • 템플릿을 생성하면 자동으로 부여되며, 카카오 검수를 통과한 뒤에야 실제 발송에 사용할 수 있습니다.

  • 형식 예시: `KA01TP240101000000001`

channelGroupId (채널 그룹 ID)

  • 여러 카카오톡 채널을 하나의 그룹으로 묶어 관리할 때 사용하는 식별자입니다.

  • 그룹에 속한 모든 채널이 동일한 템플릿을 공유할 수 있어, 다수의 브랜드/지점을 운영하는 경우에 유용합니다.

  • 형식 예시: `KA01GI00000001`

brandTemplateId (브랜드 템플릿 ID)

  • 브랜드 메시지 전용 템플릿의 고유 식별자입니다.

  • 일반 알림톡 템플릿과 달리 검수 없이 바로 사용할 수 있습니다.

  • 텍스트, 이미지, 와이드, 캐러셀 등 다양한 형태(`chatBubbleType`)를 지원합니다.

v1 에서 v2로의 변경점

v2 API에서는 일부 식별자 이름이 변경되었습니다. 기존 v1 API를 사용하고 있었다면 아래 매핑을 참고하세요.

v1(레거시)v2(권장)Description
pfIdchannelId카카오톡 채널 식별자
pfGroupIdchannelGroupId채널 그룹 식별자
Plus FriendChannel카카오톡 채널 용어
PF GroupChannel Group채널 그룹 용어