채널 연동과 템플릿 검수가 끝난 뒤의 일이에요. 준비 단계는 알림톡 설정에서 다뤄요.
네 갈래로 나뉘어요
| 갈래 | 무엇을 하나 |
|---|---|
| 발송 | 템플릿에 변수를 채워 보낸다 |
| 발송내역 | 나간 건의 결과와 비용을 본다 |
| 웹훅 | 발송·검수 결과를 서버로 받는다 |
| 발송 제외 목록 | 보내면 안 되는 번호를 관리한다 |
먼저 알아둘 것 넷
알림톡 웹훅은 주문 웹훅과 별개예요
쇼핑몰의 주문·구독 웹훅을 쓰고 있다면 알림톡 웹훅은 URL 을 따로 등록해요. 같은 URL 에 태우면 기존 주문 연동이 깨져요 — 웹훅 설정. 알림톡 웹훅만 쓰는 서비스는 URL 하나면 돼요.
벌크는 쿼터를 넘으면 전체가 거부돼요
일부만 나가고 나머지가 잘리는 게 아니라 요청 자체가 튕겨요. 나눠 보내야 해요 — 벌크 발송
접수 직후 상태는 확정이 아니에요
발송 직후에는 requested 로 보여요. 성공·실패 확정은 벤더 동기화가 끝난 뒤예요 — 발송 결과 조회
고객이 스스로 수신거부하는 경로는 없어요
알림톡은 정보성 메시지라 수신거부 문구가 법정 의무가 아니고, 사전심사를 거친 템플릿에 발송 시점에 링크를 끼워 넣을 수도 없어요. 수신자 쪽 거부는 카카오톡 채널 차단으로 갈음해요. 가맹점이 CS 로 받은 요청은 발송 제외 목록에 직접 등록해요
발송
| 하려는 것 | 문서 |
|---|---|
| 한 건 보내기 | 단건 발송 |
| 여러 건 한 번에 | 벌크 발송 |
| 예약 건 취소 | 예약 취소 |
중복 발송은 `ref_id` 로 막아요
같은 (프로젝트, ref_id) 로 다시 요청하면 기존 접수 결과를 그대로 돌려줘요. 단 실패(failed)한 건은 재발송돼요. 재시도 로직이 있다면 예약번호·주문번호 같은 고유값을 넣어 두세요.
발송 한도
프로젝트마다 분·시·일 한도가 있어요. 새 프로젝트는 0단계에서 시작하고, 정상 발송이 쌓이면 단계가 올라가요.
| 단계 | 분당 | 시간당 | 일간 |
|---|---|---|---|
| 0 (새 프로젝트) | 10 | 100 | 500 |
| 1 | 30 | 500 | 3,000 |
| 2 | 100 | 2,000 | 20,000 |
| 3 | 300 | 10,000 | 100,000 |
부트페이가 프로젝트별로 한도를 따로 정해 두면 그 값이 우선해요. 넘으면 3022 예요. 벌크는 수신자 수 전체로 세서, 0단계에서 11명 이상을 한 요청에 넣으면 전부 거부돼요.
발송내역
| 하려는 것 | 문서 |
|---|---|
| 나간 건 목록 (기본 30일, 최대 92일) | 발송내역 목록 |
| 한 건의 결과 상세 | 발송 결과 조회 |
| 기간별 건수·비용 집계 | 기간 집계 |
응답의 시각 필드는 지금 문서 예시와 다른 형식으로 와요 — 응답의 시각 형식을 먼저 봐요.
웹훅
| 하려는 것 | 문서 |
|---|---|
| 수신 URL 등록 | 웹훅 설정 |
| 시크릿 발급·테스트 | 테스트·시크릿 |
| 성공·실패 전송 이력 | 전송 이력 |
발송 제외 목록
| 하려는 것 | 문서 |
|---|---|
| 조회·등록·해제 | 발송 제외 목록 |
| 보내기 전 미리 걸러내기 (한 번에 1,000건) | 발송 전 확인 |