노티플라이에서 문자 발송하기

1. 발신 번호 사전등록

전기통신사업법 제84조의2(통신사업자의 의무) 전화번호의 거짓표시 금지 및 이용자 보호에 따라, 발신번호 사전등록제가 시행되고 있습니다. 본 제도의 통신사의 스팸문자 차단 정책에 따라, 발신번호를 사전에 등록해야만 문자를 발송할 수 있도록 하는 제도입니다.

1-1. 필요 서류 준비

1. 통신서비스 이용증명원

통신서비스 이용증명원이란 이용자 본인이 사용하는 전화번호를 증명하는 서류입니다. 이용하시는 통신사에서 발급 가능하며 발급 방법은 고객 센터에 전화를 통해 발급 요청할 수 있습니다.

통신사	서류명	연락처
KT 고객센터	가입증명원	1588-0114
LG U+	가입사실 확인서	1544-0001
SKT	이용계약증명서	080-8282-123
세종텔레콤		1699-1000
KCT한국케이블텔레콤		070-8188-0114
헬로모바일KT		1855-1144
헬로모바일SKT		070-8188-0114

통신서비스 이용증명원 상의 명의자는 사업자 또는 대표자여야 합니다.
통신서비스 이용증명원에는 마스킹(숨김) 처리한 부분이 없어야 하며, 최근 3개월 이내 발급된 서류만 등록 가능합니다.

2. 이용승낙서

(주)그레이박스에서 제공하는 양식을 다운로드하여 필요한 내용을 작성합니다.
‘계정 명의자 정보’는 ‘주식회사 그레이박스’로 입력해주세요.

3. 사업자등록증

1-2. 노티플라이에 발신번호 등록하기

노티플라이에 로그인 후, 설정 > 채널별 발신 키 정보 > 문자 메뉴로 이동하여 등록하기 버튼을 클릭합니다.
플랫폼을 notifly로 선택합니다.
1-1에서 준비한 서류를 첨부하고, 등록하기 버튼을 클릭합니다.

2. 문자 테스트 메시지 발송

캠페인 생성에서 문자 테스트 메시지 발송을 통하여 발송 준비가 잘 되었는지 확인해 주세요. 주의사항:

문자 메시지 발송에는 이모티콘 사용이 불가능합니다. 참고: FAQ - 문자 메시지 이모티콘 사용 불가
문자 메시지가 스팸으로 분류되어 발송되지 않을 수 있습니다. 통신사 자체 스팸 필터링이 동작하였을 경우 휴대폰 자체의 문자 스팸함이 아닌 통신사에서 직접 관리하는 스팸 서비스 쪽에서 분류될 수 있습니다. 자세한 내용은 통신사별 스팸차단 안내를 참고해 주세요.

3. 080 수신거부번호 설정 (선택)

광고성 메시지를 전송하기 위해서는, 문자 메시지 내용 앞 ‘(광고)’ 라는 문자와 함께 수신거부 번호를 안내해야 합니다. 080 수신거부번호 발급이 필요한 경우, contact@notifly.tech 또는 슬랙 채널로 문의해주세요.

080 번호는 발급 번호당 월 3만원의 추가 과금이 발생합니다. 노티플라이 월 구독료와 함께 청구됩니다.
080 번호 발급은 영업일 기준 3-4일 소요됩니다.
‘광고성 메시지 여부’가 체크된 문자 메시지 발신 시 080 수신거부 명단을 필터합니다.
- 카카오 광고성 메시지(친구톡, 브랜드메시지)의 대체 문자 발송에 대해서도 해당합니다.
080 수신거부번호 명단은 API를 통해 고객사에서 직접 관리도 가능합니다(조회, 추가, 삭제 가이드).
- 수신 거부 번호 등록 시 웹훅 발송도 지원합니다.

4. 문자메시지 트래킹 링크 (Tracking Link)

문자메시지의 채널 특성 상 링크 클릭에 대한 집계는 기본적으로 불가합니다. 필요한 경우 부가 기능으로 제공하는 트래킹 링크를 이용할 수 있습니다.

트래킹 링크 클릭당 5원이 부과됩니다.

LMS, MMS에서만 지원합니다.

유저여정에서는 트래킹 링크를 지원하지 않습니다.

[설정 방법]

이제 캠페인을 생성합니다. 생성 화면에서 발송 시점과 발송 대상을 설정한 뒤 메시지 및 액션 섹션에서 트래킹 링크를 클릭합니다.
url을 입력합니다.
링크 추가 버튼을 클릭합니다.
트래킹 링크가 활성화된 링크는 원본 URL 대신 노티플라이의 단축 링크로 변환되어 발송됩니다. 입력된 url을 수정하시 마세요.

