How-to guides

사용자는 Samsung Cloud Platform Console의 Message Hub 서비스를 통해 SMS, Email, Mobile Application Push Notification 등의 다양한 채널로 이벤트와 알림 메시지를 실시간으로 전달할 수 있습니다.

참고
채널의 월별 발신 개수는 SMS 10,000 건, Email 100,000 건, Push 1,000,000 건으로 제한됩니다. 발신 제한 개수를 증설하려면 Support Center > 서비스 요청을 통하여 진행해 주세요.

전화번호 추가하기

이벤트와 알림 메시지의 전송을 위한 발신 전화번호를 추가할 수 있습니다.

전화번호를 추가하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Application Service > Message Hub 메뉴를 클릭하세요. Message Hub의 Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 Phone Book 메뉴를 클릭하세요. Phone Book 목록 페이지로 이동합니다.
  3. Phone Book 목록 페이지에서 전화번호 추가 버튼을 클릭하세요. 전화번호 추가 페이지로 이동합니다.
  4. 전화번호 추가 페이지에서 필요한 정보들을 입력하세요.
    구분
    필수 여부
    상세 설명
    소유자필수전화번호 소유자 이름
    • 한글, 영문, 숫자, 특수문자(-_)를 사용하여 63자 이내로 입력
    • 중복 허용
    전화번호필수국가 번호와 전화번호
    • 특수문자(-)를 사용하여 63자 이내로 입력
    설명선택전화번호에 대한 추가 설명
    • 50자 이내로 입력
    태그선택태그 추가
    • 태그 추가 버튼을 클릭하여 태그를 생성하여 추가하거나, 기존 태그 수정 가능
    • 최대 50개까지 추가 가능
    • 추가된 신규 태그는 서비스 생성 완료 후 적용
    표. 전화번호 추가 정보 입력 항목
  5. 요약 패널에서 상세 정보와 예상 청구 금액을 확인하고, 완료 버튼을 클릭하세요. 추가 확인 알림 팝업창이 열립니다.
  6. 알림 팝업창에서 내용을 확인하고, 확인 버튼을 클릭하세요.
    • 전화번호 추가가 완료되면, Phone Book 목록 페이지에서 추가한 전화번호를 확인할 수 있습니다.

Push Application 추가하기

이벤트와 알림 메시지를 전송을 위한 발신 Push Application을 추가할 수 있습니다.

Push Application을 추가하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Application Service > Message Hub 메뉴를 클릭하세요. Message Hub의 Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 Push Application 메뉴를 클릭하세요. Push Application 목록 페이지로 이동합니다.
  3. Push Application 목록 페이지에서 Application 추가 버튼을 클릭하세요. Application 추가 페이지로 이동합니다.
  4. Application 추가 페이지에서 필요한 정보들을 입력하세요.
    구분
    필수 여부
    상세 설명
    Application명필수Push Application 이름
    • 영문 대소문자와 숫자를 사용하여 4~255자로 입력
    • 중복 체크 필요
    자격증명필수json 형식의 FCM 자격 증명 정보
    설명선택Push Application에 대한 추가 설명
    • 50자 이내로 입력
    태그선택태그 추가
    • 태그 추가 버튼을 클릭하여 태그를 생성하여 추가하거나, 기존 태그 수정 가능
    • 최대 50개까지 추가 가능
    • 추가된 신규 태그는 서비스 생성 완료 후 적용
    표. Push Application 추가 정보 입력 항목
  5. 요약 패널에서 상세 정보와 예상 청구 금액을 확인하고, 완료 버튼을 클릭하세요. 추가 확인 알림 팝업창이 열립니다.
  6. 알림 팝업창에서 내용을 확인하고, 확인 버튼을 클릭하세요.
    • Push Application 추가가 완료되면, Push Application 목록 페이지에서 추가한 Push Application을 확인할 수 있습니다.

Domain 추가하기

