이 문서는 카카오톡 채널(구, 플러스친구) API 및 연동 관련 자주 묻는 질문과 답변을 제공합니다.

네, 카카오톡 채널 추가 API는 무료로 제공됩니다.
다만, 사용량이 많아질 경우 쿼터 제한이 적용될 수 있습니다. 자세한 내용은 쿼터 안내를 참고하세요.

1. 카카오 디벨로퍼스에서 앱을 생성합니다.
2. 카카오톡 채널 파트너센터에서 채널을 개설합니다.
3. 디벨로퍼스 앱과 카카오톡 채널을 연결합니다.
4. 카카오톡 채널 추가 API 가이드를 참고하여 연동을 진행합니다.

앱과 카카오톡 채널이 정상적으로 연결되어 있는지 확인하세요.

• 앱 관리 페이지의 [앱] > [카카오톡 채널]에서 채널이 연결되어 있는지 확인합니다.
• 채널이 연결되어 있지 않다면, 채널 연결 가이드를 참고하여 연결을 완료하세요.

아래와 같은 경우에 해당 에러가 발생할 수 있습니다.

• 이미 해당 사용자가 채널을 추가한 경우
• 채널이 비공개 또는 운영 중지 상태인 경우
• 채널이 카카오싱크 미설정 상태인 경우

채널의 상태를 확인하고, 필요 시 카카오톡 채널 파트너센터에서 설정을 변경하세요.

카카오톡 인앱 브라우저, 일부 외부 브라우저(웹뷰)에서는 정상 동작하지 않을 수 있습니다.
최적의 동작을 위해서는 카카오톡 앱 또는 기본 브라우저에서 실행하는 것을 권장합니다.

• 리다이렉트 URI가 앱 설정에 등록되어 있는지 확인하세요.
• 리다이렉트 URI에 한글, 특수문자가 포함된 경우 인코딩하여 등록해야 합니다.
• 카카오톡 인앱 브라우저에서는 팝업/리다이렉트가 제한될 수 있으니, 외부 브라우저 열기를 안내하는 것이 좋습니다.

카카오톡 채널 추가 API는 채널 추가 여부만을 제공합니다.
사용자 정보를 수집하려면 카카오싱크를 연동하여 로그인 및 동의 절차를 진행해야 합니다.

쿼터 상향이 필요한 경우, 쿼터 상향 신청 가이드를 참고하여 신청해 주세요.

• 테스트용 카카오톡 채널을 개설하고, 디벨로퍼스 앱과 연결합니다.
• 테스트 계정(카카오계정)으로 채널 추가 API를 호출하여 정상 동작을 확인합니다.
• 실제 서비스 적용 전, 모든 시나리오(이미 추가된 경우, 미추가 상태 등)를 점검하세요.

• 카카오톡 채널 추가 API 가이드
• 카카오싱크 가이드
• 카카오톡 채널 파트너센터
• 데브톡 FAQ

비즈니스 채널이 표시되지 않는 경우는 다음과 같은 조건을 만족해야 합니다:

매니저 또는 마스터 권한이 있는 채널 (권한 확인) 디벨로퍼스 앱과 동일한 사업자 번호가 등록된 채널 (사업자번호 확인) 다른 디벨로퍼스 앱과 연결되지 않은 채널 (연결된 비즈앱 정보 확인)

https://devtalk.kakao.com/t/topic/145442