카카오 스마트 버튼 사용 가이드

한눈에 보기
스마트 버튼은 알림톡 · 브랜드 메시지의 웹 링크 버튼을 누가 · 언제 · 어떤 버튼을 눌렀는지 기록되는 추적 링크로 바꿔 주는 기능입니다. 템플릿 버튼 하나만 지정해 두면, 이후 발송부터 클릭이 자동으로 쌓이고 콘솔에서 바로 확인할 수 있습니다.
이런 고민이 있다면 | 스마트 버튼으로 |
|---|---|
알림톡을 보냈는데 실제로 버튼을 눌렀는지 모르겠다 | 메시지마다 버튼 클릭 여부와 클릭 시각을 확인 |
어떤 템플릿 · 어떤 버튼이 반응이 좋은지 비교하고 싶다 | 템플릿 성과에서 버튼별 · 시간대별 클릭을 한 화면에 |
받는 사람마다 다른 주소(주문 상세 · 예약 확인)로 보내고 싶다 | 발송할 때 변수 · 엑셀 열로 수신자별 주소를 조합 |
템플릿 버튼 주소를 바꾸려면 재검수가 번거롭다 | 이동할 주소는 솔라피에서 관리 — 카카오 재검수 없이 변경 |
핵심 장점
베타 기간 무료 — 베타 기간 동안에는 발송 요금 외에 추가 비용 없이 클릭 추적과 성과 화면을 모두 쓸 수 있습니다.
재검수 없이 시작 — 이미 승인된 템플릿의
https://#{변수}웹 링크 버튼을 그대로 지정합니다.수신자별 목적지 — 주문번호 · 예약번호 같은 값을 넣어 사람마다 다른 페이지로 보낼 수 있습니다.
한 번 열린 링크는 계속 유지 — 받는 사람이 한 번이라도 누른 링크는 시간이 지나도 원래 주소로 열립니다.
1단계 · 템플릿 버튼을 스마트 버튼으로 지정하기
템플릿의 웹 링크 버튼에서 스마트 버튼 스위치를 켜면 끝입니다. 버튼 주소는 https://#{button-url-01} 처럼 변수 하나로 바뀌고, 실제로 이동할 주소는 솔라피가 발송할 때 채워 넣습니다.
카카오 · 네이버 · RCS → 알림톡 템플릿에서 템플릿을 만들거나 열고, 버튼 동작을 웹사이트 열기로 고릅니다.
스마트 버튼 스위치를 켭니다. 변수 이름은
button-url-01,button-url-02처럼 버튼 순서대로 자동으로 채워지며, 원하는 이름으로 바꿔도 됩니다.URL 주소 기본 값에 평소 이동할 주소를 넣습니다. 발송할 때 따로 주소를 정하지 않으면 이 주소로 이동합니다.
PC에서 다른 페이지를 열고 싶다면 PC에서는 다른 주소 열기를 켭니다. PC 변수(
button-url-01-pc)도 같은 방식으로 추적됩니다.

이미 승인된 템플릿도 버튼 주소가
https://#{변수}하나로만 되어 있다면 재검수 없이 바로 지정할 수 있습니다. 기본 주소를 바꿔도 카카오 검수를 다시 받지 않습니다.
2단계 · 메시지 보내기에서 목적지 정하기
스마트 버튼이 지정된 템플릿을 고르면 카카오톡 버튼 영역에 버튼마다 기본 값 | 새로 입력 선택이 나타납니다. 버튼이 여러 개여도 버튼별로 따로 정할 수 있습니다.
선택 | 이동하는 곳 | 언제 쓰나 |
|---|---|---|
기본 값 | 템플릿에 저장한 기본 주소 | 모두 같은 페이지로 보낼 때. 나중에 기본 주소를 바꾸면 이미 보낸 버튼도 새 주소로 이동 |
새로 입력 | 이번 발송에서 입력한 주소 | 이번 캠페인만 다른 페이지, 또는 수신자마다 다른 페이지로 보낼 때 |

수신자마다 다른 주소 만들기
"새로 입력" 입력란 아래의 변수 칩을 눌러 주소에 끼워 넣으면 됩니다. 예를 들어 https://shop.example.com/orders/ 뒤에 주문번호 칩을 넣으면, 받는 사람마다 자기 주문 상세로 이동합니다.
오렌지 칩 — 알림톡 템플릿 변수
남색 칩 — 수신자 목록(엑셀 · 주소록)의 열
칩을 눌러 다른 변수로 바꾸거나 지울 수 있고, 한글 입력 · 붙여넣기 · 되돌리기도 그대로 됩니다.

