본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

관련사이트

사이드 메뉴

플랫폼 API

API 제공

전용 API

어드민 API

이 문서는 카카오톡 채널 메시지(이하 채널 메시지) 기능에 대해 소개합니다.

카카오톡 채널 메시지는 서비스의 카카오톡 채널로 사용자에게 메시지를 보내는 기능입니다. 이 기능은 인하우스 앱만 사용할 수 있습니다.

채널 메시지 흐름도

1:1 사용자 간 메시지 발송

서비스 사용자가 다른 사용자에게 직접 메시지를 보내는 경우에는 카카오톡 메시지 API를 사용합니다.

  1. 채널 메시지를 관리할 비즈 앱을 생성합니다. 이 과정에서 어려움이 있을 경우, 4번 단계(사용 권한 신청)에서 도움을 요청하면 담당자의 지원을 받을 수 있습니다.
  2. 채널 메시지를 보낼 카카오톡 비즈니스 채널을 준비합니다.
  3. 사용할 채널 메시지 유형을 검토합니다. 정보성 메시지 발송을 원하는 경우 법무 검토가 필요합니다.
  4. 인하우스 앱 변경 및 채널 메시지 사용 권한을 신청합니다. [서비스] API플랫폼 아지트에서 [채널 메시지] 사용 권한 신청 (API/발송기/추가권한/EMT) 양식을 사용합니다.
  5. 채널 메시지 템플릿을 템플릿 생성 후 자가 승인을 완료합니다. (참고: 메시지 템플릿 도구)
  6. 발송 방식 중 하나를 선택해 구성한 메시지를 발송합니다.

정보성 메시지 발송을 원하는 경우 아래 아지트에서 사전 법무 검토가 필요합니다. 특히, [채널 차단 무시] 옵션 활성화가 필요한 경우 반드시 해당 내용을 포함해야 합니다.

카카오톡 채널 메시지는 정보성과 광고성, 두 가지 유형의 메시지를 지원합니다.

  • 정보성 메시지란, 정보통신망법 안내서에 '영리목적 광고성 정보의 예외'에 해당하는 메시지입니다.
  • 수신자가 광고성 정보의 수신을 거부하더라도 전송자와 수신자 간의 계약이나 거래관계로 인하여 수신자에게 발송할 수 있습니다.
  • 카카오톡 채널 친구가 아닌 사용자에게도 메시지 발송이 가능합니다.
  • 카카오톡 채널을 차단한 사용자에게도 메시지를 보내야 하는 경우, 메시지 템플릿에서 [채널 차단 무시] 옵션을 활성화합니다.
  • 중요: 정보성 메시지를 보내려면 법무 검토가 필요합니다.
  • 발송 시나리오 예시:
    • 특정 사용자에게 ID를 지정해 개별 사용자에게 발송 (예: 기기 로그인 알림, 휴대폰 번호(id)로 본인 인증, 계정별 결제 내역 등)
    • 동일한 내용을 다수의 사용자에게 일괄 발송 (예: 서비스 공지, 약관 개정 안내, 이벤트 전체 알림 등)
    • 사용자에게 맞춘 개인화 메시지 발송 (예: 홍길동님 예약이 완료되었습니다.)
    • 일회용 비밀번호 등 인증 목적으로 발송하는 메시지 (예: OTP 번호 안내, 본인 확인 인증번호 전달)
  • 사용자에게 광고를 목적으로 보내는 메시지입니다.
  • 본문 앞에 (광고) 문구가 자동 추가됩니다.
  • 국내법에 의해 야간 시간(오후 9시~익일 오전 8시) 발송이 금지되어 있습니다.(수신자에게 메시지가 도달한 한국 표준시(KST) 기준, 해외 사용자는 제외)
  • 금지된 시간대 메시지 발송 시도는 모두 실패 처리되며, 다음날 오전 8시 이후 서비스에서 직접 재발송해야 합니다.
  • 카카오톡 채널 친구가 아닌 사용자에게는 메시지를 보낼 수 없습니다.
  • 메시지에 카카오 인증 마크를 사용할 수 없습니다.
  • 발송 시나리오 예시: 할인 쿠폰, 이벤트 참여 유도 메시지 등

카카오계정 ID(account_id), 카카오톡 회원번호(talk_id), 회원번호(user_id), 전화번호(phone_number)로 특정 가능한 사용자에게 메시지를 발송할 수 있습니다. 상황별 발송 대상 선택 방법은 아래를 참고합니다.

ID설명
account_id
talk_id
phone_number
서비스의 개별 사용자에게 개인화된 메시지 발송 시
서비스의 특정 사용자 집단에 단체 메시지 발송 시
user_idKAPI와 연계한 채널 메시지 발송 시
  • 카카오 API로 접근 동의 받은 사용자에게 메시지 발송
  • 카카오 API로 접근 동의받은 고객사의 사용자에게 메시지 발송
발송 권한

  • 전화번호(phone_number)로 대상을 특정한 채널 메시지 발송에는 별도 권한이 필요합니다.
  • 카카오계정 ID(account_id), 앱 회원번호(user_id), 카카오톡 회원번호(talk_id) 사용이 불가한 경우에만 권한을 부여하며, 전화번호 오입력으로 인한 오발송 책임은 서비스에 있습니다.