이벤트와 알림 메시지 전송을 위한 발신 Email용 Domain을 추가할 수 있습니다.

참고
Domain을 사용하려면 Domain 인증이 필요합니다. Support Center > 서비스 요청을 통하여 인증을 진행해 주세요.

Domain을 추가하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Application Service > Message Hub 메뉴를 클릭하세요. Message Hub의 Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 Email 관리 > Domain 메뉴를 클릭하세요. Domain 목록 페이지로 이동합니다.
  3. Domain 목록 페이지에서 Domain 추가 버튼을 클릭하세요. Domain 추가 페이지로 이동합니다.
  4. Domain 추가 페이지에서 필요한 정보들을 입력하세요.
    구분
    필수 여부
    상세 설명
    Email 도메인필수Email용 도메인 이름
    • 중복 체크 필요
    설명선택도메인에 대한 추가 설명
    • 50자 이내로 입력
    태그선택태그 추가
    • 태그 추가 버튼을 클릭하여 태그를 생성하여 추가하거나, 기존 태그 수정 가능
    • 최대 50개까지 추가 가능
    • 추가된 신규 태그는 서비스 생성 완료 후 적용
    표. Domain 추가 정보 입력 항목
  5. 요약 패널에서 상세 정보와 예상 청구 금액을 확인하고, 완료 버튼을 클릭하세요. 추가 확인 알림 팝업창이 열립니다.
  6. 알림 팝업창에서 내용을 확인하고, 확인 버튼을 클릭하세요.
    • Domain 추가가 완료되면, Domain 목록 페이지에서 추가한 Domain을 확인할 수 있습니다.

Email 추가하기

이벤트와 알림 메시지 전송을 위한 발신 Email 주소를 추가할 수 있습니다.

Email 주소를 추가하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Application Service > Message Hub 메뉴를 클릭하세요. Message Hub의 Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 Email 관리 > Email 메뉴를 클릭하세요. Email 목록 페이지로 이동합니다.
  3. Email 목록 페이지에서 Email 추가 버튼을 클릭하세요. Email 추가 페이지로 이동합니다.
  4. Email 추가 페이지에서 필요한 정보들을 입력하세요.
    구분
    필수 여부
    상세 설명
    Email Address필수메시지 전송을 위한 발신 Email 주소
    • 중복 체크 필요
    설명선택Email에 대한 추가 설명
    • 50자 이내로 입력
    태그선택태그 추가
    • 태그 추가 버튼을 클릭하여 태그를 생성하여 추가하거나, 기존 태그 수정 가능
    • 최대 50개까지 추가 가능
    • 추가된 신규 태그는 서비스 생성 완료 후 적용
    표. Email 추가 정보 입력 항목
  5. 요약 패널에서 상세 정보와 예상 청구 금액을 확인하고, 완료 버튼을 클릭하세요. 추가 확인 알림 팝업창이 열립니다.
  6. 알림 팝업창에서 내용을 확인하고, 확인 버튼을 클릭하세요.
    • Email 추가가 완료되면, Domain 목록 페이지에서 추가한 Email을 확인할 수 있습니다.

메시지 채널별 상세 정보 확인하기

Message Hub 서비스는 메시지 채널별 목록과 상세 정보를 확인하고 수정할 수 있습니다. 상세 페이지는 상세 정보, 접근 제어, 태그, 작업 이력 탭으로 구성되어 있습니다.

참고
Domain 상세 페이지에서는 접근 제어 탭이 표시되지 않습니다.

