본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

관련사이트

사이드 메뉴

플랫폼 API

API 제공

전용 API

어드민 API

이 문서는 문자 메시지 사용 시 필요한 설정을 안내합니다.

문자 메시지 발송기 및 API를 이용하려면 앱 관리 페이지의 [문자 메시지] > [일반] > [사용 설정]을 [ON]으로 설정해야 합니다. 이용 안내의 조건을 만족하지 않는 경우, [사용 설정] 변경이 불가능합니다.

국내 사용자에게 문자 메시지 발송 시 사용할 발신번호를 등록합니다.

아래 조건을 만족하는 전화번호만 발신번호로 사용할 수 있습니다.

  • 기업 또는 기관이 소유하거나, 소유자로부터 사용 권한을 위임받은 전화번호
  • 발신번호 변작으로 의심되어 한국인터넷진흥원(KISA)으로부터 소명 요청을 받을 경우, 소유 또는 위임 사실을 증명할 수 있는 전화번호
  • 유선전화: 지역 번호 포함(예: 02-1234-5678)
  • 이동전화: 11자리, 010만 지원(예: 010-1234-5678)
  • 대표번호: 14YY, 15YY, 16YY, 18YY로 시작하는 번호, 지역 번호 제외
  • 공통서비스식별번호: 0N0으로 시작하는 번호, 지역 번호 제외
  • 특수번호: 112, 1355 등 국가, 지방자치단체, 공공기관의 전화번호는 해당 기관에 한해 사용 가능
발신번호 변작이란?

발신번호 변작(거짓된 발신번호)은 다른 사람을 속여 재산상의 이익을 취하거나 폭언, 협박, 희롱 등의 위해를 입힐 목적으로 전화 및 문자 발송 시 발신번호를 변작하는 등 거짓으로 표시하는 행위를 말합니다.

KIMS(문자,음성,050통화,팩스) 아지트에서 아래 서류와 함께 발신번호 등록을 요청합니다.

  • 자사 소유의 전화번호 사용 시
    • 통신사 가입증명원, 사업자등록증
    • 개인 전화번호를 등록할 경우, 전화번호 소유자의 재직증명서 추가 제출
  • 타사 소유의 전화번호 사용 시
    • 통신사 가입증명원, 전화번호를 소유한 사업자의 사업자등록증, 위임장, 거래 관계 입증자료
    • 위임장은 위임자 및 수임자의 상호명 주소지, 설명, 위임할 전화번호 목록, 위임 목적이 정확히 명시되어야 함
    • 타사는 자회사, 계열사 등 법인등록번호가 다른 사업자 모두를 포함함
통신사 가입증명원이란?

통신사 가입증명원은 발신번호의 소유를 증명해주는 서류로, 이동통신사마다 명칭이 다를 수 있습니다. 가입한 이동통신사의 고객센터로 문의해 발급할 수 있습니다.

광고성 정보 표시 의무 사항 준수를 위한 수신거부번호(080)를 제공합니다. 수신거부번호는 유료 서비스로, 과금 정책을 참고합니다.

[번호 발급]으로 새로운 수신거부번호를 발급받을 수 있습니다. 수신거부번호 발급 시, ARS 통화 시 사용자에게 안내될 회사명을 입력해야 합니다. 회사명은 이후 수정 가능합니다.

사용 중인 수신거부번호가 있는 경우, 수신거부번호에 대한 상세 정보를 제공합니다.

  • 수신거부한 번호 목록: 수신거부를 요청한 전화번호 내역 조회
  • 수신거부 대상 추가: 수동으로 특정 전화번호에 대한 수신거부 처리

수신거부번호를 더 이상 사용하지 않으려면 [해지]를 선택합니다. 단, 재발급 시 새로운 수신거부번호가 발급되고, 기존의 수신거부번호는 사용할 수 없으므로 주의합니다.

