채널별 발송 테스트

알림톡

발송 샘플

Mysql, MariaDB

-- Master INSERT
INSERT INTO AGCAMP_KKA_MASTER (serialnum, step, sender_key, template_code, send_date, write_sdate) VALUES('캠페인번호', 'R', '발신프로필키', '템플릿코드', '예약발송시간(yyyy-MM-dd HH:mm:ss)', now());

-- Queue INSERT
INSERT INTO AGCAMP_KKA_QUEUE (serialnum, recipient, variable_json) VALUES('캠페인번호', '전화번호', 'JSON형태의 치환문구')

-- Master UPDATE
UPDATE AGCAMP_KKA_MASTER SET step = 'T', write_edate = now() WHERE serialnum = '캠페인번호';

테이블 컬럼별 입력 데이터 양식

1. AGCAMP_KKA_MASTER

컬럼	설명	필수	예시
serialnum	캠페인 코드	Y	100004
step	캠페인 단계	Y	R: 대기(데이터 입력중) T: 전송개시(데이터 처리 시작신호)
id_type	해당 캠페인에서 사용할 수신자 타입	Y	RCT: 전화번호. 기본값, AUI: 고유 앱 유저 아이디(카카오싱크, 챗봇)
sender_key	발신 프로필 키	Y	사전 발급받은 발신 프로필 키
template_code	알림톡 템플릿 코드	Y	ex) FP001
option_json	알림톡 부가 설정값 JSON	N	price : 메시지 내 포함된 가격/금액/결제금액 currencyType : 메시지 내 포함된 price의 통화단위(국제통화코드) countryCode : 국가코드(대한민국 82) orgCode : 사전 발급받은 부서코드 ex) {"messageType":"AT", "price":300, "currencyType":"KRW"}
fallback_json	알림톡 실패 대상 문자 재처리 정보 JSON	N	mmsContent: 문자메시지 내용 subject: 문자메시지 제목 callback: 발신자 전화번호 ex) {"mmsContent":인증번호는 123123입니다.", "subject":"인증문자", "callback":"07012349876"}
send_date	발송 예약 시간	Y	ex) 2026-02-11 12:30:00

1. AGCAMP_KKA_QUEUE

컬럼	설명	필수	예시
serialnum	캠페인 코드	Y	AGCAMP_KKA_MASTER에 입력한 캠페인 코드 ex) 100004
recipient	수신 대상자	Y	AGCAMP_KKA_MASTER의 id_type의 유형에 맞는 수신 대상자 ex) id_type이 RTC인 경우 전화번호. '01012349876'
variable_json	치환 문구	N	해당 알림톡 템플릿에서 사용되는 치환 문구를 JSON 형태로 입력 ex) {"#{고객명}":"홍길동","#{인증번 호}":"12341234"}

JSON 세부 파라미터 설명

컬럼	파라미터명	타입	필수	설명 또는 예시
option_json	price	number	N	메시지 내 포함된 가격/금액/결제금액
	currencyType	Text(3)	N	메시지 내 포함된 가격/금액/결제금액의 통화단위 (KRW, USD, EUR 등 국제 통화 코드)
	countryCode	Text(6)	N	국가코드 (예 : 대한민국 "82")
	orgCode	Text(20)	N	부서코드
fallback_json	subject	40Byte	Y	문자메시지 제목
	mmsContent	2000Byte	Y	문자메시지 내용
	callback	Text(25)	Y	사전등록된 발신자 전화번호
	originCid	number(9)	N	특부가 사업번호 agentDistServerConfig.xml에 입력했다면 생략

브랜드메시지

기본형 발송 샘플

Mysql, MariaDB

-- Master INSERT
INSERT INTO AGCAMP_KKB_MASTER (serialnum, step, sender_key, targeting, template_code, send_date, write_sdate) 
VALUES('캠페인번호', 'R', '발신프로필키', '타겟팅모드', '템플릿코드', '예약발송시간(yyyy-MM-dd HH:mm:ss)', now());