카카오톡 미사용 ID

카카오톡을 사용하지 않는 사용자의 account_id, user_id, phone_number에 대한 메시지 발송 요청은 모두 실패 처리됩니다. 이 경우 별도의 이메일 또는 SMS 발송 기능을 제공하지 않기 때문에, 서비스는 직접 다른 발송 방법을 마련해야 합니다.

카카오톡 채널 메시지로 발송할 템플릿을 구성하는 방법을 안내합니다.

메시지 API용 템플릿은 기본적으로 피드, 리스트형, 커머스형 템플릿을 제공합니다. 채널 메시지는 이 외에 와이드 피드형과 와이드 리스트형 템플릿도 지원합니다. 이 외에 고급 기능은 채널 메시지 부가 기능을 참고합니다.

와이드 피드, 와이드 리스트 메시지 템플릿

피드, 리스트, 커머스 메시지는 메시지 템플릿 > 종류를 참고합니다.

채널 메시지는 메시지 템플릿 도구로 생성한 사용자 정의 메시지 템플릿으로 발송한 메시지만 지원합니다. 지원하는 템플릿 종류는 지원하는 템플릿 종류를 참고합니다.

  1. 카카오디벨로퍼스의 [도구] > [메시지 템플릿]에서 [+메시지 템플릿 추가]를 선택합니다.
  2. 템플릿 추가 시 [메시지 타입]은 [카카오톡 채널 메시지]를 선택합니다.
  3. 메시지 템플릿을 구성합니다. 자세한 설정 방법은 메시지 템플릿 도구를 참고합니다.

발송 장소 선택

채널 메시지에는 와이드형 말풍선, 카카오 인증 마크를 사용할 수 있습니다.

기능설명
와이드형 말풍선71. 레버리지 말풍선 > 07. 와이드형 참고

제약 조건
  • 피드 메시지 사용 시, 이미지와 버튼이 각각 하나인 경우에 한정해 설정 가능
  • 프로필, 헤더, 이미지 아이템, 텍스트 아이템, 소셜 컴포넌트 사용 불가
  • 메시지 템플릿 도구에서 와이드형 말풍선의 미리보기 미지원
  • 사용자가 해당 메시지를 다른 채팅방에 공유할 수 없음(메시지 템플릿 도구의 전달 허용 항목 설정 불가)
  • 카카오 인증 마크 적용 불가
카카오 인증 마크카카오톡 공유, 카카오톡 메시지와 동일한 인증 마크 사용 가능
카카오 인증 마크를 사용하려면 말풍선 공장 아지트에서 사용 승인을 받은 후, [서비스] API플랫폼 아지트에서 권한 신청

제약 조건
  • 사용자가 해당 메시지를 다른 채팅방에 공유할 수 없음(메시지 템플릿 도구의 전달 허용 항목 설정 불가)
  • 광고성 메시지 또는 와이드형 말풍선에 인증 마크 적용 불가

와이드형 말풍선과 카카오 인증 마크 예시

사용자 또는 발송 시나리오에 따라 변경될 정보는 API 호출 시점에 채워 넣을 수 있습니다. 채널 메시지 발송기 사용 시 사용자 인자는 텍스트와 URL 경로만 사용 가능합니다. 사용자 인자를 참고합니다.

채널 메시지는 본인이 직접 검토 후 심사 승인한 템플릿만 사용할 수 있습니다.

[도구] > [메시지 템플릿]에서 [심사 승인]을 선택하면 검토 항목이 표시됩니다. 정보성 메시지인 경우, 광고 문구가 포함되지 않았는지 검토 후 직접 승인합니다.

정보성 메시지 템플릿 심사 예시

채널 메시지를 발송할 수 있는 방법에 대해 안내합니다. 아래 표와 각 항목의 설명을 확인합니다.

발송 방식설명사용자 인자최대 발송 대상 수
채널 메시지 발송기[도구] > [카카오톡 채널 메시지 발송기]를 사용한 채널 메시지 발송사용 불가발송 대상 직접 입력 시 최대 1,000명
파일 업로드 시 제한 없음
API: 실시간 발송서비스 서버에서 개별 사용자에게 서비스 내 특정 조건 만족 시 실시간 발송하는 경우
사용자 정의 템플릿으로 메시지 발송 API의 내부 URL 사용
사용 가능API 요청당 최대 10명
API: 배치(Batch) 발송서비스 서버에서 주기적으로 같은 메시지 템플릿을 사용해 발송하는 경우
동시에 다수 사용자에게 같은 메시지 템플릿을 사용해 발송하는 경우
사용자 정의 템플릿으로 메시지 발송 API의 배치 URL 사용
사용 가능API 요청당 최대 10명
대용량 발송 사전 공유 필수

채널 메시지 발송기를 사용해 50만 건 이상의 채널 메시지를 발송하는 경우, 또는 배치 발송 시에는 [서비스] API플랫폼 아지트에서 상세 내용을 사전 공유해야 합니다. 동일한 성격의 발송은 최초 1회만 공유합니다.

API설명문서
사용자 정의 템플릿으로 메시지 발송사용자 정의 템플릿으로 채널 메시지를 발송합니다.REST API

도움이 되었나요?