5. 발송 결과 수신 웹훅

노티플라이 문자 발송(NHN 기반)의 SMS·LMS·MMS 처리 결과를 고객사 서버에서 받을 수 있습니다. 캠페인과 유저여정의 발송 성공·실패·건너뜀 결과를 메시지별 JSON으로 전달합니다. 성공은 발송 결과를 뜻하며, 사용자의 메시지 열람을 의미하지 않습니다. 카카오 직접 연동에서 실패 후 노티플라이 문자로 대체 발송한 결과도 지원합니다. 다른 문자 발송 플랫폼과 다른 대행사의 대체 문자 결과는 이 웹훅의 지원 범위에 포함되지 않습니다. 080 수신거부 번호 등록 웹훅과는 별개의 기능입니다.

설정 방법

현재 문자 발송 결과 웹훅은 프로젝트 설정으로 등록하며, 콘솔에서 직접 URL을 등록하는 항목은 제공하지 않습니다.

JSON 본문의 POST 요청을 처리할 수 있는 외부 접근 가능한 HTTPS 수신 서버를 준비합니다.
프로젝트 ID와 수신 URL을 준비합니다.
전용 슬랙 채널 또는 고객지원에 문자 발송 결과 웹훅 연동을 문의합니다.

프로젝트의 text_message_delivery_result_webhook 설정 형식은 다음과 같습니다. 아래는 연동 시 사용하는 설정 예시이며, 공개 API 요청 본문은 아닙니다.

{
  "text_message_delivery_result_webhook": {
    "url": "https://example.com/webhooks/notifly/text-message",
    "method": "POST",
    "headers": {
      "Content-Type": "application/json"
    }
  }
}

사용자 ID와 전화번호가 포함되므로 운영 환경에서는 HTTPS를 사용해 주세요. 등록하지 않았거나 URL이 비어 있으면 전송하지 않습니다. URL 변경·해제도 연동 담당자에게 요청해 주세요. 설정은 캐시되므로 변경이 즉시 반영되지 않을 수 있습니다.

발생 가능한 이벤트

`eventName`	발생 조건
`send_success`	발송 결과 수집 또는 제공사 결과 콜백에서 성공이 확인됨
`send_failure`	확정된 발송 요청 거절, 최종 발송 실패 또는 발송 정책 검사 자체의 실패
`skipped__fatigue_management`	이벤트 기반 캠페인의 피로도 제한으로 발송을 건너뜀
`skipped__excluded_user_filter`	이벤트 기반 캠페인의 제외 유저 조건으로 발송을 건너뜀
`skipped__global_frequency_limit_filter`	전역 발송 횟수 제한으로 발송을 건너뜀
`skipped__campaign_delivery_stopped`	단발 예약 캠페인의 발송 중단 상태를 확인함
`skipped__forbidden_timing_filter`	발송 금지 시간 정책에 따라 발송을 건너뜀
`skipped__forbidden_timing_requeue_failed`	금지 시간 이후로 발송을 미루려 했으나 재예약 항목이 생성되지 않음

pending과 재예약 성공 이벤트인 requeued__forbidden_timing은 전송하지 않습니다. 재예약 실패는 skipped__forbidden_timing_requeue_failed로 전송합니다. 메시지 ID와 캠페인·유저여정 식별 정보 등이 없는 결과는 전송 대상에서 제외되므로, 모든 내부 오류나 대상 제외가 웹훅으로 전달되는 것은 아닙니다. 발송 실패 시 실패 사유가 제공되는 경우 failureReason에 포함됩니다.

요청 본문 스키마

필드	타입	필수 여부	설명
`version`	string	필수	스키마 버전. 현재 `"1.0"`
`projectId`	string	필수	노티플라이 프로젝트 ID
`messageId`	string	필수	결과에 대응하는 문자 메시지 ID
`userId`	string 또는 null	필수	고객사 사용자 ID. 확인할 수 없으면 `null`
`phoneNumber`	string 또는 null	필수	수신자 전화번호. 확인할 수 없으면 `null`
`resourceType`	string	필수	`"campaign"` 또는 `"user_journey"`
`campaignId`	string	캠페인 필수	캠페인 ID. 유저여정에는 포함하지 않음
`userJourneyId`	string	유저여정 필수	유저여정 ID. 캠페인에는 포함하지 않음
`userJourneyNodeId`	string	선택	유저여정 노드 ID. 정보가 있을 때 포함
`sessionId`	string	선택	실행 세션 ID. 정보가 있을 때 포함
`eventName`	string	필수	위 이벤트 표 참조
`failureReason`	string	선택	사유 문자열이 있을 때 포함
`timestamp`	number	필수	결과 처리 경로에서 기록한 시각의 Unix 타임스탬프(밀리초). 시각이 없으면 웹훅 데이터 생성 시각
`channelType`	string	필수	`"text-message"`
`metadata`	object	필수	문자 유형과 대체 발송 여부
`metadata.subtype`	string	필수	`"sms"`, `"lms"`, `"mms"`
`metadata.isFailover`	boolean	필수	일반 문자는 `false`, 지원되는 카카오 대체 문자는 `true`

