발신번호 사전등록 — 문자·알림톡 발송 전 필수 절차

한국에서 문자·알림톡을 보내려면 발신번호를 미리 등록해야 합니다. 선택이 아니라 법령 요구사항입니다(전기통신사업법 제84조의2, 전화번호 거짓표시 금지).

이 절차가 연동 일정에서 가장 자주 병목이 됩니다. 서류 검토에 시간이 걸리는데, 많은 팀이 코드를 다 짜고 나서야 시작하기 때문입니다. 가장 먼저 시작하세요.

두 종류의 발신 키

키	무엇을 가리키나	어디에 쓰이나
senderKey	등록된 문자 발신번호	SMS · LMS · MMS, 알림톡의 SMS 대체 발송
kakaoSenderKey	연결된 카카오톡 채널(발신프로필)	알림톡, 브랜드메시지

알림톡만 보낼 거라면 kakaoSenderKey 만 있어도 되지만, SMS 대체 발송을 켜는 순간 senderKey 도 필요합니다. 실무에서는 대체 발송을 켜는 경우가 대부분이므로 둘 다 준비하는 편이 낫습니다.

문자 발신번호 등록

1. 샌드고 콘솔 → 발신번호 → 등록
2. 등록할 번호와 명의 정보 입력
3. 증빙 서류 제출
   • 통신서비스 이용증명원 (해당 번호가 신청인 명의임을 증명)
   • 사업자등록증 (법인 명의인 경우)
   • 위임장 (타인 명의 번호를 쓰는 경우)
4. 검토 후 승인

자주 막히는 지점

• 증명원의 명의와 계정의 사업자 정보가 다르면 반려됩니다. 지사·계열사 번호를 본사 계정으로 등록할 때 자주 발생합니다.
• 증명원은 발급일이 최근이어야 합니다. 몇 년 전 서류는 다시 발급받으세요.
• 대표번호(1588, 1600 등)는 회선 명의 확인이 추가로 필요할 수 있습니다.

카카오 발신프로필 연결

알림톡은 문자 발신번호와 별개로, 카카오톡 채널이 있어야 합니다.

1. 카카오 비즈니스에서 카카오톡 채널 개설
2. 채널을 비즈니스 채널로 전환 (사업자 인증 필요)
3. 샌드고 콘솔 → 카카오 발신프로필 → 등록
4. 채널 검색용 아이디 입력 → 관리자 휴대폰으로 인증
5. 발급된 kakaoSenderKey 를 환경변수에 저장

SENDGO_KAKAO_SENDER_KEY=your_kakao_sender_key
SENDGO_SMS_SENDER_KEY=your_sms_sender_key

자주 막히는 지점

• 일반 채널은 안 됩니다. 비즈니스 채널로 전환하지 않으면 발신프로필을 만들 수 없습니다.
• 채널 관리자 권한이 있는 카카오 계정으로 인증해야 합니다.
• 채널 검색용 아이디는 채널명이 아니라 @ 로 시작하는 식별자입니다.

등록 전에 발송하면

발신번호가 등록되지 않은 상태에서 호출하면 가입 시점이 아니라 발송 시점에 실패합니다.

오류 코드	원인
INVALID_KAKAO_SENDER_KEY	카카오 발신프로필 키가 존재하지 않거나 이 계정 소유가 아님
SENDER_NOT_REGISTERED 계열	문자 발신번호가 미등록 또는 승인 대기

콘솔에서 상태가 승인 완료인지 확인하세요. "검토 중" 상태의 번호로는 발송되지 않습니다.

API로 등록하기

위 절차는 전부 API로도 됩니다.

대상	API
문자 발신번호 (유선·대표·법인폰·타사)	POST /api/v2/senders
문자 발신번호 (휴대폰)	POST /api/v2/senders — PASS 대신 신분증 사본(identityDocument)
카카오 채널 인증번호 발송	POST /api/v2/kakao-senders/token
카카오 발신프로필 등록	POST /api/v2/kakao-senders

휴대폰 발신번호는 콘솔에서 PASS 본인인증을 쓰지만, API 로는 신분증 사본을 받아 샌드고 운영자가 대신 확인합니다. 이 경로로 접수된 건은 자동 승인되지 않고 반드시 운영자 검토를 거칩니다.

카카오 채널 등록의 인증번호는 카카오가 관리자 휴대폰으로 보내므로 사람이 입력해야 하지만, 여러분 화면에서 받으면 됩니다. 자세한 내용은 콘솔 없이 API로 전부 처리하기를 보세요.

다음 단계

• 5분 만에 첫 알림톡 발송하기
• 알림톡 템플릿 등록과 심사 통과