수신거부번호로 인입된 수신거부 요청을 전달받을 서비스 서버의 웹훅 URL을 설정합니다. 웹훅 URL을 설정하지 않은 경우, 수신거부 내역은 앱 관리 페이지의 [문자 메시지] > [일반] > [수신거부번호(080)]에서 확인할 수 있습니다.

등록한 웹훅 URL로 전달되는 웹훅의 자세한 정보는 수신거부 웹훅을 참고합니다.

앱 관리 페이지의 [문자 메시지] > [일반] > [발송 결과 웹훅]에서 문자 메시지 발송 API 요청의 결과를 전달받을 서비스 서버의 웹훅 URL을 설정합니다. 웹훅 URL을 설정하지 않은 경우, 문자 메시지 발송 결과를 확인하려면 요청 ID로 발송 결과 조회 또는 문자 메시지 ID로 발송 결과 조회 API를 요청해야 합니다.

웹훅 URL로 전달되는 웹훅의 자세한 정보는 발송 결과 웹훅을 참고합니다.

앱 관리 페이지의 [문자 메시지] > [일반] > [발송 내역 조회]에서 6개월 이내의 문자 메시지 발송 내역을 조회할 수 있습니다. 각 발송 내역의 [상세보기]에서 상태 코드, 결과 코드와 같은 자세한 정보를 확인할 수 있습니다.

국제 메시지 트래픽을 제한하거나 관리하기 위해 국가별 모니터링 알림이나 차단을 설정할 수 있습니다. 설정이 되어있지 않은 국가는 트래픽이 증가되어도 제한 없이 메시지가 발송됩니다.

특정 국가로 보내는 메시지 발송을 차단할 수 있습니다.

앱 관리 페이지의 [문자 메시지] > [국제 메시지 설정] > [국가별 설정 추가]를 눌러 설정합니다. 특정 국가로 메시지 발송하는 것을 막으려면 국가 코드를 선택 후, [상태]를 [차단]으로 선택합니다. 기본값인 [전체]를 선택하면 대한민국을 포함한 모든 국가로 메시지 발송을 차단합니다.

설정한 기준을 넘으면 앱 관리자에게 알림을 보내거나, 자동으로 메시지 발송이 차단되도록 설정할 수 있습니다.

앱 관리 페이지의 [문자 메시지] > [국제 메시지 설정] > [국가별 설정 추가]을 눌러 [상태]를 [모니터링]으로 선택한 경우, 모니터링과 관련된 아래 항목을 설정합니다.

설정 항목설명
Threshold메시지 발송 제한 기준
탐지 주기 동안의 메시지 발송 건수
1부터 2,147,483,647 숫자 입력 가능
탐지 주기설정한 기준(Threshold)을 초과했는지 확인하는 주기
Threshold 도달 시 Action메시지 발송 건수가 설정한 기준을 초과할 때 수행할 동작
  • 알림: 앱 멤버에게 카카오디벨로퍼스 알림 발송 (앱 멤버 개인이 알림 채널 수단 설정 가능)
  • 자동 차단: 선택한 국가로 보내는 메시지 발송 차단
알림 주기메시지 발송 기준을 지속적으로 초과하는 경우, 알림을 보낼 주기
5분, 15분, 30분, 1시간, 12시간, 1일 중 선택

참고: [Threshold 도달 시 Action]에서 [알림]을 선택한 경우만 설정 가능
자동 차단 상태메시지 자동 차단 여부
  • ON: [Threshold 도달 시 Action]에서 [자동 차단]을 선택 후, 기준을 초과해 메시지 발송이 자동으로 차단된 상태
이 상태가 아닌 경우, 임의로 [ON]으로 변경 불가
  • OFF: 메시지 자동 발송 차단을 해제한 상태

참고: [Threshold 도달 시 Action]에서 [알림]을 선택한 경우, 자동 차단 기능은 적용되지 않아 항상 [OFF]로 표시

도움이 되었나요?