채널 연동과 템플릿 검수가 끝난 뒤의 발송·조회·웹훅·발송 제외 API 를 정리합니다. 준비 단계는 알림톡 설정에서 다룹니다.
구성
| 갈래 | 무엇을 하나 |
|---|---|
| 발송 | 템플릿에 변수를 채워 보낸다 |
| 발송내역 | 나간 건의 결과와 비용을 본다 |
| 웹훅 | 발송·검수 결과를 서버로 받는다 |
| 발송 제외 목록 | 보내면 안 되는 번호를 관리한다 |
먼저 알아둘 것 다섯
쇼핑몰의 주문·구독 웹훅을 쓰고 있다면 알림톡 웹훅은 URL 을 따로 등록합니다. 같은 URL 로 받으면 기존 주문 연동이 깨집니다 — 웹훅 설정. 알림톡 웹훅만 쓰는 서비스는 URL 하나면 됩니다.
일부만 나가고 나머지가 잘리는 것이 아니라 요청 자체가 거부됩니다. 나눠 보내야 합니다 — 벌크 발송
발송 직후에는 requested 로 보입니다. 성공·실패 확정은 벤더 동기화가 끝난 뒤입니다 — 발송 결과 조회
사전심사를 거친 템플릿에 발송 시점에 수신거부 링크를 끼워 넣을 수 없습니다. 수신자 쪽 거부는 카카오톡 채널 차단으로 갈음합니다. 가맹점이 CS 로 받은 요청은 발송 제외 목록에 직접 등록합니다
리셀러가 알림톡 이용료 대납을 켰으면 하위 가맹점의 유료 알림톡 이용료가 리셀러 선불 잔액에서 차감됩니다. API 호출과 응답 모양은 같고, 충전 자격과 잔액만 리셀러를 기준으로 판단합니다 — 단건 발송
발송
| 하려는 것 | 문서 |
|---|---|
| 한 건 보내기 | 단건 발송 |
| 여러 건 한 번에 | 벌크 발송 |
| 예약 건 취소 | 예약 취소 |
같은 (프로젝트, 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일) | 발송내역 목록 |
| 한 건의 결과 상세 | 발송 결과 조회 |
| 기간별 건수·비용 집계 | 기간 집계 |
응답의 시각 필드는 ISO8601 이 아닙니다 — 응답의 시각 형식을 참고합니다.
웹훅
| 하려는 것 | 문서 |
|---|---|
| 수신 URL 등록 | 웹훅 설정 |
| 시크릿 발급·테스트 | 테스트·시크릿 |
| 성공·실패 전송 이력 | 전송 이력 |
발송 제외 목록
| 하려는 것 | 문서 |
|---|---|
| 조회·등록·해제 | 발송 제외 목록 |
| 보내기 전 미리 걸러내기 (한 번에 1,000건) | 발송 전 확인 |



