개발자 센터
샌드고 쿡북 — 카카오 알림톡·문자 발송 예제
카카오 알림톡, 브랜드메시지, SMS/LMS/MMS 를 실제로 보내는 데 필요한 작업을 하나씩 정리했습니다. 각 문서에 PHP, Node.js, Python, Java, Go, Ruby, .NET 코드가 함께 실려 있습니다.
SDK 가이드가 "이 패키지에 무엇이 들어 있는가"를 설명한다면, 쿡북은 "이걸 어떻게 하는가" 에 답합니다.
각 문서는 하나의 작업만 다루고, 그 작업에 필요한 준비물 · 실행 코드 · 실패했을 때 보게 될 오류를 함께 담았습니다. 코드는 언어별로 나란히 실려 있으니 쓰고 있는 언어의 블록만 복사하면 됩니다.
처음이라면 5분 만에 첫 알림톡 발송하기부터 시작하세요.
시작하기
- 5분 만에 카카오 알림톡 발송하기 — 샌드고 빠른 시작
액세스 키 발급부터 첫 카카오 알림톡 발송까지, PHP · Node.js · Python · Java · Go 코드로 5분 안에 끝내는 방법.
POST /api/v2/notices/send - 알림톡·브랜드메시지·문자 중 뭘 써야 하나 — 채널 선택 가이드
카카오 알림톡, 브랜드메시지, SMS/LMS/MMS 는 각각 보낼 수 있는 내용과 비용, 사전 준비가 다릅니다. 상황별로 어느 채널을 골라야 하는지 정리했습니다.
- 카카오 알림톡 SDK 고르기 — 언어·프레임워크별 공식 패키지
PHP, Laravel, Node.js, Next.js, Python, Django, FastAPI, Java, Spring, Go, Ruby, Rails, .NET, Flutter, WordPress 중 어떤 샌드고 패키지를 설치해야 하는지 한 표로 정리했습니다.
- 샌드고 API 인증 — 액세스 키와 Bearer 토큰
accessKey/secretKey 로 토큰을 발급받아 Bearer 인증으로 호출하는 방법. v1 과 v2 의 차이, 토큰 캐싱, 401/403 처리까지.
POST /api/v2/token - 발신번호 사전등록 — 문자·알림톡 발송 전 필수 절차
전기통신사업법상 사전등록된 번호로만 발송할 수 있습니다. 발신번호 등록과 카카오 발신프로필 연결 절차, 자주 막히는 지점을 정리했습니다.
메시지 보내기
- 카카오 알림톡 보내기 — PHP · Node.js · Python · Java · Go 예제
승인된 템플릿 코드로 카카오 알림톡을 발송하는 코드. Laravel, Node.js, Python, PHP, Java, Go, Ruby, .NET 예제와 필수 파라미터, 실패 원인을 정리했습니다.
POST /api/v2/notices/send - SMS · LMS · MMS 문자 보내기 — 언어별 예제
샌드고로 SMS(90바이트), LMS(장문), MMS(이미지)를 발송하는 방법. 타입 선택 기준, 바이트 계산, 광고 문자 규칙까지 정리했습니다.
POST /api/v2/messages/send - 카카오 브랜드메시지 보내기 — 친구톡 후속 채널
브랜드메시지로 채널 친구·비친구·전체 동보 발송하는 방법. targeting 값에 따른 경로 차이와 친구톡 API 를 계속 써야 하는 예외까지.
POST /api/v2/brand-messages/send - 알림톡 실패 시 SMS 대체 발송 설정하기
replaceSms 로 카카오 알림톡이 도달하지 못했을 때 자동으로 문자를 보내는 방법. 필수 파라미터와 흔한 실수를 정리했습니다.
POST /api/v2/notices/send - 알림톡 대량 발송과 치환 변수 — 수신자마다 다른 내용 보내기
contacts 배열로 수신자별 변수를 채워 한 번에 발송하는 방법. 배치 크기, 부분 실패 처리, 큐 사용 패턴까지.
POST /api/v2/notices/send - 알림톡·문자 예약 발송하기 — scheduleType 과 at
지정한 시각에 카카오 알림톡이나 문자를 발송하는 방법. 예약 시각 형식, 시간대, 야간 광고 제한과의 관계를 정리했습니다.
POST /api/v2/notices/send