카카오톡 공유 템플릿 검증 응답에 다른 앱(네이티브 키)의 실행 스킴·마켓 URL이 내려오는 문제

문의 시, 사용하시는 SDK 버전 정보와 디벨로퍼스 앱ID를 알려주세요.

Faq 목록 - 10. Android ( Faq 목록 입니다 ) 먼저 확인해주세요.


안녕하세요. 카카오톡 공유(kakaolink) 기능에서 앱 실행 링크가 다른 앱의 값으로 생성되는 문제가 있어 서버측 앱 데이터 확인을 요청드립니다.

환경

  • 발신 앱: Android com.spoclipai.spoclip_frontend_app (스포클립 production, versionName 3.0.1)

  • 사용 네이티브 앱 키: 3aa7b61233fed40701f10e12550f76b0

  • 별도로 운영 중인 테스트용 앱의 네이티브 앱 키: bb0783c5e7c5d68c69849ff82bf13364 (Android 패키지 com.spoclipai.spoclip_frontend_app_preview 등록)

  • Kakao Android SDK 2.20.1 (shareDefault, Feed 템플릿)

증상

3aa7… 키로 카카오톡 공유 카드를 만들어 발송하면, 수신자가 카드를 탭했을 때 production 앱(com.spoclipai.spoclip_frontend_app)이 아니라 preview 앱의 스킴(kakaobb0783…://kakaolink)이 실행되고, 미설치 시 preview 패키지(…_preview)의 Play 스토어 페이지로 이동합니다.

재현 (100% 재현됩니다)

기본 템플릿 검증 API를 3aa7… 키로 직접 호출해도 동일합니다:

POST https://kapi.kakao.com/v2/api/kakaolink/talk/template/default?link_ver=4.0

Authorization: KakaoAK 3aa7b61233fed40701f10e12550f76b0

KA: sdk/2.20.1 sdk_type/kotlin os/android-36 lang/ko-KR origin/3z3p46TtIHNU1I8YTaioSgIcG7Q= device/SM-S938N android_pkg/com.spoclipai.spoclip_frontend_app app_ver/3.0.1

Content-Type: application/x-www-form-urlencoded

template_object={"object_type":"feed","content":{"title":"테스트","description":"테스트","image_url":"https://www.spoclip.ai/og-image.png","link":{"web_url":"https://www.spoclip.ai/recording/join/test","mobile_web_url":"https://www.spoclip.ai/recording/join/test","android_execution_params":"path=recording/join/test","ios_execution_params":"path=recording/join/test"}}}

이때 응답 template_msg / template_args에 아래 값이 내려옵니다:

  • ${ANDROID_EXECUTION_URL} / ${IOS_EXECUTION_URL} = kakaobb0783c5e7c5d68c69849ff82bf13364://kakaolink?...요청 키(3aa7)가 아닌 다른 키의 스킴

  • LA = market://details?id=com.spoclipai.spoclip_frontend_app_preview다른 앱의 패키지 마켓 URL

  • ai = 1125856

인증에 사용한 키는 3aa7…인데, 카드의 실행 스킴·마켓 폴백은 bb0783… 앱의 값으로 빌드되고 있습니다. 참고로 bb0783… 키로 동일 요청을 보내면 keyhash mismatch(-401)로 거부되므로, 두 키의 keyhash 등록은 분리돼 있는 상태입니다.

기대 동작

3aa7… 키로 생성한 공유 카드의 실행 링크는 kakao3aa7b61233fed40701f10e12550f76b0://kakaolink, 마켓 폴백은 market://details?id=com.spoclipai.spoclip_frontend_app 이어야 합니다. 콘솔의 “발급된 네이티브 앱 스킴” 화면에도 kakao3aa7…com.spoclipai.spoclip_frontend_app 매핑이 정상 표시되고 있습니다(캡처 첨부 가능).

요청 사항

  1. ai=1125856 앱과 네이티브 앱 키 3aa7… / bb0783…의 서버측 연결 관계 확인 부탁드립니다. (3aa7… 키가 어떤 앱에 귀속돼 있고, 왜 카카오링크 실행 정보가 bb0783… 스킴/preview 패키지로 빌드되는지)

  2. 원인이 콘솔에서 저희가 수정할 수 있는 설정이라면 해당 위치를 알려주시고, 서버측 데이터 문제라면 3aa7… 키의 실행 스킴·마켓 URL이 production 값으로 내려오도록 정정 부탁드립니다.

감사합니다.

참고정보.


5.1. 카카오톡 공유 문제 상황 체크 리스트
5.2. 텍스트 영역 글자수 제한
5.3. 이미지 사용 안내, 첨부 이미지 형식 제한
5.4 [카카오톡 공유] 버튼 링크가 동작하지 않아요 / 다른 페이지로 이동합니다.

가이드. 카카오톡 공유 에러코드
가이드. 카카오톡 공유 FAQ

[ @tim.l @woody.ho ]

안녕하세요.

수신자가 카드를 탭했을때,

디벨로퍼스앱에설정된 “제품 링크 관리” 메뉴의 기본 도메인 및 기본 앱스킴으로 링크 설정됩니다.

네이티브앱 스킴은 카카오 SDK를 설정한 앱의 커스텀 스킴 kakaoXXXXX 를 호출 하게됩니다.

즉, 현재 기본 스킴으로 설정된 kakaobb0783…://kakaolink 이 실행되는 것이 정상동작입니다.

확인 부탁드립니다.


동일 디벨로퍼스앱내 설정된 다른 네이티브앱키 커스텀 스킴을 호출하고자 하는 경우,

도구 > 메시지 템플릿 구성에서 생성한 템플릿 공통 설정 > 네이티브 앱 스킴을 변경하시면됩니다.


메시지를 코드로 구성하는 기본템플릿에서는 출처 링크 네이티브앱 스킴을 변경할 수 없습니다.

참고 부탁드려요.