개발자 문서 메뉴
LESS GUESSWORK. MORE BUILDING.
샌드고 쿡북 — 카카오 알림톡·문자 발송 예제
카카오 알림톡, 브랜드메시지, SMS/LMS/MMS 를 실제로 보내는 데 필요한 작업을 하나씩 정리했습니다. 각 문서에 PHP, Node.js, Python, Java, Go, Ruby, .NET 코드가 함께 실려 있습니다.
필요한 기능 선택
내 언어의 예제 확인
복사하고 프로젝트에 적용
검색 결과 19
시작하기 6
5분 만에 카카오 알림톡 발송하기 — 샌드고 빠른 시작
액세스 키 발급부터 첫 카카오 알림톡 발송까지, PHP · Node.js · Python · Java · Go 코드로 5분 안에 끝내는 방법.
POST /api/v2/notices/send단계별 예제 보기 →AI 에이전트로 샌드고 연동 끝내기 — MCP 서버와 계정 API
조직 선택, API 키 발급, 발신번호·템플릿 등록까지 코딩 에이전트에게 맡기는 방법. 충전을 제외한 모든 작업을 콘솔 없이 처리합니다.
POST /api/v2/account/api-keys단계별 예제 보기 →알림톡·브랜드메시지·문자 중 뭘 써야 하나 — 채널 선택 가이드
카카오 알림톡, 브랜드메시지, 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단계별 예제 보기 →발신번호 사전등록 — 문자·알림톡 발송 전 필수 절차
전기통신사업법상 사전등록된 번호로만 발송할 수 있습니다. 발신번호 등록과 카카오 발신프로필 연결 절차, 자주 막히는 지점을 정리했습니다.
단계별 예제 보기 →
메시지 보내기 7
이메일 · SMTP 연동 — 발신 인증, 뉴스레터와 자동화 수신함
일반 발송 승인이 완료된 이메일 서비스입니다. 발신 인증과 앱의 발송 가능 상태를 확인하고 SMTP, HTTP API와 자동화 수신함을 연동하세요.
POST /api/v2/email/send단계별 예제 보기 →카카오 알림톡 보내기 — 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단계별 예제 보기 →
운영하기 4
알림톡 템플릿 등록과 심사 통과하기 — 반려 사유와 대응
카카오 알림톡 템플릿을 등록하고 심사를 통과하는 방법. 정보성/광고성 구분, 변수 사용법, 자주 반려되는 문안과 고치는 방법.
단계별 예제 보기 →콘솔 없이 API로 전부 처리하기 — 리셀러를 위한 운영 자동화
카카오 채널 등록, 알림톡 템플릿 검수 요청, 발신번호 심사 접수, 수신거부 동기화까지 sendgo.io에 들어오지 않고 API로 끝내는 방법. 웹훅으로 심사 결과를 받는 법까지.
POST /api/v2/notice-templates단계별 예제 보기 →샌드고 API 오류 코드와 재시도 전략
알림톡·문자 발송 실패 시 나오는 오류 코드 전체 목록과, 재시도해도 되는 실패와 그렇지 않은 실패를 구분하는 방법.
단계별 예제 보기 →문자·알림톡에 짧은주소 넣고 클릭 추적하기
샌드고 짧은 URL 로 긴 링크를 줄이고, 누가 언제 눌렀는지 통계를 확인하는 방법. 문자 바이트 절약과 반응 측정.
POST /api/v2/short-urls단계별 예제 보기 →
코드 예제 활용 안내
SDK 가이드가 "이 패키지에 무엇이 들어 있는가"를 설명한다면, 쿡북은 "이걸 어떻게 하는가" 에 답합니다.
각 문서는 하나의 작업만 다루고, 그 작업에 필요한 준비물 · 실행 코드 · 실패했을 때 보게 될 오류를 함께 담았습니다. 코드는 언어별로 나란히 실려 있으니 쓰고 있는 언어의 블록만 복사하면 됩니다.
처음이라면 5분 만에 첫 알림톡 발송하기부터 시작하세요.