이해하기

이 문서는 카카오톡 채널 API를 소개합니다.

기능 소개

카카오톡 채널(구:플러스친구)은 카카오톡 사용자들에게 다양한 서비스 소식을 메시지와 게시물 형태로 전파할 수 있는 서비스입니다. 카카오톡 채널은 친구인 사용자들에게 마케팅(Marketing) 메시지를 보내는 기능을 제공합니다. 친구란 카카오톡 채널을 친구로 추가한 사용자를 말합니다. 카카오톡 채널 메시지는 비용 절감을 위해 사용자의 성별, 나이, 지역, 등급 등 정보를 토대로 친구 그룹을 만들어서 보다 높은 효과가 기대되는 사용자들에게만 발송하는 것도 가능합니다.

카카오톡 채널을 활용하여 서비스와 사용자의 관계를 더욱 긴밀하게 유지할 수 있습니다. 예를 들면 카카오톡 채널 메시지를 통해 사용자에게 서비스 웹 페이지 방문을 유도하거나 유익한 상품 정보의 링크를 제공하는 것이 가능합니다. 1:1 채팅, 스마트채팅, 봇 등 유용한 추가 기능들도 이용할 수 있습니다.

카카오톡 채널 API는 크게 두 가지의 기능을 제공합니다. 카카오톡 사용자를 위한 카카오톡 채널 추가 및 채팅 API, 다른 카카오톡 채널 관리자가 보다 편리하게 고객 그룹을 관리할 수 있도록 도와주는 카카오톡 채널 고객 관리 API가 있습니다. 두 API 모두 카카오톡 채널 프로필 ID를 사용해 요청하지만, 각각 역할과 제공 방식이 다릅니다.

카카오톡 채널 API를 사용하려면 앱과 카카오톡 채널이 연결되어 있어야 합니다. 또한 사용자의 '카카오톡 채널 추가 상태' 제공 동의가 필요합니다. 자세한 안내 및 설정 방법은 설정하기를 참고합니다.

참고: 카카오톡 채널 프로필 ID 확인 방법

[카카오톡 채널 관리자센터] > [관리] > [상세설정]에서 카카오톡 채널의 채널 URL을 확인할 수 있습니다. 채널 URL에서 https://pf.kakao.com/ 부분을 제외한 뒷자리 값이 해당 카카오톡 채널의 프로필 ID입니다. 다음 예시를 참고합니다.

• 채널 URL: https://pf.kakao.com/_ZeUTxl
• 카카오톡 채널 프로필 ID: _ZeUTxl

카카오톡 채널 추가와 채팅

Kakao SDK를 통해 제공되는 카카오톡 채널 추가와 채팅 API는 카카오톡 채널로 이동할 수 있는 연결 페이지(Bridge page)를 띄우는 기능입니다. 연결 페이지는 사용자 진입 시 카카오톡 채널로 이동할지 묻는 팝업을 띄우고, 사용자가 이동에 동의하면 커스텀 URL 스킴(Custom URL Scheme)을 통해 카카오톡을 실행하고 해당 카카오톡 채널 화면으로 이동합니다. 사용자는 카카오톡 채널 화면에서 해당 카카오톡 채널을 친구로 추가하거나 1:1 채팅을 시작할 수 있습니다.

이 기능은 카카오톡 사용자만 이용할 수 있습니다. 카카오톡을 사용하지 않는 카카오계정으로 로그인한 사용자에게는 "이 계정과 연결된 카카오톡이 없습니다."라는 문구가 포함된 안내 화면이 나타납니다.

카카오톡 채널 고객 관리

카카오톡 채널 고객 관리 API를 사용하여 카카오톡 채널 관리자센터에서 제공하는 카카오톡 채널 고객 파일 등록 및 관리 기능을 API 방식으로 이용할 수 있습니다.

카카오톡 채널 고객 관리 API는 마케팅 시 보다 정교한 사용자 타게팅을 가능하게 합니다. 카카오 로그인이나 카카오싱크 간편가입을 적용한 서비스는 사용자 정보를 바탕으로 카카오톡 채널 고객 관리 API를 사용해 고객 파일을 등록하고, 해당 고객 파일을 대상으로 카카오톡 채널 관리자센터에서 원하는 조건에 따라 친구 그룹을 생성하여 타깃 메시지를 보낼 수 있습니다. 자세한 사항은 카카오톡 채널 관리자센터 공지사항을 참고합니다.

이 기능은 REST API 방식으로만 제공되며, 서버에서만 호출해야 합니다. 설정하기와 REST API를 참고합니다.

더 효과적인 활용 방법

사용자가 카카오 로그인을 통해 서비스에 연결되면, 카카오톡 채널 관계 확인하기를 통해 각 사용자의 카카오톡 채널 추가 상태를 확인할 수 있습니다. 사용자의 카카오톡 채널 추가 상태에 따라 카카오톡 채널과 친구가 아닌 사용자에게 친구 추가를 유도하거나 고객 파일에서 사용자를 제외할 수 있습니다. 다음 개발 가이드를 참고합니다.

• REST API
• JavaScript
• Android
• iOS

이와 더불어 카카오톡 채널 관계 알림 기능을 적용하면 사용자가 서비스와 연결된 카카오톡 채널을 추가 또는 차단했을 때 알림을 받을 수 있습니다.

앱과 연결된 카카오톡 채널을 추가한 사용자들에게 카카오톡 채널 메시지를 보낼 때, 현재 해당 카카오톡 채널을 차단한 사용자나 별도로 카카오톡에서 친구 추가한 사용자는 자체적으로 파악이 어려울 수 있습니다. 이 경우에도 채널 관계 알림을 사용하면 알림을 통해 변동 사항을 파악할 수 있습니다.

카카오 로그인과 관계없이 [친구 추가] 버튼을 서비스에 노출하고 싶다면 Kakao SDK가 지원하는 카카오톡 채널 추가하기 기능을 사용합니다. 사용자는 서비스 이용 중 이 버튼을 눌러 쉽게 상담을 위한 1:1 대화를 시작할 수 있습니다.

지원하는 기능

• 각 API 및 기능의 Kakao SDK 지원 여부는 지원 범위에서 확인할 수 있습니다.

API 및 기능	설명	문서
카카오톡 채널 추가하기	사용자가 지정된 카카오톡 채널을 친구로 추가할 수 있는 연결 페이지를 제공합니다.	JavaScript Android iOS Flutter
카카오톡 채널 채팅하기	사용자가 지정된 카카오톡 채널과의 1:1 채팅방으로 진입할 수 있는 연결 페이지를 제공합니다.	JavaScript Android iOS Flutter
카카오톡 채널 관계 확인하기	현재 로그인한 사용자와 앱에 연결된 카카오톡 채널의 친구 관계를 확인합니다.	REST API JavaScript Android iOS Flutter
여러 사용자 카카오톡 채널 관계 확인하기	앱에 연결된 카카오톡 채널과 여러 사용자의 친구 관계를 확인합니다.	REST API
카카오톡 채널 관계 알림	사용자가 앱에 연결된 카카오톡 채널을 추가하거나 차단했을 때 서비스 서버에 알려줍니다.	콜백
고객 관리: 고객 파일 등록하기	새로운 고객 파일을 만듭니다.	REST API
고객 관리: 고객 파일 보기	카카오톡 채널에 등록된 고객 파일 정보들을 확인합니다.	REST API
고객 관리: 사용자 추가하기	고객 파일에 사용자 정보를 추가합니다.	REST API
고객 관리: 사용자 삭제하기	카카오톡 채널에 등록된 고객 파일에서 특정 사용자를 삭제합니다.	REST API