# 샌드고 쿡북 — 카카오 알림톡·문자 발송 예제

카카오 알림톡, 브랜드메시지, SMS/LMS/MMS 를 실제로 보내는 데 필요한 작업을 하나씩 정리했습니다. 각 문서에 PHP, Node.js, Python, Java, Go, Ruby, .NET 코드가 함께 실려 있습니다.

SDK 가이드가 "이 패키지에 무엇이 들어 있는가"를 설명한다면, 쿡북은 **"이걸 어떻게 하는가"** 에 답합니다.

각 문서는 하나의 작업만 다루고, 그 작업에 필요한 준비물 · 실행 코드 · 실패했을 때 보게 될 오류를 함께 담았습니다. 코드는 언어별로 나란히 실려 있으니 쓰고 있는 언어의 블록만 복사하면 됩니다.

처음이라면 [5분 만에 첫 알림톡 발송하기](/ko/cookbook/quickstart)부터 시작하세요.

## 시작하기

- [5분 만에 카카오 알림톡 발송하기 — 샌드고 빠른 시작](https://sendgo.io/ko/cookbook/quickstart.md): 액세스 키 발급부터 첫 카카오 알림톡 발송까지, PHP · Node.js · Python · Java · Go 코드로 5분 안에 끝내는 방법.
- [알림톡·브랜드메시지·문자 중 뭘 써야 하나 — 채널 선택 가이드](https://sendgo.io/ko/cookbook/choose-channel.md): 카카오 알림톡, 브랜드메시지, SMS/LMS/MMS 는 각각 보낼 수 있는 내용과 비용, 사전 준비가 다릅니다. 상황별로 어느 채널을 골라야 하는지 정리했습니다.
- [카카오 알림톡 SDK 고르기 — 언어·프레임워크별 공식 패키지](https://sendgo.io/ko/cookbook/choose-sdk.md): PHP, Laravel, Node.js, Next.js, Python, Django, FastAPI, Java, Spring, Go, Ruby, Rails, .NET, Flutter, WordPress 중 어떤 샌드고 패키지를 설치해야 하는지 한 표로 정리했습니다.
- [샌드고 API 인증 — 액세스 키와 Bearer 토큰](https://sendgo.io/ko/cookbook/authentication.md): accessKey/secretKey 로 토큰을 발급받아 Bearer 인증으로 호출하는 방법. v1 과 v2 의 차이, 토큰 캐싱, 401/403 처리까지.
- [발신번호 사전등록 — 문자·알림톡 발송 전 필수 절차](https://sendgo.io/ko/cookbook/sender-number.md): 전기통신사업법상 사전등록된 번호로만 발송할 수 있습니다. 발신번호 등록과 카카오 발신프로필 연결 절차, 자주 막히는 지점을 정리했습니다.

## 메시지 보내기

- [카카오 알림톡 보내기 — PHP · Node.js · Python · Java · Go 예제](https://sendgo.io/ko/cookbook/send-alimtalk.md): 승인된 템플릿 코드로 카카오 알림톡을 발송하는 코드. Laravel, Node.js, Python, PHP, Java, Go, Ruby, .NET 예제와 필수 파라미터, 실패 원인을 정리했습니다.
- [SMS · LMS · MMS 문자 보내기 — 언어별 예제](https://sendgo.io/ko/cookbook/send-sms.md): 샌드고로 SMS(90바이트), LMS(장문), MMS(이미지)를 발송하는 방법. 타입 선택 기준, 바이트 계산, 광고 문자 규칙까지 정리했습니다.
- [카카오 브랜드메시지 보내기 — 친구톡 후속 채널](https://sendgo.io/ko/cookbook/send-brand-message.md): 브랜드메시지로 채널 친구·비친구·전체 동보 발송하는 방법. targeting 값에 따른 경로 차이와 친구톡 API 를 계속 써야 하는 예외까지.
- [알림톡 실패 시 SMS 대체 발송 설정하기](https://sendgo.io/ko/cookbook/sms-fallback.md): replaceSms 로 카카오 알림톡이 도달하지 못했을 때 자동으로 문자를 보내는 방법. 필수 파라미터와 흔한 실수를 정리했습니다.
- [알림톡 대량 발송과 치환 변수 — 수신자마다 다른 내용 보내기](https://sendgo.io/ko/cookbook/bulk-send.md): contacts 배열로 수신자별 변수를 채워 한 번에 발송하는 방법. 배치 크기, 부분 실패 처리, 큐 사용 패턴까지.
- [알림톡·문자 예약 발송하기 — scheduleType 과 at](https://sendgo.io/ko/cookbook/scheduled-send.md): 지정한 시각에 카카오 알림톡이나 문자를 발송하는 방법. 예약 시각 형식, 시간대, 야간 광고 제한과의 관계를 정리했습니다.

## 운영하기

- [알림톡 템플릿 등록과 심사 통과하기 — 반려 사유와 대응](https://sendgo.io/ko/cookbook/alimtalk-template.md): 카카오 알림톡 템플릿을 등록하고 심사를 통과하는 방법. 정보성/광고성 구분, 변수 사용법, 자주 반려되는 문안과 고치는 방법.
- [샌드고 API 오류 코드와 재시도 전략](https://sendgo.io/ko/cookbook/error-handling.md): 알림톡·문자 발송 실패 시 나오는 오류 코드 전체 목록과, 재시도해도 되는 실패와 그렇지 않은 실패를 구분하는 방법.
- [문자·알림톡에 짧은주소 넣고 클릭 추적하기](https://sendgo.io/ko/cookbook/short-url.md): 샌드고 짧은 URL 로 긴 링크를 줄이고, 누가 언제 눌렀는지 통계를 확인하는 방법. 문자 바이트 절약과 반응 측정.

## 정책과 마이그레이션

- [광고성 문자·메시지 규칙 — (광고) 표기, 수신거부, 야간 발송 금지](https://sendgo.io/ko/cookbook/ad-message-rules.md): 정보통신망법상 광고성 메시지에 지켜야 하는 규칙과 코드에서 강제하는 방법. 21시~08시 발송 금지, 무료 수신거부, 사전 동의.
- [카카오 친구톡 종료(2025-12-31) 대응 — 브랜드메시지 마이그레이션](https://sendgo.io/ko/cookbook/friendtalk-sunset.md): 친구톡이 종료된 뒤 기존 코드는 어떻게 되는지, 언제 브랜드메시지로 옮겨야 하는지, 친구톡 엔드포인트를 계속 써야 하는 예외는 무엇인지.