채널별 상세 정보를 확인하려면 다음 절차를 따르세요.

  1. 모든 서비스 > Application Service > Message Hub 메뉴를 클릭하세요. Message Hub의 Service Home 페이지로 이동합니다.
  2. Service Home 페이지에서 목록을 확인하려는 메시지 채널을 선택하세요. {채널} 목록 페이지로 이동합니다.
  3. {채널} 목록 페이지에서 채널별 목록과 상태를 확인하세요.
    • Phone Book: 등록된 전화번호 목록 표시
    • Push Application: 등록된 Push Application 목록 표시
    • Domain: 등록된 Email용 도메인 목록 표시
      • Email 관리 > Domain 메뉴을 클릭하여 이동
    • Email: 등록된 Email 목록 표시
      • Email 관리 > Email 메뉴을 클릭하여 이동
    • {채널} 목록 페이지 상단에는 부가 기능에 대한 정보가 표시됩니다.
      구분상세 설명
      삭제항목 삭제
      • 삭제하려는 항목에 체크한 후 삭제 버튼 클릭
      검색어 입력창검색어를 입력하여 검색
      상세 검색원하는 항목으로 필터링하여 검색
      {채널} 추가메시지 채널별 항목 추가
      • {채널} 추가 버튼을 클릭하면 {채널} 추가 페이지로 이동
      설정 아이콘목록에 표시할 컬럼 항목 설정
      표. 부가 기능
  4. {채널} 목록 페이지에서 상세 정보를 확인할 항목을 클릭하세요. {채널} 상세 페이지로 이동합니다.
    • {채널} 상세 페이지 상단에는 상태 정보와 부가 기능에 대한 정보가 표시됩니다.
      구분상세 설명
      상태서비스 상태
      • Creating: 생성 중
      • Active: 정상 작동 중
      • Editing: 설정 변경 중
      • Terminating: 삭제 중
      • Error: 에러 발생
      삭제항목 삭제
      Email 인증소유자 인증
      • Email 상세 페이지에서만 표시되며, 최초 1회 인증 후에는 표시되지 않음
      • 소유자의 Email로 전송된 인증 번호를 Email 인증 팝업창에 입력한 후, 확인 버튼 클릭
      표. 상태 정보와 부가 기능
    • {채널} 상세 페이지에서 정보를 확인하거나 수정할 수 있고, 상세 정보, 접근 제어, 태그, 작업 이력 탭으로 구성됩니다.
      • Domain 상세 페이지에서는 접근 제어 탭이 표시되지 않습니다.

상세 정보

{채널} 목록 페이지에서 선택한 메시지 채널의 상세 정보를 확인하고, 필요한 경우 정보를 수정할 수 있습니다.

채널별 공통 상세 정보

채널별 상세 정보의 공통 항목은 다음과 같습니다.

구분상세 설명
서비스서비스 이름
자원 유형자원 유형
SRNSamsung Cloud Platform에서의 고유 자원 ID
자원명자원 이름
자원 ID서비스에서의 고유 자원 ID
생성자서비스를 생성한 사용자
생성 일시서비스를 생성한 일시
수정자서비스 정보를 수정한 사용자
수정 일시서비스 정보를 수정한 일시
설명추가 설명
  • 수정 버튼을 클릭하여 내용 변경 가능
표. 상세 정보 공통 항목

채널별 상세 정보

채널별 상세 정보 항목은 다음과 같습니다.

구분상세 설명
소유자전화번호 명의자
전화번호소유자의 전화번호
발신 번호 인증 상태발신용 번호로 사용하기 위한 인증 진행 상태
  • 확인 완료, 확인 필요, 확인 중, 또는 삭제 중으로 표시
  • Support Center > 서비스 요청을 통하여 인증 서류를 등록해 주세요.
발신 번호 사용발신 번호 사용 여부
  • 수정 버튼을 클릭하여 사용 여부 변경 가능
표. 전화번호 상세 정보 항목
구분상세 설명
Application명Push Application 이름
자격증명FCM 자격 증명 정보
  • 보기 버튼을 클릭하여 팝업창에서 정보 확인 가능
표. Push Application 상세 정보 항목
구분상세 설명
인증 토큰인증 토큰 정보
  • 보기 버튼을 클릭하여 팝업창에서 정보 확인 가능
