Documentation menu
LESS GUESSWORK. MORE BUILDING.
샌드고 쿡북 — 카카오 알림톡·문자 발송 예제
카카오 알림톡, 브랜드메시지, SMS/LMS/MMS 를 실제로 보내는 데 필요한 작업을 하나씩 정리했습니다. 각 문서에 PHP, Node.js, Python, Java, Go, Ruby, .NET 코드가 함께 실려 있습니다.
Choose a task
Pick your language
Copy and adapt the code
Results 19
Getting started 6
Send your first Kakao Alimtalk in 5 minutes
From issuing an access key to sending a Kakao Alimtalk, with working code in Node.js, Python, PHP, Laravel, Java and Go.
POST /api/v2/notices/sendFollow the recipe →Finish the Sendgo integration from your AI agent — MCP server and Account API
Pick the organisation, issue API keys, register sender numbers and templates from a coding agent. Everything except topping up credit works without the console.
POST /api/v2/account/api-keysFollow the recipe →Alimtalk, Brand Message or SMS — choosing a messaging channel in Korea
Kakao Alimtalk, Kakao Brand Message and SMS/LMS/MMS differ in what content they allow, what they cost and what you must set up first. Which to pick, by situation.
Follow the recipe →Which Sendgo SDK should I install? — 20 official packages
Pick the right Sendgo package for PHP, Laravel, Symfony, WordPress, Node.js, Next.js, NestJS, Python, Django, FastAPI, Java, Spring Boot, Go, Ruby, Rails, .NET, ASP.NET Core or Flutter.
Follow the recipe →Sendgo API authentication — access keys and bearer tokens
Exchange an accessKey and secretKey for a bearer token, and call the Sendgo API with it. Differences between v1 and v2, token caching, and the 401/403 codes.
POST /api/v2/tokenFollow the recipe →Registering a sending number in South Korea — required before you can send
Korean law requires the caller ID to be pre-registered. How to register an SMS sending number and connect a Kakao channel, and where registrations usually get rejected.
Follow the recipe →
Sending messages 7
이메일 · SMTP 연동 — 발신 인증, 뉴스레터와 자동화 수신함
일반 발송 승인이 완료된 이메일 서비스입니다. 발신 인증과 앱의 발송 가능 상태를 확인하고 SMTP, HTTP API와 자동화 수신함을 연동하세요.
POST /api/v2/email/sendFollow the recipe →Send a Kakao Alimtalk — PHP, Node.js, Python, Java, Go examples
Send Kakao Alimtalk with an approved template code. Runnable code for Laravel, Node.js, Python, PHP, Java, Go, Ruby and .NET, plus every required field and why sends fail.
POST /api/v2/notices/sendFollow the recipe →Send SMS, LMS and MMS in South Korea — code examples
Send Korean SMS (90 bytes), LMS (long text) and MMS (with images) through Sendgo. Type selection, byte counting, verification-code patterns and advertising rules.
POST /api/v2/messages/sendFollow the recipe →Send a Kakao Brand Message — the successor to Friendtalk
Send Brand Messages to channel friends, non-friends, or every consenting friend at once. How targeting splits the request path, and when to keep using the Friendtalk endpoint.
POST /api/v2/brand-messages/sendFollow the recipe →SMS fallback when a Kakao Alimtalk fails
Use replaceSms so a text message goes out when the Alimtalk cannot be delivered. Required fields, cost implications, and the mistake that silently sends nothing.
POST /api/v2/notices/sendFollow the recipe →Bulk Alimtalk sending and per-recipient variables
Send one template to many recipients with different values each, in batches. Batch sizing, partial failures, queue patterns and the data hygiene that prevents most incidents.
POST /api/v2/notices/sendFollow the recipe →Scheduling an Alimtalk or SMS — scheduleType and at
Send at a specific time with scheduleType SCHEDULED. Timestamp format, the KST timezone trap, and how scheduling interacts with the advertising night ban.
POST /api/v2/notices/sendFollow the recipe →
Operating 4
Registering an Alimtalk template and passing review
How Kakao Alimtalk template review works, why informational-only matters, how to lay out variables, and the wordings that get rejected.
Follow the recipe →Doing everything over the API — operations automation for resellers
Register Kakao channels, submit Alimtalk templates for review, file sender numbers, and sync opt-outs without ever sending anyone to sendgo.io. Includes webhook delivery of review outcomes.
POST /api/v2/notice-templatesFollow the recipe →Sendgo API error codes and retry strategy
Every error code returned by the Sendgo send endpoints, and how to tell a failure worth retrying from one that will fail identically every time.
Follow the recipe →Short links in SMS and Alimtalk, with click tracking
Shorten long URLs to fit inside an SMS and measure who clicked. Creating short links, reading click stats, and splitting stats per campaign.
POST /api/v2/short-urlsFollow the recipe →
Policy and migration 2
Advertising message rules in Korea — (광고) prefix, opt-out, night ban
What Korean law requires of promotional SMS and Kakao messages, and how to enforce it in code: the (광고) prefix, a free opt-out, and no sending between 21:00 and 08:00 KST.
Follow the recipe →Kakao Friendtalk shut down (2025-12-31) — migrating to Brand Message
What happens to existing Friendtalk code now that the channel has ended, when you must migrate to Brand Message, and the one case where the Friendtalk endpoint is still the right call.
POST /api/v2/brand-messages/sendFollow the recipe →
How to use these recipes
The SDK guides describe what is inside each package. The cookbook answers how do I do this.
Each recipe covers one task, with the prerequisites, runnable code in several languages, and the errors you will see when it does not work. Copy the block for the language you are already writing in.
New here? Start with Send your first Kakao Alimtalk in five minutes.
Every recipe here is available in English. The Korean originals are at
/ko/cookbook/.