메시지 본문은 포함되지 않습니다. timestamp를 수신자의 열람 시각으로 해석하지 마세요.

캠페인 문자 발송 성공 예시

{
  "version": "1.0",
  "projectId": "project-example",
  "messageId": "550e8400-e29b-41d4-a716-446655440000",
  "userId": "user-example",
  "phoneNumber": "01000000000",
  "resourceType": "campaign",
  "campaignId": "campaign-example",
  "eventName": "send_success",
  "timestamp": 1789106667000,
  "channelType": "text-message",
  "metadata": {
    "subtype": "sms",
    "isFailover": false
  }
}

유저여정 대체 문자 발송 성공 예시

카카오 발송 결과와 대체 문자 발송 결과는 각각의 채널 결과로 전달됩니다. 대체 문자 결과를 구분하려면 channelType과 metadata.isFailover를 함께 확인하세요.

{
  "version": "1.0",
  "projectId": "project-example",
  "messageId": "550e8400-e29b-41d4-a716-446655440001",
  "userId": "user-example",
  "phoneNumber": "01000000000",
  "resourceType": "user_journey",
  "userJourneyId": "journey-example",
  "userJourneyNodeId": "node-example",
  "sessionId": "session-example",
  "eventName": "send_success",
  "timestamp": 1789106667000,
  "channelType": "text-message",
  "metadata": {
    "subtype": "lms",
    "isFailover": true
  }
}

문자 발신 번호를 여러개 등록할 수 있나요?

여러 문자 발신 번호를 한 프로젝트에 등록하실 수 있습니다. 위 가이드를 참고해 서류를 등록해주세요.

외부에서 발급 받은 080 수신거부번호가 있습니다. 노티플라이에서 사용할 수 있나요?

외부에서 발급 받은 080 수신거부번호도 노티플라이에서 사용할 수 있으나 유의사항을 확인해주세요.

광고성 문자 메시지(실패 시 대체문자 포함) 발송 시 수신거부 명단으로 자동 필터되지 않습니다. 유저 커스텀 속성으로 구현하여 자체적으로 필터해주시기 바랍니다.
광고성 문자 메시지 본문에 의무 문구를 직접 삽입해주세요.
- 광고 문구, 080 수신거부번호

시작하기 전에

캠페인

유저 여정

데이터

채널

분석

연동

콘솔 메뉴

Resources

노티플라이에서 문자 발송하기

1. 발신 번호 사전등록

1-1. 필요 서류 준비

1. 통신서비스 이용증명원

2. 이용승낙서

3. 사업자등록증

1-2. 노티플라이에 발신번호 등록하기

2. 문자 테스트 메시지 발송

3. 080 수신거부번호 설정 (선택)

4. 문자메시지 트래킹 링크 (Tracking Link)

5. 발송 결과 수신 웹훅

설정 방법

발생 가능한 이벤트

요청 본문 스키마

캠페인 문자 발송 성공 예시

유저여정 대체 문자 발송 성공 예시

​1. 발신 번호 사전등록

​1-1. 필요 서류 준비

​1. 통신서비스 이용증명원

​2. 이용승낙서

​3. 사업자등록증

​1-2. 노티플라이에 발신번호 등록하기

​2. 문자 테스트 메시지 발송

​3. 080 수신거부번호 설정 (선택)

​4. 문자메시지 트래킹 링크 (Tracking Link)

​5. 발송 결과 수신 웹훅

​설정 방법

​발생 가능한 이벤트

​요청 본문 스키마

​캠페인 문자 발송 성공 예시

​유저여정 대체 문자 발송 성공 예시

1. 발신 번호 사전등록

1-1. 필요 서류 준비

1. 통신서비스 이용증명원

2. 이용승낙서

3. 사업자등록증

1-2. 노티플라이에 발신번호 등록하기

2. 문자 테스트 메시지 발송

3. 080 수신거부번호 설정 (선택)

4. 문자메시지 트래킹 링크 (Tracking Link)

5. 발송 결과 수신 웹훅

설정 방법

발생 가능한 이벤트

요청 본문 스키마

캠페인 문자 발송 성공 예시

유저여정 대체 문자 발송 성공 예시