-- Queue INSERT
INSERT INTO AGCAMP_KKB_QUEUE (serialnum, recipient, variable_json) VALUES('캠페인번호', '전화번호', 'JSON형태의 치환문구')

-- Master UPDATE
UPDATE AGCAMP_KKB_MASTER SET step = 'T', write_edate = now() WHERE serialnum = '캠페인번호';

자유형 발송 샘플

Mysql, MariaDB

-- Master INSERT
INSERT INTO AGCAMP_KKB_MASTER (serialnum, step, sender_key, message, option_json, send_date, write_sdate) 
VALUES('캠페인번호', 'R', '발신프로필키', '안녕하세요 #{고객명}님. 브랜드메시지 자유형 발송 테스트입니다.', '{"messageType":"FT"}', '예약발송시간(yyyy-MM-dd HH:mm:ss)', now());

-- Queue INSERT
INSERT INTO AGCAMP_KKB_QUEUE (serialnum, recipient, variable_json) VALUES('캠페인번호', '전화번호', 'JSON형태의 치환문구');

-- Master UPDATE
UPDATE AGCAMP_KKB_MASTER SET step = 'T', write_edate = now() WHERE serialnum = '캠페인번호';

테이블 컬럼별 입력 데이터 양식

1. AGCAMP_KKB_MASTER

컬럼	설명	필수	예시
serialnum	캠페인 코드	Y	100004
step	캠페인 단계	Y	R: 대기(데이터 입력중) T: 전송개시(데이터 처리 시작신호)
id_type	해당 캠페인에서 사용할 수신자 타입	Y	RCT: 전화번호(기본 값) AUI: 고유 앱 유저 아이디. 카카오싱크, 챗봇 KUK: 카카오톡 채널 사용자 식별키. 카카오톡 채널 봇
sender_key	발신 프로필 키	Y	사전 발급받은 발신 프로필 키
targeting	타겟팅 구분	Y	M: 광고주(고객사)의 마케팅 수신동의 유저 N: 광고주(고객사)의 마케팅 수신동의 유저(채널 친구는 제외) O: 광고주(고객사)의 마케팅 수신동의 유저(채널 친구인 경우만) * 미입력 시, 채널 친구 유저(기존 친구톡)
template_code	브랜드 메시지 템플릿 코드	Y	(기본형) 템플릿 사용하는 기본형 방식인 경우 필수 "이 항목을 입력하지 않으면 자유형"
message	사용자에게 전달할 메시지	N
option_json	알림톡 부가 설정값 JSON	N	messageType : 메시지 유형 FT:텍스트형 FI:이미지형 FW:와이드 이미지형 FL:와이드 아이템리스트 FC:캐러셀 피드형 FP:프리미엄 동영상형 FM:커머스형 FA:캐러셀 커머스형 header: 와이드 아이템리스트(FL), 프리미엄 동영상형(FP) 메시지에 표기할 제목 additional_content: 커머스형(FM)에서 사용되는 부가정보(공백 포함 34자) countryCode: 국가코드(대한민국 82) adult: 성인용 메시지 여부(Y / N) orgCode: 사전 발급받은 부서코드 ex) {"messageType":"FL", "header":"메시지 제목", "adult":"Y"}
attach_json	버튼/이미지/아이템 정보 JSON	N	(자유형) 템플릿을 사용하지 않을 경우 필요한 버튼/이미지/아이템 정보 등을 JSON 형태로 직접 입력 버튼/이미지/아이템/커머스 정보 등 ex) {"button":[{~~}], "image":{~~}, "item":{~~} 등 상세 항목값은 이 페이지 참조
carousel_json	캐러셀 정보 JSON	N	(자유형) 템플릿을 사용하지 않을 경우 필요한 캐러셀 타입 정보를 JSON 형태로 직접 입력 캐러셀 정보 ex) {"head":{~~}, "list":[{~~},{~~}...], "tail":{~~}}
fallback_json	브랜드메시지실패 대상 문자 재처리 정보 JSON	N	mmsContent: 문자메시지 내용 subject: 문자메시지 제목 callback: 발신자 전화번호 ex) {"mmsContent":인증번호는 123123입니다.", "subject":"인증문자", "callback":"07012349876"}
send_date	발송 예약 시간	Y	ex) 2026-02-11 12:30:00