링크는 얼마나 유지되나요?
"새로 입력"으로 보낸 링크는 한 번이라도 클릭되면 계속 원래 주소로 열립니다. 60일 동안 한 번도 클릭되지 않은 링크는 템플릿 기본 주소로 이동합니다.
이번 발송만 추적하고 싶지 않다면 스마트 버튼 클릭 추적 안함을 체크하세요. 버튼은 원래 주소 그대로 나갑니다.
3단계 · 결과 확인하기
발송이 끝나면 별도 설정 없이 세 곳에서 클릭을 볼 수 있습니다. 이번 발송 → 메시지 한 건 → 템플릿 전체 순서로, 보고 싶은 범위만큼 좁히거나 넓혀 보세요.
이번 발송의 반응: 발송 내역 → 그룹 상세
메시지 → 발송 내역에서 그룹을 열면 그룹 요약에 버튼 반응 카드가 나타납니다. 클릭률과 누른 사람 수를 바로 보여 주고, 미리보기에서는 실제로 눌린 버튼에 클릭함 표시가 붙습니다.

버튼 반응 탭에서는 이번 발송을 더 자세히 봅니다.
전달 성공 · 버튼 클릭 · 클릭률 — 전달된 건수 대비 누른 사람 비율
클릭까지 걸린 시간(중앙값) — 받은 뒤 얼마 만에 누르는지
발송 후 시간에 따른 누적 클릭 — 10분 · 1시간 · 24시간 · 3일 안에 클릭이 얼마나 모였는지
버튼별 클릭 — 버튼이 여러 개라면 어떤 버튼이 많이 눌렸는지(모바일 · PC 합산, 한 사람이 여러 번 눌러도 1명)

메시지 한 건의 반응: 클릭 열
그룹 상세의 메시지 목록과 건별 내역에는 클릭 열이 있습니다. 주황 손가락 아이콘은 그 사람이 버튼을 눌렀다는 뜻이고, 빈 동그라미는 아직 누르지 않았다는 뜻입니다. 고객 문의가 왔을 때 "안내 링크를 열어 보셨는지"를 바로 확인할 수 있습니다.

템플릿 전체의 성과: 알림톡 템플릿 → 템플릿 성과
알림톡 템플릿 목록의 미리보기에는 최근 클릭률이 표시되고, 템플릿 성과에서는 그 템플릿으로 보낸 모든 발송을 기간별로 모아 봅니다.

지표 | 알 수 있는 것 |
|---|---|
발송 · 전달 · 클릭 · 클릭률 | 템플릿이 실제로 얼마나 반응을 끌어내는지 |
일별 추이 | 문구 · 버튼을 바꾼 뒤 클릭률이 올랐는지 |
버튼별 클릭 | 어떤 버튼이 핵심 동선인지, 빼도 되는 버튼은 무엇인지 |
시간대별 클릭 · 클릭까지 걸린 시간 | 언제 보내야 가장 잘 눌리는지 |