Email 도메인Email용 도메인 주소
도메인 보호도메인 보호 기능 사용 여부
  • 해당 도메인이 인증된 후에는 자동으로 보호 기능이 활성화
  • 보호 기능이 활성화되면 다른 Account에서 해당 도메인 사용 불가
  • 설정 버튼을 클릭하여 사용 여부 변경 가능
SPF 레코드SPF 레코드 검증 상태
  • 검증 버튼을 클릭하여 팝업창에서 레코드 추가 가능
  • 레코드 반영 상태를 완료 또는 확인 필요로 표시
DKIMDKIM 레코드 정보
  • 보기 버튼을 클릭하여 팝업창에서 정보 확인 가능
  • DNS 레코드 관련 문의는 DNS 관리자에게 연락하세요.
DMARCDMARC 레코드 정보
  • 보기 버튼을 클릭하여 팝업창에서 정보 확인 가능
  • DNS 레코드 등록 또는 관련 문의는 DNS 관리자에게 연락하세요.
표. Domain 상세 정보 항목
구분상세 설명
Email Address메시지를 전송을 위한 발신 Email 주소
인증 상태Email 인증 상태
표. Email 상세 정보 항목

접근 제어

{채널} 상세 페이지에서 선택한 메시지 채널의 접근 제어 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

참고
Domain 상세 페이지에서는 접근 제어 탭이 표시되지 않습니다.
구분상세 설명
엔드포인트엔드포인트 유형
  • 수정 버튼을 클릭하여 유형 변경 가능
  • 프라이빗 엔드포인트를 비활성하면, 설정된 엔드포인트 접근제어 리스트는 삭제됩니다.
프라이빗 엔드포인트프라이빗 엔드포인트 정보
퍼블릭 엔드포인트퍼블릭 엔드포인트 정보
퍼블릭 접근 허용 IP퍼블릭 접근 허용 IP 목록
  • 수정 버튼을 클릭하여 접근 허용 IP를 추가하거나 삭제 가능
  • CIDR 형식(IP주소/서브넷마스크) 및 IP 주소를 최대 100개까지 입력 가능
  • 0.0.0.0/0과 127.0.0.1/32는 추가 불가
프라이빗 접근 허용 자원프라이빗 접근 허용 서비스와 자원 목록
  • 수정 버튼을 클릭하여 접근 허용 자원을 추가하거나 삭제 가능
표. 접근 제어 탭 항목

태그

{채널} 상세 페이지에서 선택한 메시지 채널의 태그 정보를 확인하고, 추가하거나 변경 또는 삭제할 수 있습니다.

구분상세 설명
태그 목록태그 목록
  • 태그의 Key, Value 정보 확인 가능
  • 최대 50개까지 추가 가능
  • 태그 입력 시 기존에 생성된 Key와 Value 목록을 검색하여 선택
표. 태그 탭 항목

작업 이력

{채널} 상세 페이지에서 선택한 메시지 채널의 작업 이력을 확인할 수 있습니다.

구분상세 설명
작업 이력 목록변경 이력
  • 작업 내역, 작업 일시, 자원 유형, 자원명, 작업 결과, 작업자 정보 확인
  • 목록에서 항목을 클릭하면 작업 이력 상세 팝업창 표시
  • 상세 검색 버튼을 통해 상세 검색 기능 제공
표. 작업 이력 탭 항목

발신 번호 사용을 위한 인증 절차 확인하기

메시지 발신 번호를 등록하고 사용하기 위한 인증 절차와 신청 시 필요한 서류, 서류 발급 방법을 확인할 수 있습니다.

발신 번호 인증 서류 등록

발신 번호를 사용하기 위한 인증 서류 등록은 Support Center > 서비스 요청을 통해서 등록할 수 있습니다. 서류 확인과 인증이 완료되면 발신 번호 인증 상태가 확인 완료로 표시되며 해당 전화번호를 발신 번호로 지정하여 SMS 메시지를 전송할 수 있습니다.