1. AGCAMP_KKB_QUEUE

컬럼	설명	필수	예시
serialnum	캠페인 코드	Y	AGCAMP_KKB_MASTER에 입력한 캠페인 코드 ex) 100004
recipient	수신 대상자	Y	AGCAMP_KKB_MASTER의 id_type의 유형에 맞는 수신 대상자 ex) id_type이 RTC인 경우 전화번호. '01012349876'
variable_json	치환 문구	N	해당 브랜드메시지 템플릿에서 사용되는 치환문구, 또는 템플릿을 사용하지 않은 경우 AGCAMP_KKB_MASTER 테이블에 직접 #{치환문구}의 형태로 입력한 치환문구에 대한 변환값을 JSON형태로 입력 ex) {"#{고객명}":"홍길동","#{인증번호}":"12341234"}

JSON 세부 파라미터 설명 - 기본형(템플릿 사용)

컬럼	파라미터명	타입	필수	설명 또는 예시
option_json	countryCode	Text(6)	N	국가코드 (예 : 대한민국 "82")
	orgCode	Text(20)	N	사전 발급받은 부서코드
fallback_json	subject	40Byte	Y	문자메시지 제목
	mmsContent	2000Byte	Y	문자메시지 내용
	callback	Text(25)	Y	사전등록된 발신자 전화번호
	originCid	number(9)	N	특부가 사업번호 agentDistServerConfig.xml에 입력했다면 생략

JSON 세부 파라미터 설명 - 자유형

컬럼	파라미터명	타입	필수	설명 또는 예시
option_json	countryCode	Text(6)	N	국가코드 (예 : 대한민국 "82")
	messageType	Text(2)	Y	FT – 텍스트형 FI – 이미지형 FW – 와이드 이미지형 FL – 와이드 아이템 리스트형 FC – 캐러셀 피드형 FP – 프리미엄 동영상형 FM – 커머스형 FA – 캐러셀 커머스형
	header	Text(16)	N	와이드 아이템리스트, 프리미엄 동영상형 메시지 타입에 표기할 제목
	additional_content	Text(34)	N	부가 정보(공백 포함 34자) 커머스형(FM) 타입에서 사용
	adult	Text(1)	N	성인용 메시지 여부 (N : 사용안함[기본값], Y : 사용함)
	orgCode	Text(20)	N	사전 발급받은 부서코드
attach_json				​버튼/이미지/아이템/커머스 정보 등​
carousel_json				캐러셀 정보
fallback_json	subject	40Byte	Y	문자메시지 제목
	mmsContent	2000Byte	Y	문자메시지 내용
	callback	Text(25)	Y	사전등록된 발신자 전화번호
	originCid	number(9)	N	특부가 사업번호 agentDistServerConfig.xml에 입력했다면 생략

문자 메시지

발송 샘플

Mysql, MariaDB

-- Master INSERT
INSERT INTO AGCAMP_MMS_MASTER (serialnum, step, callback, subject, message, filekey, send_date, write_sdate) VALUES('캠페인번호', 'R', '발신번호', '이미지 테스트', '안녕하세요 #{고객명}님. MMS 발송 테스트입니다.', '["사전등록한 이미지 파일키"]', now(), now());

-- Queue INSERT
INSERT INTO AGCAMP_MMS_QUEUE (serialnum, recipient, variable_json, write_date) VALUES('캠페인번호', '전화번호', 'JSON형태의 치환문구', now());

