친구톡 발송
친구톡은 ‘정보/광고성’ 메시지를 카카오톡으로 발송하는 서비스로, 알림톡과는 달리 카카오톡 친구로 추가한 사용자에게만 메시지를 발송할 수 있습니다. 친구톡은 전화번호 정보로 발송되며, 등록된 전화번호로 모두 메시지가 발송되는 것이 아닌 서비스 정책상 카카오톡 채널을 추가한 사용자 대상으로만 광고성 메시지 발송됩니다.
BizMsgAgent 설치 완료 후 친구톡을 발송하는 방법은 다음과 같습니다.
안내
- 버튼 가이드 및 메시지 유형별 스펙에 대한 자세한 정보는 부록. 메시지 타입별 가이드 및 스펙 문서를 참고하시기 바랍니다.
- 각 테이블에 입력하는 데이터는 테이블 명세 문서를 참고하시기 바랍니다.
친구톡만 발송하기
친구톡을 발송하기 위해서는 agent.ini 파일 > [TABLE] 섹션에 기술된 ftalk_message 테이블에 데이터를 입력해야 합니다. 친구톡은 광고성 메시지로서 별도의 템플릿 등록이 필요하지 않습니다. 친구톡은 채널 가입을 한 사용자에 한해 발송되며, 항상 배치 형식으로 발송됩니다.
표INSERT 구문의 주요 칼럼| 칼럼 | 설명 |
|---|---|
| MSG_TYPE | 친구톡(대체 메시지 없음)만 발송 |
FX로 고정 |
|
| RESERVE_DATE | 미래 시간 입력 시, 예약 발송 |
| IMG_ATTACH_CD | 이미지 첨부 여부 |
N: 이미지 첨부 없음 |
|
Y: 이미지 URL을 첨부 |
|
M: 서버의 이미지를 첨부 |
|
| KKO_IMG_PATH | 서버 이미지 절대경로 |
| KKO_IMG_URL | 업로드된 친구톡 이미지 URL |
| KKO_IMG_WIDE_CD | 와이드 이미지 여부 |
N: 일반 이미지 |
|
Y(기본값): 와이드 이미지 |
|
| KKO_IMG_LINK_URL | 이미지 클릭 시, 링크될 URL |
| 이미지 클릭 시, 링크될 URL | 광고성 메시지 필수 표기 사항을 노출 |
N: 메시지를 노출하지 않음 |
|
Y(기본값): 메시지를 노출 |
코드예제친구톡 발송 Sample Code
INSERT INTO K_F_MESSAGE (
KKO_MSG,
MOBILE_NO,
SENDER_NO,
MSG_TYPE,
RESERVE_DATE,
KKO_BTN_LINK1,
KKO_BTN_LINK2,
KKO_BTN_LINK3,
KKO_BTN_LINK4,
KKO_BTN_LINK5,
IMG_ATTACH_CD,
KKO_IMG_PATH,
KKO_IMG_URL,
KKO_IMG_WIDE_CD,
KKO_IMG_LINK_URL,
KKO_AD_FLAG,
REG_DATE
) VALUES (
'친구톡 발송 메시지 작성',
'99999999999', # 수신자 번호
'99999999999', # 발신자 번호
‘FX’, # 메시지 타입 (FX: 친구톡, FS: 친구톡+대체SMS, FM: 친구톡+대체LMS)
NOW(), # 미래 시간 입력 시, 예약 발송
‘{"name":"앱링크버튼","type":"AL","scheme_android":"https://kakao.com","scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"}’,
‘{"name":"웹링크버튼","type":"WL","url_mobile":"http://kakao.com"}’,
NULL,
NULL,
NULL,
‘N’, # ‘N’: 이미지 없음, ‘Y’: 이미지 URL로 첨부, ‘M’: 서버 이미지 첨부
NULL, # KKO_IMG_PATH : 서버 이미지 절대경로
NULL, # KKO_IMG_URL : 업로드된 친구톡 이미지 URL
‘N’, # KKO_IMG_WIDE_CD : 와이드 이미지 여부, ‘N’: 일반이미지, ‘Y’: 와이드이미지, 기본값 ‘Y’
NULL, # KKO_IMG_LINK_URL : 이미지 클릭 시, 링크될 URL
NULL, # KKO_AD_FLAG : 광고성 메시지 필수 표기 사항을 노출 (노출 여부 ‘Y’/’N’, 기본값 ‘Y’)
NOW()
);
친구톡에 이미지 전송
친구톡의 이미지는 서버에 있는 이미지 파일을 첨부할 경우와 이미지 URL이 있는 경우의 두 가지 방식을 사용할 수 있습니다.
- 서버에 있는 이미지 파일을 첨부할 경우
| 구분 | 입력값 |
|---|---|
| KKO_IMG_PATH | 이미지 절대경로 입력 |
| IMG_ATTACH_CD | M 입력 |
- 이미지 URL이 있는 경우
| 구분 | 입력값 |
|---|---|
| KKO_IMG_URL | 친구톡 이미지 URL 입력 |
| IMG_ATTACH_CD | Y 입력 |
친구톡 + SMS 대체 메시지 발송하기
친구톡 발송 실패 시, 친구톡과 함께 대체 메시지를 SMS 형식으로 발송할 수 있습니다.
표INSERT 구문의 주요 칼럼| 칼럼 | 설명 |
|---|---|
| MSG_TYPE | 친구톡 발송 실패 시 SMS 대체 메시지 발송 |
FS로 고정 |
|
| RESERVE_DATE | 미래 시간 입력 시, 예약 발송 |
코드예제친구톡 + SMS 발송 Sample Code
INSERT INTO K_F_MESSAGE (
KKO_MSG,
MOBILE_NO,
SENDER_NO,
MSG_TYPE,
TITLE,
PHONE_MSG,
RESERVE_DATE,
KKO_BTN_LINK1,
KKO_BTN_LINK2,
KKO_BTN_LINK3,
KKO_BTN_LINK4,
KKO_BTN_LINK5,
KKO_AD_FLAG,
REG_DATE
) VALUES (
'친구톡 발송 메시지 작성',
'99999999999', # 수신자 번호 변경 필요
'99999999999', # 발신자 번호 변경 필요
‘FS’, # 메시지 타입 (FX: 친구톡, FS: 친구톡+대체SMS, FM: 친구톡+대체LMS)
NULL, # 문자 제목
‘SMS 메시지입니다.’, # 문자 메시지
NOW(), # 미래 시간 입력 시, 예약 발송
‘{"name":"앱링크버튼","type":"AL","scheme_android":"https://kakao.com","scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"}’,
‘{"name":"웹링크버튼","type":"WL","url_mobile":"http://kakao.com"}’,
NULL,
NULL,
NULL, # KKO_AD_FLAG : 광고성 메시지 필수 표기 사항을 노출 (노출 여부 ‘Y’/’N’, 기본값 ‘Y’)
NOW ()
);
친구톡 + LMS 대체 메시지 발송하기
친구톡 발송 실패 시, 친구톡과 함께 대체 메시지를 LMS 형식으로 발송할 수 있습니다.
표INSERT 구문의 주요 칼럼| 칼럼 | 설명 |
|---|---|
| MSG_TYPE | 친구톡 발송 실패 시 SMS 대체 메시지 발송 |
FM으로 고정 |
|
| RESERVE_DATE | 미래 시간 입력 시, 예약 발송 |
코드예제친구톡 + LMS 발송 Sample Code
INSERT INTO K_F_MESSAGE (
KKO_MSG,
MOBILE_NO,
SENDER_NO,
MSG_TYPE,
TITLE,
PHONE_MSG,
RESERVE_DATE,
KKO_BTN_LINK1,
KKO_BTN_LINK2,
KKO_BTN_LINK3,
KKO_BTN_LINK4,
KKO_BTN_LINK5,
KKO_AD_FLAG,
REG_DATE
) VALUES (
'친구톡 발송 메시지 작성',
'99999999999', # 수신자 번호 변경 필요
'99999999999', # 발신자 번호 변경 필요
‘FM’, # 메시지 타입 (FX: 친구톡, FS: 친구톡+대체SMS, FM: 친구톡+대체LMS)
‘문자 제목입니다’, # 문자 제목
‘LMS 메시지입니다.’, # 문자 메시지
NOW(), # 미래 시간 입력 시, 예약 발송
‘{"name":"앱링크버튼","type":"AL","scheme_android":"https://kakao.com","scheme_ios":"https://kakao.com","url_mobile":"https://kakao.com"}’,
‘{"name":"웹링크버튼","type":"WL","url_mobile":"http://kakao.com"}’,
NULL,
NULL,
NULL,
‘N’, # ‘N’: 이미지 없음, ‘Y’: 이미지 URL로 첨부, ‘M’: 서버 이미지 첨부
NULL, # KKO_AD_FLAG : 광고성 메시지 필수 표기 사항을 노출 (노출 여부 ‘Y’/’N’, 기본값 ‘Y’)
NOW ()
);