💬 기능 추가 가이드

카카오 공유 버튼 만드는 법
홈페이지에 카카오톡 공유 기능 추가하기

📅 2026년 5월 15일 ✍️ 뚝딱닷컴 ⏱️ 6분 읽기 👁 -

📤 링크를 카카오톡으로 바로 공유하고 싶다

홈페이지를 만들었고, 주변에 알리고 싶다. 카카오톡이 가장 편하다. 버튼 하나 누르면 링크와 미리보기 이미지가 채팅창으로 날아가면 좋겠다.

카카오 공유 버튼은 만들 수 있다. 카카오가 공식 SDK를 무료로 제공한다. 근데 생각보다 막히는 부분이 있다. 코드가 맞는데 왜 안 되지? 싶은 상황이 꼭 한 번은 온다. 이 글에서 그 이유까지 같이 설명한다.

📌

카카오 공유 SDK는 완전 무료예요. 카카오 개발자 계정만 만들면 됩니다. 사업자 등록이나 심사 같은 건 필요 없어요.

💛 카카오 공유 버튼이 뭔가요?

버튼을 누르면 카카오톡 친구나 채팅방에 사이트 링크를 공유할 수 있는 기능이다. 단순 링크가 아니라 사이트 제목, 설명, 미리보기 이미지까지 함께 전송된다. 뉴스 기사나 쇼핑몰에서 흔히 보는 그 노란 버튼이다.

카카오 공식 JavaScript SDK를 사용하기 때문에 카카오 개발자 계정이 필요하다. 여기서 발급받은 JavaScript 키를 코드에 넣어야 작동한다. 계정 만들기부터 키 발급까지 5분이면 된다.

📦 준비물

세 가지가 필요하다. 아직 도메인이 없다면 먼저 도메인을 연결하고 오는 게 좋다.

💡

아직 도메인이 없다면 Netlify 기본 주소(예: mysite.netlify.app)로도 진행할 수 있어요. 나중에 도메인을 붙이면 카카오 개발자 센터에서 도메인만 추가 등록하면 됩니다.

🪜 만드는 순서

카카오 개발자 센터 설정부터 코드 삽입까지 여섯 단계다.

1
카카오 개발자 센터 가입 developers.kakao.com 접속 → 우측 상단 "로그인" → 카카오 계정으로 로그인 → 개발자 등록 동의. 카카오 계정만 있으면 바로 된다.
2
앱 만들기 "내 애플리케이션" → "애플리케이션 추가하기" 클릭. 앱 이름과 사업자명(개인이면 본인 이름)을 입력하고 저장.
3
JavaScript 키 발급 앱 선택 → "앱 키" 탭에서 JavaScript 키를 복사해둔다. 이 키가 코드에 들어갈 인증값이다.
4
도메인 등록 앱 설정 → "플랫폼" → "Web 플랫폼 등록" → 내 사이트 주소 입력. http와 https 둘 다 등록해야 한다. 자세한 내용은 아래 주의사항 참고.
5
코드 삽입 HTML 파일의 <head>에 카카오 SDK 스크립트를 추가하고, 공유 버튼을 넣을 위치에 버튼 코드를 삽입한다. AI한테 "카카오 공유 버튼 추가해줘. JavaScript 키는 XXXXXXXX야"라고 하면 된다.
6
Netlify에 배포 후 테스트 수정된 파일을 Netlify에 다시 올리고, 실제 사이트 주소에서 버튼을 눌러 테스트한다. 로컬(내 컴퓨터)에서 테스트하면 안 된다. 이유는 아래 섹션에서 설명한다.

🚧 가장 많이 막히는 부분 — 로컬에서 테스트하지 말 것

코드를 다 넣었다. VS Code에서 파일을 열고 버튼을 눌렀다. 그런데 아무 반응이 없거나 "요청 실패" 오류가 뜬다. 코드가 잘못된 줄 알고 한 시간을 찾는다.

코드는 맞다. 문제는 테스트 환경이다.

⚠️

카카오 SDK는 등록된 도메인에서만 작동한다. 내 컴퓨터에서 파일을 직접 열면 주소가 file:///C:/... 또는 localhost가 되는데, 이건 카카오 개발자 센터에 등록한 도메인이 아니다. 당연히 막힌다.

뚝딱닷컴도 처음에 이 함정에 빠졌다. 코드를 세 번 다시 짜고, AI한테도 두 번 물어보고 나서야 Netlify에 올리고 실제 주소로 테스트해야 한다는 걸 알았다. 반드시 Netlify에 배포한 다음, 실제 사이트 주소에서 버튼을 눌러야 한다.

배포했는데도 "요청 실패"가 뜨면요?
도메인 등록을 확인해보자. 카카오 개발자 센터 → 내 앱 → 플랫폼 → Web 사이트 도메인 목록에 현재 접속한 주소가 정확히 등록돼 있는지 확인한다. 예를 들어 https://mysite.com으로 접속했는데 http://mysite.com만 등록돼 있으면 안 된다. http와 https를 둘 다 등록해야 한다.
공유했을 때 미리보기 이미지가 안 나와요
카카오 공유 SDK의 imageUrl 파라미터에 이미지 주소가 제대로 들어가 있는지 확인하자. 이미지는 절대 경로(https://로 시작하는 전체 URL)로 넣어야 한다. 상대 경로(./images/og.png 같은 형태)로 넣으면 카카오 서버가 이미지를 가져오지 못한다.

⚙️ 도메인 등록 주의사항 — http와 https 둘 다

카카오 개발자 센터에서 도메인을 등록할 때 한 가지를 꼭 챙겨야 한다. http와 https 두 가지를 모두 등록해야 한다.

하나만 등록하면 나머지 프로토콜에서 접속했을 때 공유 버튼이 오류를 낸다. 등록은 한 줄씩 입력하면 되고, 저장 후 바로 적용된다.

💡

도메인을 나중에 추가하거나 바꿔도 괜찮아요. 카카오 개발자 센터에서 언제든 수정할 수 있어요. Netlify 기본 주소(netlify.app)를 쓰다가 커스텀 도메인으로 바꿨다면 새 도메인을 추가 등록하면 됩니다.


✅ 마무리 — 버튼 하나로 방문자가 직접 홍보해준다

카카오 공유 버튼이 달렸다면, 이제 방문자가 직접 내 사이트를 퍼뜨려줄 수 있다. 내가 직접 링크를 보내는 것보다 지인이 공유해주는 게 훨씬 효과적이다. 신뢰가 함께 전달되기 때문이다.

공유 버튼은 눈에 띄는 곳에 배치하는 게 중요하다. 블로그 글 상단이나 하단, 또는 소개 페이지 아래쪽이 좋다. 스크롤을 많이 내리지 않아도 보이는 위치면 공유율이 올라간다.

카카오 개발자 센터 가입부터 공유 버튼 코드 삽입까지 전체 과정은 뚝딱닷컴 교재 11장에 스크린샷과 함께 담겨 있다.

카카오 공유 버튼 전체 구현 과정을
교재 11장에서 확인할 수 있어요.

📖 교재 11장 — 카카오 공유 버튼 전체 과정 보기