이해하기

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

기능 소개

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

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

카카오톡 채널 API는 아래 기능을 제공합니다.

• 카카오톡 채널 추가: Kakao SDK를 활용한 간편한 채널 추가 요청
• 카카오톡 채널 고객 관리: 채널 관리자의 편리한 고객 그룹 관리 지원
• 카카오톡 채널 관계 관리: 채널 친구 관계 확인 및 알림 수신

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

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

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

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

카카오톡 채널 추가

Kakao SDK를 활용한 카카오톡 채널 추가 요청 방법에 대해 안내합니다. 사용자가 서비스의 카카오톡 채널을 추가하면, 서비스는 이를 다양한 소식과 기능을 제공하는 창구로 활용할 수 있습니다.

지원하는 방식

Kakao SDK는 서비스 환경에 따라 선택 가능한 두 가지 카카오톡 채널 추가 방식을 제공합니다. 아래 각 항목에서 방식별 자세한 내용을 확인할 수 있습니다.

구현 방식	메서드명	서비스 페이지 유지	결과 확인
카카오톡 채널 간편 추가하기(권장)	followChannel()	서비스 페이지에서 채널 추가 화면을 바로 노출	결과를 요청의 응답으로 확인 가능
카카오톡 채널 추가하기	addChannel()	연결 페이지로 카카오톡 내 채널 페이지 이동 여부 확인, 사용자 동의 시 페이지 이탈 후 채널 추가	카카오톡 채널 관계 확인하기 요청으로 별도 확인 필요

카카오톡 채널 간편 추가하기

카카오톡 채널 간편 추가하기(followChannel())는 서비스 페이지에서 바로 카카오톡 채널 추가를 요청하고, 응답으로 결과를 확인할 수 있는 기능입니다. 서비스는 사용자의 카카오톡 채널 추가 결과를 응답으로 제공받아 상황에 맞는 기능을 간편하게 제공할 수 있습니다.

만약 카카오톡 채널 추가 불가능 상태의 사용자에게 요청한 경우, 각 상태에 따른 안내 화면이 표시됩니다.

아래 주요 표시 화면과 카카오 로그인 사용 여부에 따른 카카오톡 채널 추가 요청 방법을 참고합니다.

카카오 로그인 사용 서비스

카카오 로그인을 사용하는 서비스 화면에서 사용자가 카카오톡 채널 추가 버튼 또는 배너 선택 시, 사용자의 카카오 로그인 여부에 따라 카카오톡 채널 추가 요청을 처리해야 합니다.

로그인한 사용자

1. 서비스에서 followChannel() 요청
2. 카카오톡 채널 추가 화면 표시됨
3. 사용자의 카카오톡 채널 추가 여부를 응답으로 수신

로그인하지 않은 사용자

1. 서비스에서 카카오 로그인 요청
2. 카카오 로그인 동의 화면 표시됨
   • 사용자는 카카오 로그인 동의 화면에서 카카오톡 채널 추가 가능
3. 사용자 로그인 후 카카오톡 채널 관계 확인하기로 사용자의 카카오톡 채널 추가 정보 확인
   • 추가한 경우: 상황에 맞는 기능 제공(예: 카카오톡 채널 추가 사용자를 위한 서비스 화면 제공 등)
   • 추가하지 않은 경우: 로그인한 사용자 과정으로 카카오톡 채널 추가 요청

카카오 로그인 미사용 서비스

카카오 로그인을 사용하지 않는 서비스 화면에서 사용자가 카카오톡 채널 추가 버튼 또는 배너 선택 시, 아래 과정으로 카카오톡 채널 추가 요청을 처리합니다.

1. 서비스에서 followChannel() 요청
2. 카카오계정 로그인 화면 표시됨
3. 사용자 로그인 후 카카오톡 채널 추가 화면 표시됨
4. 사용자의 카카오톡 채널 추가 여부를 응답으로 수신

카카오톡 채널 추가하기

카카오톡 채널 추가하기(addChannel())는 카카오톡 채널 추가 버튼이 포함된 연결 페이지(Bridge page)를 제공하는 기능입니다. 연결 페이지에서 사용자가 [채널 추가]를 선택하면 커스텀 URL 스킴(Custom URL Scheme)으로 카카오톡을 실행하고, 해당 카카오톡 채널 화면으로 이동합니다. 사용자의 카카오톡 채널 추가 여부를 확인하려면 카카오톡 채널 관계 확인하기를 별도로 요청해 확인해야 합니다.

서비스 페이지 내에서 바로 카카오톡 채널 추가를 요청할 수 있고, 별도의 확인 절차 없이 응답으로 결과를 확인할 수 있는 카카오톡 채널 간편 추가하기(followChannel()) 사용을 권장합니다.

카카오톡 채널 고객 관리

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

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

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

카카오톡 채널 관계 관리

카카오톡 채널 관계 확인하기

카카오톡 채널 관계 확인하기 API로 각 사용자의 카카오톡 채널 추가 상태를 확인할 수 있습니다. 사용자의 카카오톡 채널 추가 상태에 따라 카카오톡 채널과 친구가 아닌 사용자에게 친구 추가를 유도하거나 고객 파일에서 사용자를 제외할 수 있습니다. 아래 개발 가이드를 참고합니다.

• REST API
• JavaScript
• Android
• iOS

카카오톡 채널 웹훅

카카오톡 채널 웹훅을 사용하면 사용자가 서비스와 연결된 카카오톡 채널을 추가 또는 차단했을 때 알림을 받을 수 있습니다.

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

지원하는 기능

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

API 및 기능	설명	문서
카카오톡 채널 간편 추가하기	사용자에게 지정된 카카오톡 채널의 친구 추가를 요청합니다.	JavaScript Android iOS Flutter
카카오톡 채널 추가하기	사용자가 지정된 카카오톡 채널을 친구로 추가할 수 있는 연결 페이지를 제공합니다.	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