알림톡 개요

알림톡은 주문·예약·결제처럼 고객이 알아야 할 내용을 카카오톡으로 보내는 정보성 메시지​​예요. 고객이 카카오톡 채널을 친구로 추가하지 않았어도 보낼 수 있지만, 할인·이벤트 같은 광고 문구는 담을 수 없어요.

부트페이에서 알림톡을 보내려면 먼저 카카오톡 채널을 발신프로필​​로 연결하고, 승인된 템플릿을 준비해야 해요. 쇼핑몰의 주문·배송 안내는 부트페이 공식 템플릿으로 시작할 수 있고, 서비스에 맞는 문구가 필요하면 템플릿을 직접 등록해 카카오 검수를 받아요.

어떤 안내를 보낼 수 있나요

주문·예약·결제처럼 고객의 거래나 서비스 이용에 필요한 안내를 알림톡으로 보낼 수 있어요. 상품 홍보나 구매를 유도하는 문구는 정보성 안내에 해당하지 않아요.

어디부터 볼까요

처음 연동할 때 필요한 설정은 채널 연동 하나예요. 발신프로필 API는 연결된 채널을 조회하거나 상태를 다시 확인하고, 연동을 해지할 때 참고하면 돼요.

발송 전에 알아둘 세 가지

발신프로필과 템플릿이 준비되면 수신번호와 변수 값을 넣어 발송해요. 전달 결과는 발송내역이나 웹훅으로 확인하고, 발송 제외 목록에 등록된 번호는 서버가 발송 직전에 걸러요.

템플릿은 두 가지예요

보내려는 내용과 맞는 공식 템플릿이 있으면 그대로 사용해요. 문구를 바꿔야 하거나 공식 템플릿에 없는 안내라면 자체 템플릿을 만들어요. 공식 템플릿과 자체 템플릿은 같은 발송 API로 보내요.

연동 순서

상태 읽는 법

자체 템플릿은 상태가 두 축이에요. 하나는 카카오에 올라갔는가​(vendor_status), 다른 하나는 심사 결과가 무엇인가​(inspection_status)예요. 등록과 심사는 다른 단계라서 축이 둘이에요.

카카오 검수 상태 (inspection_status)

벤더 코드는 카카오 콘솔에서 쓰는 표기예요. 필터로 보낼 때는 키·벤더 코드·숫자 모두 받아요.

등록 상태 — vendor_status (숫자로 내려와요)

필드 이름이 vendor_status 인 것은, 부트페이가 카카오에 직접 붙는 것이 아니라 중계 구간을 한 번 거치기 때문이에요. 평소에는 몰라도 되지만 간헐적인 500 과 0.5초 안팎의 지연이 이 구간에서 나오니​, 장애를 볼 때는 부트페이 서버만 보지 말고 이 사실을 같이 두세요. synced_at 은 그 구간과 마지막으로 상태를 맞춘 시각이에요.

과금

성공한 발송만 과금돼요. 실패·취소·발송 제외로 걸러진 건은 청구되지 않아요. 기간별 발송량과 예상 금액은 발송내역·집계에서 확인해요.

자주 막히는 곳

에러 응답의 error_code는 숫자가 아니라 TEMPLATE_NOT_APPROVED 같은 문자열로 와요. 각 문서의 에러 코드표에 숫자와 문자열을 함께 적어 두었어요.

응답의 시각 형식