클릭은 몇 분 늦게 반영될 수 있습니다. 방금 보낸 발송이 0으로 보여도 잠시 뒤 새로고침해 보세요.
이렇게 활용하세요
스마트 버튼은 "보냈다"에서 끝나던 알림톡을 "누가 반응했는지 아는" 알림톡으로 바꿉니다. 지금 보내는 알림톡에 버튼 하나만 지정해도 바로 달라지는 것들입니다.
업종 · 상황 | 버튼 예시 | 스마트 버튼으로 얻는 것 |
|---|---|---|
쇼핑몰 · 주문 완료 | 주문 상세 보기 | 주문번호별 상세 페이지로 바로 연결, 배송 문의 전에 고객이 먼저 확인했는지 파악 |
병원 · 미용실 · 레스토랑 예약 | 예약 확인 · 변경 | 안내를 열어 본 고객과 안 열어 본 고객을 구분해 노쇼 방지 안내를 골라서 보냄 |
결제 실패 · 미납 안내 | 다시 결제하기 | 재결제 페이지 진입률을 바로 확인, 누르지 않은 고객에게만 재안내 |
리뷰 · 설문 요청 | 리뷰 쓰기 | 문구나 발송 시간을 바꿀 때마다 클릭률 변화를 비교 |
교육 · 이벤트 안내 | 신청하기 · 자세히 보기 | 버튼별 클릭으로 어떤 동선이 실제 신청으로 이어지는지 확인 |
운영이 가벼워지는 점
주소 변경에 재검수가 필요 없습니다. 페이지 개편 · 도메인 변경이 있어도 템플릿 기본 주소만 바꾸면 이미 보낸 "기본 값" 버튼도 새 주소로 이동합니다.
템플릿 하나로 여러 캠페인을 돌릴 수 있습니다. 발송할 때마다 "새로 입력"으로 목적지만 바꾸면 되므로, 캠페인마다 템플릿을 새로 만들고 검수를 기다릴 필요가 줄어듭니다.
"열어 보셨나요?" 확인이 즉시 됩니다. 고객 문의가 왔을 때 건별 내역의 클릭 열만 보면 안내 링크를 열었는지 알 수 있습니다.
SOLAPI CRM과 함께 쓰면
스마트 버튼은 클릭을 기록하는 데서 멈추지 않고 다음 행동으로 이어집니다.
CRM 비즈니스폼으로 보내기 — 버튼 목적지를 웹 주소 대신 CRM 비즈니스폼으로 고르면, 상담 신청 · 설문 · 예약 요청을 별도 페이지 없이 바로 받을 수 있습니다.
버튼에 자동화 연결 — 버튼 설정의 "버튼에 자동화를 추가"에서 CRM 자동화를 고르면, 버튼을 누른 고객을 기준으로 후속 메시지 · 담당자 배정 같은 다음 단계를 이어 갈 수 있습니다.
발송 내역에서 바로 클릭률 확인 — CRM을 쓰면 발송 내역 목록의 클릭률 열에서 그룹별 클릭률을 한눈에 비교할 수 있습니다.
추천 시작 방법: 가장 많이 보내는 알림톡 템플릿 하나에 스마트 버튼을 지정하고, 일주일 뒤 템플릿 성과에서 시간대별 클릭을 확인해 보세요. 발송 시간만 바꿔도 반응이 달라지는 것을 바로 볼 수 있습니다.
자주 묻는 질문
Q. 요금이 따로 있나요?
현재 베타 기간에는 무료입니다. 알림톡 · 브랜드 메시지 발송 요금만 내면 클릭 추적과 성과 화면을 추가 비용 없이 쓸 수 있습니다. 베타 이후 요금 정책이 정해지면 미리 안내해 드립니다.
Q. 이미 승인된 템플릿도 쓸 수 있나요?
버튼 주소가 https://#{변수} 하나로만 되어 있는 웹 링크 버튼이라면 재검수 없이 바로 지정할 수 있습니다. 주소가 https://shop.example.com 처럼 고정되어 있다면, 변수 형태로 바꾸는 검수가 한 번 필요합니다.
Q. 보낸 링크는 언제까지 열리나요?
기본 값으로 보낸 버튼은 기간과 상관없이 항상 템플릿의 현재 기본 주소로 이동합니다.
새로 입력으로 보낸 버튼은 한 번이라도 클릭되면 계속 그 주소로 열립니다. 60일 동안 한 번도 클릭되지 않았다면 그 뒤에는 기본 주소로 이동합니다.
어느 경우든 받는 사람이 깨진 링크를 만나지 않도록, 기본 주소는 항상 채워 두는 것을 권장합니다.
Q. 다른 계정과 공유한 템플릿은 어떻게 되나요?
스마트 버튼 지정과 기본 주소 변경은 템플릿을 소유한 계정만 할 수 있습니다. 공유받은 계정은 설정을 바꾸거나 목적지를 가로채지 못하므로, 안심하고 공유해도 됩니다.
Q. 개인정보는 안전한가요?
버튼 링크에는 전화번호 같은 개인정보가 들어가지 않습니다. 메시지마다 위조할 수 없는 서명된 값만 담기며, 클릭 기록은 발송한 계정의 콘솔에서만 볼 수 있습니다.
Q. 클릭은 어떻게 세나요?
항목 | 기준 |
|---|---|
한 사람이 여러 번 누름 | 메시지 · 버튼별 1번으로 셈 |
모바일과 PC | 합산해서 보여 줌 |
집계 시작 시점 | 스마트 버튼을 지정한 뒤 보낸 메시지부터 |
반영 시간 | 보통 몇 분 이내 |
추적 안함으로 보낸 발송 | 집계에서 제외 |
Q. 특정 발송만 추적하지 않을 수 있나요?
메시지 보내기에서 스마트 버튼 클릭 추적 안함을 체크하면 그 발송은 추적 없이 원래 주소로 나갑니다. 템플릿 설정은 그대로 유지됩니다.
개발자를 위한 안내 (API 발송)
API로 알림톡을 보내고 있다면 코드를 한 줄도 고치지 않고 스마트 버튼을 쓸 수 있습니다. 콘솔에서 템플릿 버튼을 지정하면, 지금 보내는 요청 그대로 클릭 추적이 붙고 결과는 콘솔에 쌓입니다.
하지 않아도 되는 것
요청 형식 변경 —
kakaoOptions.variables에 값을 넣는 방식 그대로입니다. 새 엔드포인트 · 새 필드가 필요 없습니다.추적 링크 만들기 — 단축 URL을 미리 만들거나 리다이렉트 서버를 두지 않아도 됩니다. 발송 단계에서 자동으로 바뀝니다.
클릭 수집 · 집계 — 클릭 로그를 받는 서버나 통계 배치를 만들 필요가 없습니다. 발송 내역 · 템플릿 성과에서 바로 봅니다.
변수 이름 바꾸기 — 기존 버튼 변수 이름을 그대로 쓸 수 있습니다.
button-url-01은 콘솔에서 새로 만들 때의 기본값일 뿐입니다.재검수 — 버튼 주소가 이미
https://#{변수}하나로만 되어 있다면 카카오 검수를 다시 받지 않습니다.
해야 하는 것
콘솔에서 템플릿의 웹 링크 버튼을 스마트 버튼으로 지정하고 URL 주소 기본 값을 넣습니다(1단계 참고).
발송 요청에
kakaoOptions.templateId를 넣습니다. 스마트 버튼은 templateId 로 보낸 메시지에 적용됩니다.버튼 변수에 이동할 목적지 주소를 넣거나, 모두 같은 곳으로 보낼 때는 비워 둡니다.
{
"messages": [
{
"to": "01012345678",
"from": "0212345678",
"type": "ATA",
"kakaoOptions": {
"pfId": "KA01PF...",
"templateId": "KA01TP...",
"variables": {
"#{고객명}": "김솔라",
"#{주문번호}": "20261120-0381",
"#{button-url-01}": "https://shop.example.com/orders/20261120-0381"
}
}
}
]
}
버튼 변수에 넣은 값 | 동작 |
|---|---|
목적지 주소( | 받는 사람마다 그 주소로 이동하고 클릭이 기록됩니다 |
생략 또는 빈 값 | 템플릿 기본 주소로 이동하고 클릭이 기록됩니다 |
http(s) 주소가 아닌 값, 2,000자를 넘는 주소 | 추적 없이 넣은 값 그대로 발송됩니다 |
| 그 메시지는 추적하지 않고 원래 주소로 발송됩니다 |
응답 · 조회에서 달라지는 점
메시지 조회 API의 버튼 링크(
kakaoOptions.buttons)에는 실제로 나간 추적 주소가 보입니다.variables에는 넣은 값이 그대로 남습니다.원래 목적지는 메시지의
smartButton.buttons[]에서 확인합니다 —buttonIndex,destination,destinationPc,source(VALUE넣은 값 ·DEFAULT기본 주소).버튼 링크 문자열을 비교해 검증하던 코드가 있다면
smartButton.buttons[].destination을 기준으로 바꿔 주세요.
적용 조건
아래 조건이 맞지 않으면 오류 없이 지금처럼 발송됩니다. 추적을 붙이지 못했다고 발송이 실패하지는 않습니다.
알림톡 · 브랜드 메시지 템플릿 발송이고
templateId를 지정한 경우템플릿을 소유한 계정에서 보낸 경우(공유받은 템플릿으로 보내면 추적하지 않음)
버튼 주소가
https://#{변수}하나로만 된 웹 링크 버튼대체발송 설정이 지정된 템플릿(구버전 대체발송 방식은 대체 문자에 버튼 주소가 그대로 나열되므로 추적하지 않음)
개발자에게 좋은 점
연동은 그대로, 분석은 콘솔에서 — 마케터 · 운영자가 개발 요청 없이 클릭률을 직접 봅니다.
안전한 기본 동작 — 추적에 문제가 생겨도 원래 주소로 나가므로 발송 장애로 번지지 않습니다.
위조할 수 없는 링크 — 추적 주소는 메시지마다 서명되고 개인정보를 담지 않아, 링크를 바꿔 다른 사람의 기록을 남길 수 없습니다.
주소 변경은 코드 밖에서 — 같은 주소로 보내는 버튼은 콘솔에서 기본 주소만 바꾸면 되므로, 배포 없이 목적지를 교체할 수 있습니다.