발신 번호 명의자에 따른 인증 서류

발신 번호의 명의자에 따른 인증에 필요한 서류는 다음과 같습니다.

구분상세 설명
사업자등록증메시지를 발송하는 기업이나 단체가 실제로 존재하는 합법적인 사업자인지 검증하는 문서
통신서비스 이용증명원
  • 메시지 발송 시 화면에 표시될 회신 번호(고객센터 번호 등)를 실제 해당 기업이 소유하거나 임차했는지 증명하는 문서
  • 마스킹(숨김) 처리한 부분이 없어야 하며, 최근 3개월 이내 발급된 서류만 등록 가능
  • 발신 번호를 이용 중인 통신사를 통하여 발급
재직증명서
  • 메시지 시스템을 신청하고 조작하는 담당자가 해당 기업의 정당한 직원(대리인)이 맞는지 확인하여 제3자의 사업자 정보 도용을 차단하는 문서
  • 발급일이 표기되고 직인이 날인된 서류만 등록 가능
  • 주민번호 뒤 6자리는 반드시 마스킹(숨김) 처리 (예시: 000000-0*****)
이용승낙서사용자가 제출한 서비스 신청을 통신사나 서비스 제공업체가 최종적으로 허가하고, 양측이 서비스 이용 계약을 공식 체결했음을 증명하는 문서
표. 인증 필요 서류

이용승낙서 양식

이용승낙서는 아래와 같은 양식으로 작성하여 주세요.

전화번호 이용승낙서

발신번호 명의자는 [*] 서비스 계정 명의자에게 발신번호 명의자의 아래와 같은 전화번호 사용을 허락함.

• 발신번호 명의자 정보:
• 계정 명의자 정보:
• 목적:
• 전화번호 목록:
• 별첨: 아래와 같은 서류를 함께 제출할 것

1) 통신서비스이용증명원 (전화번호 목록 내 기재되어 있는 전화번호와 모두 일치할 것)
2) 사업자등록증
3) 발신번호 명의자와 계정 명의자 간 관계를 확인할 수 있는 문서 (예시: 업무위수탁 계약서. 본점–지점 증빙서류 등)
4) 전화번호 목록에 임직원의 번호가 포함된 경우 해당 임직원의 재직증명서

발신번호 명의자 OOO (인)

통신사별 증빙 서류 발급 방법

발신 번호의 통신사별 서류 발급 방법은 다음과 같습니다.

참고
  • 통신 서비스 이용증명원은 각 통신사 홈페이지에서 다운로드할 수 있습니다.
  • 통신사마다 가입확인서, 가입증명원, 이용계약 등록사항 증명서 등으로 명칭이 다를 수 있습니다.
구분상세 설명
SKT 바로 가기
  • 발급 방법: 로그인 > 나의 가입정보 > 이용계약증명서 조회
  • 모바일 서비스 고객센터: 114, 080-011-6000, 1599-0011
  • 유선 서비스 고객센터: 080-816-2000, 1600-2000
KT 바로 가기
  • 발급 방법: 로그인 > 가입정보 > 조회/변경 > 가입증명원 인쇄
  • 모바일 서비스 고객센터: 114, 1588-0010
  • 유선 서비스 고객센터: 100
LGU+ 바로 가기
  • 발급 방법: 로그인 > 상품가입안내 > 가입사실확인 조회
  • 모바일 서비스 고객센터: 114, 1544-0010
  • 유선 서비스 고객센터: 101
알뜰폰, 기타 통신사
  • SK브로드밴드 고객센터: 106
  • 세종텔레콤 고객센터: 1688-1000, 080-889-1000
  • KCT한국케이블텔레콤 고객센터: 070-8188-0114
  • 헬로모바일 고객센터: 1855-1140(LGU+), 1855-1144(KT), 1855-2114(SKT)
표. 서류 발급 방법
Overview
Message API reference