채널별 발송 테스트
알림톡
발송 샘플
기본형
INSERT INTO AGAUTO_KKA_QUEUE (sender_key, recipient, step, template_code, variable_json, send_date)
VALUES('발신프로필키', '전화번호', 'R', '템플릿코드', 'JSON형태의 치환문구', '예약발송시간(yyyy-MM-dd HH:mm:ss)');문자 재처리
INSERT INTO AGAUTO_KKA_QUEUE (sender_key, recipient, step, template_code, fallback_json, variable_json, send_date)
VALUES('발신프로필키', '전화번호', 'R', '템플릿코드',
'JSON 형태의 문자메시지 설정값', 'JSON형태의 치환문구', '예약발송시간(yyyy-MM-dd HH:mm:ss)');테이블 컬럼별 입력 데이터 양식
AGAUTO_KKA_QUEUE
step
발송처리단계
Y
R:발송준비완료
id_type
해당 캠페인에서 사용할 수신자 타입
Y
RCT(전화번호. 기본값),
AUI(고유 앱 유저 아이디(카카오싱크, 챗봇)
recipient
수신대상자
Y
id_type의 유형에 맞는 수신대상자
ex) id_type이 RTC인 경우 전화번호. '01012349876'
sender_key
발신 프로필 키
Y
사전 발급받은 발신 프로필 키
template_code
알림톡 템플릿 코드
Y
사전 등록 완료한 알림톡의 템플릿코드
option_json
알림톡 부가 설정값 JSON
N
messageType : 알림톡 유형(기본값 AT, 이미지 AI)
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"}
variable_json
치환문구 JSON
N
해당 알림톡에서 사용되는 치환문구를 JSON형태로 입력
ex) {"#{고객명}":"홍길동","#{인증번호}":"12341234"}
send_date
발송예약시간
Y
ex) 2026-02-11 12:30:00
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에 입력했다면 생략
브랜드메시지
기본형 발송 샘플
기본형
문자 재처리
자유형 발송 샘플
기본형
문자 재처리
테이블 컬럼별 입력 데이터 양식
AGAUTO_KKB_QUEUE
step
발송처리단계
Y
R:발송준비완료
id_type
해당 캠페인에서 사용할 수신자 타입
Y
RCT(전화번호. 기본값)
AUI(고유 앱 유저 아이디. 카카오싱크, 챗봇)
KUK(카카오톡 채널 사용자 식별키. 카카오톡 채널 봇)
recipient
수신대상자
Y
id_type의 유형에 맞는 수신대상자
ex) id_type이 RTC인 경우 전화번호. '01012349876'
sender_key
발신 프로필 키
Y
사전 발급받은 발신 프로필 키
targeting
타겟팅 구분
Y
M: 광고주(고객사)의 마케팅 수신동의 유저
N: 광고주(고객사)의 마케팅 수신동의 유저(채널 친구는 제외)
O: 광고주(고객사)의 마케팅 수신동의 유저(채널 친구인 경우만) * 미입력 시, 채널 친구 유저(기존 친구톡)
template_code
브랜드 메시지 템플릿 코드
N
(기본형) 템플릿 사용하는 기본형 방식인 경우 필수
"이 항목을 입력하지 않으면 자유형"
ex) 9b4563714d421725f14e66a843fc52010238edbc
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"}
variable_json
치환문구 JSON
N
해당 브랜드메시지에서 사용되는 치환문구, 또는 템플릿을 사용하지 않은 경우 #{치환문구}의 형태로 입력한 치환문구에 대한 변환값을 JSON형태로 입력
ex) {"#{고객명}":"홍길동","#{인증번호}":"12341234"}
send_date
발송예약시간
Y
ex) 2026-02-11 12:30:00
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
사전 발급받은 부서코드
fallback_json
subject
40Byte
Y
문자메시지 제목
mmsContent
2000Byte
Y
문자메시지 내용
callback
Text(25)
Y
사전등록된 발신자 전화번호
originCid
number(9)
N
특부가 사업번호
agentDistServerConfig.xml에 입력했다면 생략
문자 메시지
발송 샘플
기본형
이미지 첨부
테이블 컬럼별 입력 데이터 양식
AGAUTO_MMS_QUEUE
step
발송처리단계
Y
R:발송준비완료
callback
발신번호
Y
사전등록된 발신자 전화번호
recipient
수신대상자
Y
수신대상자(전화번호)
ex) 01012349876
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", "orgCode":"12qwd3rqqe84"}
variable_json
치환문구
N
문자메시지에 입력한 정보 중 #{치환문구}의 형태로 입력한 치환문구에 대한 변환값을 JSON형태로 입력
ex) {"#{고객명}":"홍길동","#{인증번호}":"12341234"}
send_date
발송예약시간
Y
ex) 2026-02-11 12:30:00
JSON 세부 파라미터 설명
option_json
originCid
number(9)
N
특부가 사업번호
agentDistServerConfig.xml에 입력했다면 생략
orgCode
Text(20)
N
사전 발급받은 부서코드
샘플 참조 데이터
JSON 치환 문구
{"#{고객명}":"유저0001"}
INSERT INTO AGAUTO_KKB_QUEUE (serialnum, recipient, variable_json)
VALUES('캠페인번호', '전화번호', '{"#{고객명}":"유저0001"}');
JSON 문자 메시지 설정값
{
"subject": "인증번호",
"mmsContent":
"인증번호 #{인증번호}를 입력하세요",
"callback": "발신번호",
"originCid":
"특부가사업자 사업번호"
}
INSERT INTO AGAUTO_KKA_QUEUE (sender_key, recipient, step, template_code, fallback_json, variable_json, send_date)
VALUES('9c4563714d421727f14e66a843fc52010238edba', '전화번호', 'R', '템플릿코드',
'{"subject": "인증번호","mmsContent": "인증번호 #{인증번호}를 입력하세요","callback": "발신번호"}',
'{"#{인증번호}":"123421"}', now());
*variable_json의 치환문구는 문자 재처리에도 적용됩니다
JSON 배열 이미지키 파일
["20260120UIw17688898283484423.jpg"]
INSERT INTO AGAUTO_MMS_QUEUE (callback, recipient, step,
subject, message, filekey, variable_json, send_date)
VALUES('발신번호', '수신자전화번호', 'R',
'이미지 테스트', '안녕하세요 #{고객명}님. MMS 발송 테스트입니다.',
'["20260120UIe17688898283484423.jpg"]',
'{"#{이름}":"홍길동"}', '예약발송시간(yyyy-MM-dd HH:mm:ss)');
Last updated