알림톡 발송·운영 개요

채널 연동과 템플릿 검수가 끝난 뒤의 발송·조회·웹훅·발송 제외 API 를 정리합니다. 준비 단계는 알림톡 설정에서 다룹니다.


구성

갈래 무엇을 하나
발송 템플릿에 변수를 채워 보낸다
발송내역 나간 건의 결과와 비용을 본다
웹훅 발송·검수 결과를 서버로 받는다
발송 제외 목록 보내면 안 되는 번호를 관리한다

먼저 알아둘 것 다섯

알림톡 웹훅은 주문 웹훅과 별개입니다

쇼핑몰의 주문·구독 웹훅을 쓰고 있다면 알림톡 웹훅은 URL 을 따로 등록합니다. 같은 URL 로 받으면 기존 주문 연동이 깨집니다 — 웹훅 설정. 알림톡 웹훅만 쓰는 서비스는 URL 하나면 됩니다.

벌크는 쿼터를 넘으면 전체가 거부됩니다

일부만 나가고 나머지가 잘리는 것이 아니라 요청 자체가 거부됩니다. 나눠 보내야 합니다 — 벌크 발송

접수 직후 상태는 확정이 아닙니다

발송 직후에는 requested 로 보입니다. 성공·실패 확정은 벤더 동기화가 끝난 뒤입니다 — 발송 결과 조회

고객이 스스로 수신거부하는 경로는 없습니다

사전심사를 거친 템플릿에 발송 시점에 수신거부 링크를 끼워 넣을 수 없습니다. 수신자 쪽 거부는 카카오톡 채널 차단으로 갈음합니다. 가맹점이 CS 로 받은 요청은 발송 제외 목록에 직접 등록합니다

리셀러가 이용료를 대신 낼 수 있습니다

리셀러가 알림톡 이용료 대납을 켰으면 하위 가맹점의 유료 알림톡 이용료가 리셀러 선불 잔액에서 차감됩니다. API 호출과 응답 모양은 같고, 충전 자격과 잔액만 리셀러를 기준으로 판단합니다 — 단건 발송


발송

하려는 것 문서
한 건 보내기 단건 발송
여러 건 한 번에 벌크 발송
예약 건 취소 예약 취소
중복 발송은 `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일) 발송내역 목록
한 건의 결과 상세 발송 결과 조회
기간별 건수·비용 집계 기간 집계

응답의 시각 필드는 ISO8601 이 아닙니다 — 응답의 시각 형식을 참고합니다.

웹훅

하려는 것 문서
수신 URL 등록 웹훅 설정
시크릿 발급·테스트 테스트·시크릿
성공·실패 전송 이력 전송 이력

발송 제외 목록

하려는 것 문서
조회·등록·해제 발송 제외 목록
보내기 전 미리 걸러내기 (한 번에 1,000건) 발송 전 확인

함께 보기