서버를 보유중이신가요?
Agent를 설치하고 실행하면 자동생성되는 테이블에 데이터만 삽입하면 자동발송되고 결과도 수신됩니다.
DB 문자연동 방법
연동 자료실
환경에 맞는 연동방법을 확인하세요.
연동방식을 선택하면 주요 특징, 처리 흐름, 환경별 샘플과 필요한 파일을 한곳에서 확인할 수 있습니다.
권장 연동방식
XDB Agent를 이용한 DB연동
발송 데이터를 DB에 삽입하면 XDB Agent가 데이터를 조회하여 Gateway로 자동전송하고, 처리 결과를 다시 DB에 업데이트해줍니다.
- SMS, LMS, MMS 발송 지원
- 실시간 및 예약전송 지원
- 전송결과 자동 업데이트
- Windows 및 Linux 지원
처리 흐름
업무시스템
발송 DB
XDB Agent
쏜다넷 Gateway
샘플 미리보기
환경별 이용안내
설치 안내 또는 DB 종류를 선택하여 예문을 확인하세요.
- 연동계정 준비계정관리 메뉴에서 문자연동용 계정을 생성하고, 연동신청서를 제출합니다. (아이디,패스워드,서버IP 필요)
- Agent 파일 배치운영체제에 맞는 XDB Agent를 내려받아 서버의 적절한 위치에 압축을 풉니다.
- 환경정보 설정xdb.conf에 연동계정과 DB 연결정보를 입력합니다.
- 서비스 실행매뉴얼에 따라 실행하면 필수 테이블이 자동으로 생성됩니다.테이블이 생성되지 않는다면 로그파일을 확인하세요. DB서버 연결에 실패중일 수 있습니다.
- 발송 및 결과 확인발송 테이블에 데이터를 입력하고 결과가 업데이트되는지 확인합니다.전송되지 않는다면 로그파일을 학인하세요. 방화벽이 막혀있거나, 잔액이 없을 수 있습니다.
-- 각 컬럼에 대한 설명은 XDB 매뉴얼을 확인하세요.
/* 단문 -- 즉시전송 (REQ_DATE : 현재시간, MSG_TYPE : 4, SMS_TXT : 필수) */
INSERT INTO MSG_DATA(MSG_SEQ, CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE)
VALUES(MSG_DATA_SEQ.NEXTVAL, 0, SYSDATE, '수신번호', '발신번호', 'Test SMS입니다', 4);
/* 단문 -- 예약전송 (REQ_DATE : 미래시간) */
INSERT INTO MSG_DATA(MSG_SEQ, CUR_STATE, REQ_DATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE)
VALUES(MSG_DATA_SEQ.NEXTVAL, 0, SYSDATE, '2029-12-31 10:00:00', '수신번호', '발신번호', '예약 SMS입니다', 4);
/* 장문 (FILE_CNT : 0, MSG_TYPE : 6, CONT_SEQ : 필수) */
INSERT INTO MMS_CONTENTS_INFO(CONT_SEQ, FILE_CNT, MMS_SUBJECT, MMS_BODY)VALUES(MMS_CONTENTS_INFO_SEQ.NEXTVAL, 0, 'LMS 제목' , 'LMS 내용');
INSERT INTO MSG_DATA(MSG_SEQ, CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE, CONT_SEQ)
VALUES(MSG_DATA_SEQ.NEXTVAL, 0, SYSDATE, '수신번호', '발신번호', '', 6, MMS_CONTENTS_INFO_SEQ.CURRVAL);
/* 포토 -- 이미지만 (FILE_CNT = 1, MSG_TYPE : 6, CONT_SEQ : 필수) */
INSERT INTO MMS_CONTENTS_INFO(CONT_SEQ, FILE_CNT, MMS_SUBJECT, MMS_BODY, FILE_TYPE1, FILE_NAME1, SERVICE_DEP1 )VALUES(MMS_CONTENTS_INFO_SEQ.NEXTVAL, 1, 'MMS 제목' , '', 'IMG', 'C:/XDB2/attach/01.jpg', 'ALL');
INSERT INTO MSG_DATA(MSG_SEQ, CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE, CONT_SEQ)
VALUES(MSG_DATA_SEQ.NEXTVAL, 0, SYSDATE, '수신번호', '발신번호', '', 6, MMS_CONTENTS_INFO_SEQ.CURRVAL);
/* 포토 -- 텍스트+이미지 (FILE_CNT = 2, MSG_TYPE : 6, CONT_SEQ : 필수) */
INSERT INTO MMS_CONTENTS_INFO(CONT_SEQ, FILE_CNT, MMS_SUBJECT, MMS_BODY, FILE_TYPE1, FILE_NAME1, SERVICE_DEP1 )VALUES(MMS_CONTENTS_INFO_SEQ.NEXTVAL, 2, 'MMS 제목' , 'MMS 내용', 'IMG', 'C:/XDB2/attach/01.jpg', 'ALL');
INSERT INTO MSG_DATA(MSG_SEQ, CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE, CONT_SEQ)
VALUES(MSG_DATA_SEQ.NEXTVAL, 0, SYSDATE, '수신번호', '발신번호', '', 6, MMS_CONTENTS_INFO_SEQ.CURRVAL);-- 각 컬럼에 대한 설명은 XDB 매뉴얼을 확인하세요.
/* 단문 -- 즉시전송 (REQ_DATE : 현재시간, MSG_TYPE : 4, SMS_TXT : 필수) */
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE)
VALUES(0, GETDATE(), '수신번호', '발신번호', 'Test SMS입니다', 4);
/* 단문 -- 예약전송 (REQ_DATE : 미래시간) */
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE)
VALUES(0, '2029-12-31 10:00:00', '수신번호', '발신번호', '예약 SMS입니다', 4);
/* 장문 (FILE_CNT : 0, MSG_TYPE : 6, CONT_SEQ : 필수) */
INSERT INTO MMS_CONTENTS_INFO(FILE_CNT, MMS_SUBJECT, MMS_BODY)VALUES(0, 'LMS 제목' , 'LMS 내용');
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE, CONT_SEQ)
VALUES(0, GETDATE(), '수신번호', '발신번호', '', 6, @@IDENTITY);
/* 포토 -- 이미지만 (FILE_CNT = 1, MSG_TYPE : 6, CONT_SEQ : 필수) */
INSERT INTO MMS_CONTENTS_INFO(FILE_CNT, MMS_SUBJECT, MMS_BODY, FILE_TYPE1, FILE_NAME1, SERVICE_DEP1 )VALUES(1, 'MMS 제목' , '', 'IMG', 'C:/XDB2/attach/01.jpg', 'ALL');
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE, CONT_SEQ)
VALUES(0, GETDATE(), '수신번호', '발신번호', '', 6, @@IDENTITY);
/* 포토 -- 텍스트+이미지 (FILE_CNT = 2, MSG_TYPE : 6, CONT_SEQ : 필수) */
INSERT INTO MMS_CONTENTS_INFO(FILE_CNT, MMS_SUBJECT, MMS_BODY, FILE_TYPE1, FILE_NAME1, SERVICE_DEP1 )VALUES(2, 'MMS 제목' , 'MMS 내용', 'IMG', 'C:/XDB2/attach/01.jpg', 'ALL');
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE, CONT_SEQ)
VALUES(0, GETDATE(), '수신번호', '발신번호', '', 6, @@IDENTITY);-- 각 컬럼에 대한 설명은 XDB 매뉴얼을 확인하세요.
/* 단문 -- 즉시전송 (REQ_DATE : 현재시간, MSG_TYPE : 4, SMS_TXT : 필수) */
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE)
VALUES(0, NOW(), '수신번호', '발신번호', 'Test SMS입니다', 4);
/* 단문 -- 예약전송 (REQ_DATE : 미래시간) */
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE)
VALUES(0, '2029-12-31 10:00:00', '수신번호', '발신번호', '예약 SMS입니다', 4);
/* 장문 (FILE_CNT : 0, MSG_TYPE : 6, CONT_SEQ : 필수) */
INSERT INTO MMS_CONTENTS_INFO(FILE_CNT, MMS_SUBJECT, MMS_BODY)VALUES(0, 'LMS 제목' , 'LMS 내용');
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE, CONT_SEQ)
VALUES(0, NOW(), '수신번호', '발신번호', '', 6, LAST_INSERT_ID());
/* 포토 -- 이미지만 (FILE_CNT = 1, MSG_TYPE : 6, CONT_SEQ : 필수) */
INSERT INTO MMS_CONTENTS_INFO(FILE_CNT, MMS_SUBJECT, MMS_BODY, FILE_TYPE1, FILE_NAME1, SERVICE_DEP1 )VALUES(1, 'MMS 제목' , '', 'IMG', '/home/xonda/xdb2/attach/01.jpg', 'ALL');
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE, CONT_SEQ)
VALUES(0, NOW(), '수신번호', '발신번호', '', 6, LAST_INSERT_ID());
/* 포토 -- 텍스트+이미지 (FILE_CNT = 2, MSG_TYPE : 6, CONT_SEQ : 필수) */
INSERT INTO MMS_CONTENTS_INFO(FILE_CNT, MMS_SUBJECT, MMS_BODY, FILE_TYPE1, FILE_NAME1, SERVICE_DEP1 )VALUES(2, 'MMS 제목' , 'MMS 내용', 'IMG', '/home/xonda/xdb2/attach/01.jpg', 'ALL');
INSERT INTO MSG_DATA(CUR_STATE, REQ_DATE, CALL_TO, CALL_FROM, SMS_TXT, MSG_TYPE, CONT_SEQ)
VALUES(0, NOW(), '수신번호', '발신번호', '', 6, LAST_INSERT_ID());
간편 연동방식
Agent 설치가 필요 없는 소켓연동
웹사이트에서 쏜다넷 Gateway로 직접 소켓통신하여 단문문자를 전송하는 간단한 연동방식입니다.
- Agent 설치 불필요
- SMS 단문전용
- 예약전송 미지원
- 전송결과 미지원
처리 흐름
웹사이트
언어별 샘플
소켓통신
쏜다넷 Gateway
샘플 미리보기
환경별 이용안내
개발언어를 선택하여 소켓연동 예시를 확인하세요.
- 연동계정 준비계정관리 메뉴에서 문자연동용 계정을 생성하고, 연동신청서를 제출합니다. (아이디,패스워드,서버IP 필요)
- 개발언어 선택ASP, PHP, JSP 중 운영환경에 맞는 샘플을 내려받습니다.ASP는 첨부된 DLL을 추가로 설치하셔야합니다.
- 접속 및 전송샘플에 연동계정과 단문 메시지를 입력하여 Gateway로 전송합니다.
- 운영 적용SMS 실시간 전송 용도로 적용합니다. 예약전송과 결과수신은 지원되지 않습니다.
- 결과 확인전송결과는 홈페이지▶전송관리▶전송결과▶통합내역에서 확인가능합니다.전송내역이 조회되지 않는다면 방화벽이나 잔액을 확인해주세요.
- 실패 사유사전등록되지 않았거나, 명의도용차단서비스에 가입되었거나, 유효하지 않은 발신번호 등은 전송에 실패합니다.결번/이용정지 등 유효하지 않은 수신번호 등은 전송에 실패합니다.차단 설정된 키워드, 발신번호, 수신번호 등을 사용했거나, 미등록IP에서 연동을 시도했거나, 잔액이 부족한 경우 접수가 거부되어 전송결과에서 조회되지 않습니다.
<%
Class XONDASMS
...
Private Sub Class_Initialize()
sID = "쏜다넷연동아이디" '*** 10자리미만
sPWD = "쏜다넷연동패스워드" '*** 10자리미만
...
End Sub
...
End Class
%><% Option Explicit %>
<!--#include file="class.sms.asp"--%>
<%
Dim receiver, callback, sms_msg, err_msg, result
'--------------------------------------------------------------------------------------------------
' 수신번호(휴대폰번호) -- 복수일 경우 콤마로 구분 (ex: 01100000000,01000000000)
'--------------------------------------------------------------------------------------------------
receiver = ""
'--------------------------------------------------------------------------------------------------
' 발신번호(회신번호) -- 사전등록필수 (ex: 021234567)
'--------------------------------------------------------------------------------------------------
callback = ""
'--------------------------------------------------------------------------------------------------
' 전송내용(EUC-KR 기준 최대 80바이트)
'--------------------------------------------------------------------------------------------------
sms_msg = ""
'--------------------------------------------------------------------------------------------------
' SMS전송 (수신번호, 발신번호, 전송내용, 오류내용) -- 성공건수(0이상) 또는 오류번호(음수)를 반환함
'--------------------------------------------------------------------------------------------------
result = Func_SendSMS(receiver, callback, sms_msg, err_msg)
If result < 0 Then
Response.Write "접수 실패 : " & err_msg
Else
Response.Write "접수 성공 (" & result & "건)"
' 정상 처리된 경우 err_msg 에는 서버 접수에 실패한 번호가 반환됩니다.
If err_msg <> "" Then
Response.Write ", 실패 번호 (" & err_msg & ")"
End IF
End If
%><?php
class XONDASMS {
var $ID;
var $PWD;
...
function __construct() {
$this->ID = "쏜다넷연동아이디"; //*** 10자리미만
$this->PWD = "쏜다넷연동패스워드"; //*** 10자리미만
...
}
}
?><?php
header("Content-Type: text/html; charset=UTF-8");
########## 클래스 참조 ##########
include "class.sms.php";
########## 내용 구성 ##########
//--------------------------------------------------------------------------------------------------
//수신번호(휴대폰번호) -- 복수일경우 콤마로 구분 (ex: 01100000000,01000000000)
//--------------------------------------------------------------------------------------------------
$receiver = "";
//--------------------------------------------------------------------------------------------------
//발신번호(회신번호) -- 사전등록필수 (ex: 021234567)
//--------------------------------------------------------------------------------------------------
$callback = "";
//--------------------------------------------------------------------------------------------------
//전송내용(단문) -- EUC-KR 기준 최대 80바이트
//--------------------------------------------------------------------------------------------------
$sms_msg = "";
//--------------------------------------------------------------------------------------------------
//SMS전송 (수신번호, 발신번호, 전송내용, 오류내용) -- 성공건수(0이상) 또는 오류번호(음수)를 반환함
//---------------------------------------------------------------------------------------------------
$result = sendSMS($receiver, $callback, $sms_msg, $err_msg);
if($result < 0){
echo "접수 실패 : ".$err_msg;
}else{
echo "접수 성공 (".$result."건)";
// $result가 0 이상이면 $err_msg는 서버 접수에 실패한 수신번호 목록을 반환합니다.
if($err_msg != ""){
echo ", 실패 번호 (".$err_msg.")";
}
}
?># 쏜다넷 소켓연동 계정
xonda.sms.id=쏜다넷연동아이디
xonda.sms.password=쏜다넷연동패스워드
...<%@ page contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>
<%@ page import="net.xonda.sms.XondaSms" %>
<%
request.setCharacterEncoding("UTF-8");
//--------------------------------------------------------------------------------------------------
//수신번호(휴대폰번호) -- 복수일경우 콤마로 구분 (ex: 01100000000,01000000000)
//--------------------------------------------------------------------------------------------------
String receiver = "";
//--------------------------------------------------------------------------------------------------
//발신번호(회신번호) -- 사전등록필수 (ex: 021234567)
//--------------------------------------------------------------------------------------------------
String callback = "";
//--------------------------------------------------------------------------------------------------
//전송내용(단문) -- EUC-KR 기준 최대 80바이트
//--------------------------------------------------------------------------------------------------
String sms_msg = "";
//--------------------------------------------------------------------------------------------------
//SMS전송 (수신번호, 발신번호, 전송내용)
// getResultCode() : 성공건수(0이상) 또는 오류번호(음수)를 반환함
//---------------------------------------------------------------------------------------------------
XondaSms sms = new XondaSms();
XondaSms.SendResult result = sms.sendSms(receiver, callback, sms_msg);
if (result.getResultCode() < 0) {
out.print("접수 실패: " + result.getErrorMessage());
} else {
out.print("접수 성공 (" + result.getResultCode() + "건)");
if (result.getFailedNumbers().length() > 0) {
out.print(", 접수 실패 (" + result.getFailedNumbers() +")");
}
}
%>
응용프로그램 연동
Windows 프로그램을 위한 DLL연동
응용프로그램 프로젝트에서 배포 DLL을 참조하고 OPEN, SEND, CLOSE 역할의 함수를 호출하여 단문문자를 전송합니다.
- Windows 응용프로그램용
- SMS 단문전용
- 예약전송 미지원
- 전송결과 미지원
처리 흐름
응용프로그램
연동 DLL
소켓통신
쏜다넷 Gateway
샘플 미리보기
환경별 이용안내
개발환경에 맞는 매뉴얼을 다운받으신 후 이용안내에 따라 진행하세요.
- 연동계정 준비계정관리 메뉴에서 문자연동용 계정을 생성하고, 연동신청서를 제출합니다. (아이디,패스워드,서버IP 필요)
- 개발환경 선택MFC, VB, WIN32 중 프로젝트에 맞는 매뉴얼을 내려받습니다.
- DLL 참조배포 DLL을 프로젝트에서 참조하고 필요한 함수를 선언합니다.
- 함수 호출OPEN, SEND, CLOSE 순서로 호출하여 단문문자를 전송합니다.
- 운영 적용SMS 실시간 전송 용도로 적용합니다. 예약전송과 결과수신은 지원되지 않습니다.
- 결과 확인전송결과는 홈페이지▶전송관리▶전송결과▶통합내역에서 확인가능합니다.전송내역이 조회되지 않는다면 방화벽이나 잔액을 확인해주세요.
// 실제 함수명과 인자는 배포 샘플을 확인하세요.
int result = XONDA_OPEN(accountId, accountPassword);
if (result == 0) {
XONDA_SEND("01012345678", "안내 문자입니다.");
}
XONDA_CLOSE();' 실제 함수명과 인자는 배포 샘플을 확인하세요.
Dim result As Integer
result = XONDA_OPEN(accountId, accountPassword)
If result = 0 Then XONDA_SEND("01012345678", "안내 문자입니다.")
XONDA_CLOSE()// 실제 함수명과 인자는 배포 샘플을 확인하세요.
HMODULE module = LoadLibrary(TEXT("xonda.dll"));
// OPEN, SEND, CLOSE 함수 주소를 확인한 뒤 순서대로 호출합니다.
FreeLibrary(module);주요특징
- 운영 환경에 맞춰 DB연동·소켓연동·DLL연동 방식을 선택할 수 있습니다.
- 알림·인증문자 등 반복되는 발송 업무를 시스템에서 자동화할 수 있습니다.
- DB연동은 SMS·LMS·MMS 발송을 모두 지원합니다.
- 소켓연동·DLL연동은 SMS 실시간 전송만 지원합니다.
- 예약전송 및 전송결과 수신을 원하시면 DB연동 방식을 이용해주세요.
- 연동신청을 하시면 연동요금제가 적용됩니다.
주의사항
- 문자연동은 연동전용 계정이 필요합니다.
- 연동신청을 통해 계정마다 고정된 IP를 설정해야합니다.
- 문자발송에 사용할 발신번호를 사전에 등록해야합니다.
- 방화벽·접속정보·DB 권한 등 고객사 시스템 환경은 연동 방식에 맞게 준비해야 합니다.
- 광고문자와 수신동의 관련 법정 의무는 연동 발송에도 동일하게 적용됩니다.
- 사전등록되지 않은 IP로 지속적인 시도가 발생되거나,
사전등록되지 않은 발신번호로 지속적인 실패가 발생되면 계정이 차단될 수 있으니 주의바랍니다.
연동회원 전용 문자상품
금액이 클수록 단가는 내려가요
추가캐쉬 적립형 일반상품과 달리, 연동요금제는 선택한 상품에 따라 SMS·LMS·MMS 단가가 달라집니다.
(웹팩스,MO서비스 별도)
49,000원
VAT 별도
| 구분 | 건수 | 단가 | 할인율 |
|---|---|---|---|
| 단문 | 2,800건 | 17.5원 | 30.0%↓ |
| 장문 | 1,088건 | 45.0원 | 35.7%↓ |
| 포토 | 196건 | 250.0원 | — |
충전캐쉬 53,900원
연동회원 전용 충전하기99,000원
VAT 별도
| 구분 | 건수 | 단가 | 할인율 |
|---|---|---|---|
| 단문 | 6,000건 | 16.5원 | 34.0%↓ |
| 장문 | 2,250건 | 44.0원 | 37.1%↓ |
| 포토 | 404건 | 245.0원 | 2.0%↓ |
충전캐쉬 108,900원
연동회원 전용 충전하기180,000원
VAT 별도
| 구분 | 건수 | 단가 | 할인율 |
|---|---|---|---|
| 단문 | 12,000건 | 15원 | 40.0%↓ |
| 장문 | 4,186건 | 43원 | 38.6%↓ |
| 포토 | 750건 | 240원 | 4.0%↓ |
충전캐쉬 198,000원
연동회원 전용 충전하기700,000원
VAT 별도
| 구분 | 건수 | 단가 | 할인율 |
|---|---|---|---|
| 단문 | 50,000건 | 14원 | 44%↓ |
| 장문 | 16,666건 | 42원 | 40%↓ |
| 포토 | 3,043건 | 230원 | 8%↓ |
충전캐쉬 770,000원
연동회원 전용 충전하기
관련 서비스 바로가기
수동 발송과 자동 발송을 함께 관리하세요
반복되는 고객 알림을 자동화하세요
업무 환경에 맞는 연동 방식을 확인하고 테스트 발송부터 시작할 수 있습니다.
