FAQ

이 문서는 메시지에 대해 자주 묻는 질문과 답변을 제공합니다.

공통

Q. URL로 지정한 이미지가 표시되지 않습니다.

카카오톡 공유나 카카오톡 메시지 API로 메시지를 보낼 때 이미지를 URL로 지정한 경우 아래 이유로 이미지가 표시되지 않을 수 있습니다.

• 이미지 URL에 카카오 스크랩 서버가 접근할 수 없는 경우
• 이미지 용량 제한(5MB)을 초과한 경우

먼저 지정한 이미지 URL이 외부망에서 접근 가능한지를 확인합니다. 서비스 내부망에서만 접근 가능한 URL을 사용하지 않아야 합니다.

외부에서 접근 가능한 URL인 경우 스크랩 허용을 위한 방화벽 설정을 참고해 카카오 스크랩 서버의 IP를 허용하도록 설정합니다. 또는 메시지 템플릿 도구나 이미지 업로드하기 API를 사용해 사전에 이미지를 업로드한 후 메시지를 보낼 수도 있습니다.

Q. 스크랩한 미리보기 이미지가 바뀌지 않습니다.

카카오톡 공유나 카카오톡으로 메시지를 보낼 때 미리보기 이미지나 문구 변경 사항이 반영되지 않는 경우가 있습니다. 이는 캐시(cache) 데이터 때문에 생기는 현상으로 [도구] > [초기화 도구] > [OG(Open Graph) 캐시] 메뉴에서 카카오 플랫폼에 저장된 웹 페이지나 파일의 URL을 입력하여 캐시 데이터를 삭제할 수 있습니다.

만약 캐시 데이터를 삭제한 후에도 기존 이미지나 문구가 나타난다면, 다음 내용을 참고합니다.

• 웹 페이지를 스크랩한 경우, og 태그 값이 올바르게 입력되어 있는지 확인하기
• 메시지의 경우, 카카오톡 대화방을 나갔다가 다시 만들어 테스트 메시지 보내기

보다 자세한 내용은 관련 공지를 확인합니다. 스크랩 메시지에 사용하는 og 태그 정보는 메시지 템플릿 가이드를 참고합니다.

카카오 플랫폼에서는 OG 프로토콜에 따라 웹 페이지의 정보를 가져와 사용할 뿐, 웹 페이지 데이터를 변경하지 않습니다. 때문에 캐시 초기화 도구를 통한 삭제 외 개별 조치가 어렵습니다. 만약 캐시 초기화 도구가 동작하지 않거나, 다른 이상 현상이 발견될 경우에는 데브톡으로 문의합니다.

Q. 메시지의 버튼과 링크는 어떻게 설정하나요?

카카오톡 공유와 카카오톡 메시지 API로 보내는 메시지는 이미지, 텍스트, 버튼에 지정된 링크 경로를 설정할 수 있습니다. 이 링크 주소는 기본적으로 [내 애플리케이션] > [플랫폼]에 설정된 정보를 따릅니다. 메시지의 링크와 버튼의 애플리케이션(앱) 실행 경로는 Android 패키지 이름과 마켓 URL, iOS 번들 ID와 마켓 URL을 설정대로 동작합니다. 웹 페이지로 이동하도록 링크를 설정하는 경우에는 웹 플랫폼의 URL을 따릅니다.

[도구] > [메시지 템플릿]에서 링크와 버튼에 지정된 경로를 수정하거나, 클라이언트 또는 서버에서 메시지를 구성할 경우에 링크 값을 지정하는 경우에도 앱 설정을 따르며, 일부 정보를 추가 입력할 수 있습니다. 웹사이트의 도메인은 플랫폼 설정에 등록된 도메인 중 하나를 사용 가능하고, 하위 경로는 직접 입력할 수 있습니다. Android와 iOS의 경우, 앱 실행 시 전달할 파라미터를 지정할 수 있습니다.

링크와 버튼에는 여러 플랫폼의 정보를 입력할 수 있지만, 동작 시 우선 순위에 따라 사용자를 이동시킵니다. 웹사이트로 이동하는 경우에는 사용자가 PC와 모바일 기기 중 어디에서 링크나 버튼을 눌렀는지에 따라 다르게 동작합니다. PC인 경우에는 윈도우즈(Windows), 맥(Mac) OS별로 앱 실행 경로를 지정할 수도 있습니다. 앱 실행인 경우에는 앱이 설치되어 있다면 실행하고, 그렇지 않다면 마켓 주소로 이동합니다.

Q. 메시지에 설정한 버튼이 나오지 않습니다.

사용자가 메시지를 확인한 카카오톡의 실행 환경, [내 애플리케이션] > [플랫폼] 설정에 따라 메시지 버튼이 출력되지 않을 수 있습니다. 메시지에 버튼을 설정했음에도 사용자 환경에 따라 버튼이 출력되지 않아 어색해보이는 현상을 막으려면 앱의 플랫폼 설정에 Web 도메인을 등록합니다. Web 플랫폼 및 도메인이 등록되어 있을 경우, 사용자의 카카오톡 실행 환경에 따라 버튼에 적용 가능한 링크가 없더라도 Web 플랫폼 설정이 공통 링크로써 버튼에 적용되어 출력됩니다. 자세한 내용은 메시지 템플릿을 참고합니다.

Q. 메시지의 앱 실행 버튼이 정상 동작하지 않습니다.

메시지의 앱 실행 버튼을 눌러도 아무런 반응이 없거나, 오픈마켓으로 이동하는 경우에 해당합니다.

먼저, 메시지를 받고 앱을 실행하려는 기기에 해당 앱이 설치되어 있는지 확인합니다.

앱이 설치되어 있다면, Android SDK 사용자는 커스텀 URL 스킴 설정하기, iOS SDK 사용자는 Info.plist 설정을 참고하여 해당 앱에 카카오톡 공유 커스텀 URL 스킴 생성을 위한 정보가 올바르게 설정되어 있는지 확인합니다.

앱이 설치되어 있지 않다면 [내 애플리케이션] > [플랫폼]에서 해당 앱의 Android 및 iOS 마켓 URL이 설정되어 있는지 확인합니다.

카카오톡 공유

Q. 사이트 주소 변경 후 카카오톡 공유 오류가 발생합니다.

카카오톡이나 카카오톡 공유 메시지 API는 앱의 플랫폼 설정에 등록된 도메인에서만 정상 동작합니다. 메시지 API 이용 시 웹, Android, iOS 중 서비스에서 사용 중인 플랫폼을 반드시 등록하여야 하며, 사이트 주소 변경 시 바뀐 도메인을 플랫폼 정보에 추가하여야 합니다. 메시지에 포함된 버튼과 링크는 앱 설정을 바탕으로 설정되며, 등록되지 않은 도메인 주소는 메시지 링크에 사용할 수 없습니다.

카카오톡 메시지

Q. 카카오톡 메시지는 카카오톡 공유와 무엇이 다른지 궁금합니다.

기능 소개에서 차이점을 확인할 수 있습니다.