개발가이드

01 AGENT 연동방식

  1. 01 HYMESSAGE SMS, LMS, MMS, GMS, KAKAO 전송용 AGENT는 고객센터로 문의시 안내해 드립니다.     고객센터 바로가기
  2. 02 AGENT 연동 방식이란?
    • Agent 연동 방식은 HYMESSAGE가 제공하는 Java 기반 전송 프로그램을 고객사 서버 또는 PC에 설치하고, 고객사 Data Base와 연동해 문제 메시지를 발송 할 수 있습니다.
    • 고객사에서 운용 가능한 서버 또는 PC와 Data Base가 준비되어야 하며, Data Base 관리는 고객 측에서 운용하여야 합니다.
  3. 03 기능도
    <그림 1 기능도>
    1. 고객사에 설치된 Agent는 위 <그림 1>을 따라서 운영 됩니다.
    2. CUSTOMER는 고객사에서 운영하는 환경을 보여주며 일반적으로 LINUX, WINDOWS 기반 서버에서 동작합니다
    3. AGENT는 HYMESSAGE가 제공하고 고객사 서버에 설치되는 연동 모듈 입니다.
    4. HYMESSAGE G/W는 전송 모듈과 메시지를 주고 받는 서버를 뜻하며, 모든 메시지는 HYMESSAGE G/W를 거쳐 통신사로 전달 됩니다.
    5. TELECOM은 메시지를 받을 당사자가 가입된 KT, SKT, LGU 등 통신 사업자를 뜻합니다.
    6. <그림 1> 기능도에서 처럼 AGENT와 HYMESSAGE G/W는 문자 메시지를 주고 받기 위한 중계자 역할을 하고 CUSTORMER는 자체 DB를 통해 수신 결과를 확인 할 수 있습니다.
  4. 03 요구 사양 및 환경
    1. JRE/JDK 7 버전 이상 설치된 모든 OS 환경에서 동작 가능합니다.
    2. ORACLE, MYSQL, MARIA, MSSQL, POSTGRE, SYBASE 지원합니다.
    3. 최소 사양 - 듀얼 코어, 2G Memory, 1GB HDD, 100Mpbs 네트워크 대역폭이 필요합니다.
    4. 대량 발송시 – 쿼드 코어, 8G Memory, 10GB HDD, 500Mbps 네트워크 대역폭이 필요합니다.

02 AGENT 설치 순서

<그림 2 설치 순서도>

01 회원가입
본 홈페이지를 통해 회원 가입 가능합니다.
02전송 모듈 요청 및 AGENT 계정 발급
회원 가입 후 회원명과 전송 묘듈 요청을 고객센터 이메일로 요청해 주시면, 전송 모듈 및 AGENT 계정 발급이 진행 됩니다.
03 방화벽 작업
이후 고객단에서는 AGENT가 설치될 서버에서 HYMESSAGE G/W와 방화벽 테스트 및 작업을 진행해야 합니다.

04 발신 번호 사전 등록
  1. 실제 발송시 사용될 발신 번호를 등록해 주셔아 합니다. 발신 번호 사전 등록제는 KISA에서 공고한 정보 보호 가이드 라인을 준수합니다.
  2. 메인 화면에서 [문자 메시지] – [주소록] – [발신번호 등록] 클릭

  3. 고객사 상황에 맞게 발신 번호 등록 방식을 선택 후 발신 번호 사전 등록 진행

03 AGENT 설치 방법

04 AGENT 설정

  • 01 AGENT 상세 설정 가이드는 AGENT 설치 메뉴얼 참고 부탁드립니다.
  • 02 TEST용 데이터를 DATA BASE에 INSERT
    • 가입자의 통신사명 - TR_SENDSTAT이 2이면 전송 끝, TR_RSLTSTAT이 0이면 성공, 그외 실패
    • SELECT STATUS, RSLT FROM MMS_LOG_YYYYMM - STATUS가 3이면 전송 끝, RSLT가 0이면 성공, 그외 실패

05 테스트 예제 쿼리

<그림 3, 전송시 흐름도와 STATUS간의 관계>

  • 01 문자 메시지 전송 상태에 따른 STATUS 값은 <그림 3>을 참고
  • 02 테스트용 예제 쿼리는 고객센터로 이메일 문의 바랍니다.      고객센터 바로가기