-- Master UPDATE
UPDATE AGCAMP_MMS_MASTER SET step = 'T', write_edate = now() WHERE serialnum = '캠페인번호';

테이블 컬럼별 입력 데이터 양식

1. AGCAMP_MMS_MASTER

컬럼	설명	필수	예시
serialnum	캠페인 코드	Y	100004
step	캠페인 단계	Y	R: 대기(데이터 입력중) T: 전송개시(데이터 처리 시작신호)
callback	발신번호	Y	사전 등록한 발신자 전화번호
subject	메시지 제목	Y	문자 메시지 제목
message	메시지 내용	Y	문자 메시지 내용 (90Byte 이하 : SMS, 초과 : LMS)
filekey	첨부 이미지 파일키 JSON 배열	N	사전등록한 첨부 이미지의 파일키를 JSON 배열 형태로 입력 이미지 첨부시 message의 크기와 무관하게 MMS로 발송 ex) ["20260120UIw17688898283484423.jpg"]
option_json	문자 메시지 부가 설정값 JSON	N	originCid: 특부가사업자 사업번호 orgCode: 사전 발급받은 부서코드 ex) {"originCid":"301280024"}
send_date	발송 예약 시간	Y	ex) 2026-02-11 12:30:00

1. AGCAMP_MMS_QUEUE

컬럼	설명	필수	예시
serialnum	캠페인 코드	Y	AGCAMP_MMS_MASTER에 입력한 캠페인 코드 ex) 100004
recipient	수신 대상자	Y	AGCAMP_MMS_MASTER의 id_type의 유형에 맞는 수신 대상자 ex) id_type이 RTC인 경우 전화번호. '01012349876'
variable_json	치환 문구	N	AGCAMP_MMS_MASTER에 입력한 정보 중 #{치환문구}의 형태로 입력한 치환문구에 대한 변환값을 JSON형태로 입력 ex) {"#{고객명}":"홍길동","#{인증번호}":"12341234"}

JSON 세부 파라미터 설명

컬럼	파라미터명	타입	필수	설명 또는 예시
option_json	originCid	number(9)	N	특부가 사업번호 agentDistServerConfig.xml에 입력했다면 생략
	orgCode	Text(20)	N	사전 발급받은 부서코드

샘플 참조 데이터

명칭	예시	샘플
JSON 치환 문구	{"#{고객명}":"유저0001"}	INSERT INTO AGCAMP_KKB_QUEUE (serialnum, recipient, variable_json, write_date) VALUES('캠페인번호', '전화번호', '{"#{고객명}":"유저0001"}', now())
JSON 문자 메시지 설정값	{ "subject": "인증번호", "mmsContent": "인증번호 #{인증번호}를 입력하세요", "callback": "발신번호", "originCid": "특부가사업자 사업번호" }	INSERT INTO AGAUTO_KKA_MASTER (serialnum, step, sender_key, id_type, recipient, template_code, fallback_json, send_date, write_sdate) VALUES('캠페인번호', 'R', '발신프로필키', 'RCT', '전화번호', '템플릿코드', '{"subject": "인증번호", "mmsContent": "인증번호 #{인증번호}를 입력하세요", "callback": "발신번호"}', '{"#{인증번호}":"123421"}', '예약발송시간(yyyy-MM-dd HH:mm:ss)', now()); *variable_json의 치환문구는 문자 재처리에도 적용됩니다.
JSON 배열 이미지키 파일	["20260120UIw17688898283484423.jpg"]	INSERT INTO AGCAMP_MMS_MASTER (serialnum, step, callback, subject, message, filekey, send_date, write_sdate) VALUES('캠페인번호', 'R', '발신번호', '이미지 테스트', '안녕하세요 #{고객명}님. MMS 발송 테스트입니다.', '["20260121UIw17686698283484423.jpg", "20260122UIw17644898283484423.jpg", "20260123UIw17688898283485223.jpg"]', now(), now());