카카오 친구톡 APIs

[카카오친구톡] UMS 회원 발송

구분

내용

Controller URL

/api/umsSendFrtApi.ums

METHOD

POST

Content-type

multipart/form-data or application/x-www-form-urlencoded

설명

UMS 회원 친구톡 발송

비고

application/json 불가

  • Request (POST 방식 호출)

항목

타입

필수

설명

APIKEY

String

Y

유라클클라우드 데브콘솔에서 생성된 API키

CLOUD_PROJECT_ID

String

Y

유라클클라우드 데브콘솔에서 생성된 프로젝트아이디.

SENDERID

String

Y

발송자 정보. 통계정보 사용. Ex) MAILSYSTEM. 제약조건 영문 30byte 이하 문자

TYPE

String

Y

발송 타겟팅 선택 : MU , OU, AU 중 택일
MU=>회원 발송. 아이디로 타겟팅,

OU=>전체조직도유저,

AU=>전체UMS회원,

CUIDS

String

Y

TYPE : MU 일 경우 필수 값.
1. MU일 경우 UMS 등록된 회원아이디로 보냄.

한건 발송 ex) user1

여러명 발송 ex) [“user1”,”user2”…] 최대 2000명 가능

FRIENDTOLK_SVCID

String

Y

LGCNS톡드림에 등록된 카카오친구톡 서비스아이디 ex)1910028xxxx

FRIENDTOLK_MSG

String

Y

친구톡 메시지. 최대 4000byte

PLUS_ID

String

Y

친구톡 플러스친구 아이디

KKO_BTN_LINK1

String

N

카카오톡 챗버블 버튼

버튼 타입: DS: 배송조회, WL: 웹링크, AL: 앱링크, BK: 봇키워드, MD: 메시지전달

[예제]
WL 예제:
{“name”:”유라

클버튼”,”type”:”WL”,”ur l_pc”:”http://blog.nave r.com/imagetech1/221004 457903”,”url_mobile”:”h ttp://blog.naver.com/im agetech1/221004457903”}

AL 예제 :
{“name”:”버튼명칭

“,”type”:”AL”,”scheme_ ios”:”scheme://xxx.xx”,

“scheme_andr

oid”:”scheme://xxx.xx”}

BK 예제 : {“name”:”봇키워드”, “type”:”BK”}

MD 예제 : {“name”:”메세지전달”, “type”:”MD”}

KKO_BTN_LINK2

String

N

KKO_BTN_LINK3

String

N

KKO_BTN_LINK4

String

N

KKO_BTN_LINK5

String

N

SMS_TITLE

String

N

MMS문자일 경우 타이틀.

SMS_MSG

String

N

보낼 문자내용. 90byte이상은 MMS로 발송됩니다.

CALLBACK_NUM

String

N

회신번호. SMS대체발송일 경우 필수

MMS_IMGURL

String

N

MMS일 경우 이미지 URL: htt p://xxxx.com/sample.jpg

  • TYPE : 일반발송 응답 메세지

구분

항목

필수

반복

설명

HEADER

RESULTCODE

String

Y

N

0000 : 응답 성공

그외 : 에러 메시지

RESULTMSG

String

Y

N

OK : 응답 성공

그외 : 에러 메시지

BODY

processSeqno

String

Y

발송 시퀀스 고유번호.

pushSendCnt

int

Y

푸시 발송수

kkoAltCnt

int

Y

카카오 알림톡 발송수

kkoFrtCnt

int

Y

카카오 친구톡 발송수

smsCnt

int

Y

문자 발송수

failCnt

int

Y

실패수

processInfo

Object

Y

발송진행상태 ex) {“processTxt”: “Completed.”, “pr ocessPercent”: “100”}

  • 연동 예시

    {
       "HEADER":{
          "RESULTCODE":"0000",
          "RESULTMSG":"OK"
       },
       "BODY":{
          "kkoAltCnt":"1",
          "pushSendCnt":"0",
          "kkoFrtCnt":"0",
          "smsCnt":"0",
          "failCnt":0,
          "processInfo":{
             "processTxt":"Completed.",
             "processPercent":"100"
          },
          "processSeqno":"280"
       }
    }
    

[카카오친구톡] UMS 회원 / 예약발송

구분

내용

Controller URL

/api/umsSendFrtApi.ums

METHOD

POST

Content-type

multipart/form-data or application/x-www-form-urlencoded

설명

UMS 회원 친구톡 예약 발송

비고

application/json 불가

  • Request (POST 방식 호출)

항목

타입

필수

설명

APIKEY

String

Y

유라클클라우드 데브콘솔에서 생성된 API키

CLOUD_PROJECT_ID

String

Y

유라클클라우드 데브콘솔에서 생성된 프로젝트아이디.

SENDERID

String

Y

발송자 정보. 통계정보 사용. Ex) MAILSYSTEM. 제약조건 영문 30byte 이하 문자

TYPE

String

Y

발송 타겟팅 선택 : MU , OU, AU 중 택일
MU=>회원 발송. 아이디로 타겟팅,

OU=>전체조직도유저,

AU=>전체UMS회원,

CUIDS

String

Y

TYPE : MU 일 경우 필수 값.
1. MU일 경우 UMS 등록된 회원아이디로 보냄.

한건 발송 ex) user1

여러명 발송 ex) [“user1”,”user2”…] 최대 2000명 가능

RESERVEDATE

String

N

발송예약 날자형식 : YYYY-MM-DD HH:MM .

FRIENDTOLK_SVCID

String

Y

LGCNS톡드림에 등록된 카카오친구톡 서비스아이디 ex)1910028xxxx

FRIENDTOLK_MSG

String

Y

친구톡 메시지. 최대 4000byte

PLUS_ID

String

Y

친구톡 플러스친구 아이디

KKO_BTN_LINK1

String

N

카카오톡 챗버블 버튼

버튼 타입: DS: 배송조회, WL: 웹링크, AL: 앱링크, BK: 봇키워드, MD: 메시지전달

[예제]
WL 예제:
{“name”:”유

라클버튼”,”type”:”WL “,”url_pc”:”http://b log.naver.com/imaget ech1/221004457903”,” url_mobile”:”http:// blog.naver.com/image tech1/221004457903”}

AL 예제 :
{“

name”:”버튼명칭”,”ty pe”:”AL”,”scheme_ios “:”scheme://xxx.xx”,

“scheme_android

“:”scheme://xxx.xx”}

BK 예제 :

{“name”:”봇키워드”,

“type”:”BK”}

MD 예제 : { “name”:”메세지전달”, “type”:”MD”}

KKO_BTN_LINK2

String

N

KKO_BTN_LINK3

String

N

KKO_BTN_LINK4

String

N

KKO_BTN_LINK5

String

N

SMS_TITLE

String

N

MMS문자일 경우 타이틀.

SMS_MSG

String

N

보낼 문자내용. 90byte이상은 MMS로 발송됩니다.

CALLBACK_NUM

String

N

회신번호. SMS대체발송일 경우 필수

MMS_IMGURL

String

N

MMS일 경우 이미지 URL: http:/ /xxxx.com/sample.jpg

  • TYPE : 일반발송 응답 메세지

구분

항목

필수

반복

설명

HEADER

RESULTCODE

String

Y

N

0000 : 응답 성공

그외 : 에러 메시지

RESULTMSG

String

Y

N

OK : 응답 성공

그외 : 에러 메시지

BODY

reserveSeqno

String

Y

예약발송 시퀀스 고유번호.

processInfo

Object

Y

발송진행상태 ex) {“processTxt”: “Completed.”, “pr ocessPercent”: “100”}

  • 연동 예시

    {
       "HEADER":{
          "RESULTCODE":"0000",
          "RESULTMSG":"OK"
       },
       "BODY":{
          "reserveSeqno":"220",
          "processInfo":{
             "processTxt":"Completed.",
             "processPercent":"100"
          }
       }
    }
    

[카카오친구톡] UMS 비회원 발송

구분

내용

Controller URL

/api/umsSendFrtMnApi.ums

METHOD

POST

Content-type

multipart/form-data or application/x-www-form-urlencoded

설명

UMS 비회원 친구톡 발송

비고

application/json 불가

  • Request (POST 방식 호출)

항목

타입

필수

설명

APIKEY

String

Y

유라클클라우드 데브콘솔에서 생성된 API키

CLOUD_PROJECT_ID

String

Y

유라클클라우드 데브콘솔에서 생성된 프로젝트아이디.

SENDERID

String

Y

발송자 정보. 통계정보 사용. Ex) MAILSYSTEM. 제약조건 영문 30byte 이하 문자

CUIDS

String

Y

한 명 : ex) {“ 아이디”:[“핸드폰번호”,” 이름”]}

여러명 ex) {“아이디” :[“핸드폰번호”,”이름”], “아이디”: [“핸드폰번호”,이름””]…}

P.S:핸드폰번호 : 0001234567 숫자만 입력

아이디 모를 경우 GUEST1,GUEST2… 임의의 아이디 생성하여 보냄.

FRIENDTOLK_SVCID

String

Y

LGCNS톡드림에 등록된 카카오친구톡 서비스아이디 ex)1910028xxxx

FRIENDTOLK_MSG

String

Y

친구톡 메시지. 최대 4000byte

PLUS_ID

String

Y

친구톡 플러스친구 아이디

KKO_BTN_LINK1

String

N

카카오톡 챗버블 버튼

버튼 타입: DS: 배송조회, WL: 웹링크, AL: 앱링크, BK: 봇키워드, MD: 메시지전달

[예제]
WL 예제:
{“name”:”유라

클버튼”,”type”:”WL”,”ur l_pc”:”http://blog.nave r.com/imagetech1/221004 457903”,”url_mobile”:”h ttp://blog.naver.com/im agetech1/221004457903”}

AL 예제 :
{“name”:”버튼명칭

“,”type”:”AL”,”scheme_ ios”:”scheme://xxx.xx”,

“scheme_andr

oid”:”scheme://xxx.xx”}

BK 예제 : {“name”:”봇키워드”, “type”:”BK”}

MD 예제 : {“name”:”메세지전달”, “type”:”MD”}

KKO_BTN_LINK2

String

N

KKO_BTN_LINK3

String

N

KKO_BTN_LINK4

String

N

KKO_BTN_LINK5

String

N

SMS_TITLE

String

N

MMS문자일 경우 타이틀.

SMS_MSG

String

N

보낼 문자내용. 90byte이상은 MMS로 발송됩니다.

MMS_IMGURL

String

N

MMS일 경우 이미지 URL: htt p://xxxx.com/sample.jpg

CALLBACK_NUM

String

N

회신번호. SMS대체발송일 경우 필수

  • TYPE : 일반발송 응답 메세지

구분

항목

필수

반복

설명

HEADER

RESULTCODE

String

Y

N

0000 : 응답 성공

그외 : 에러 메시지

RESULTMSG

String

Y

N

OK : 응답 성공

그외 : 에러 메시지

BODY

processSeqno

String

Y

발송 시퀀스 고유번호.

pushSendCnt

int

Y

푸시 발송수

kkoAltCnt

int

Y

카카오 알림톡 발송수

kkoFrtCnt

int

Y

카카오 친구톡 발송수

smsCnt

int

Y

문자 발송수

failCnt

int

Y

실패수

processInfo

Object

Y

발송진행상태 ex) {“processTxt”: “Completed.”, “pr ocessPercent”: “100”}

  • 연동 예시

     {
       "HEADER":{
          "RESULTCODE":"0000",
          "RESULTMSG":"OK"
       },
       "BODY":{
          "kkoAltCnt":"1",
          "pushSendCnt":"0",
          "kkoFrtCnt":"0",
          "smsCnt":"0",
          "failCnt":0,
          "processInfo":{
             "processTxt":"Completed.",
             "processPercent":"100"
          },
          "processSeqno":"280"
       }
    }
    

[카카오친구톡] UMS 비회원 / 예약발송

구분

내용

Controller URL

/api/umsSendFrtMnApi.ums

METHOD

POST

Content-type

multipart/form-data or application/x-www-form-urlencoded

설명

UMS 비회원 친구톡 예약 발송

비고

application/json 불가

  • Request (POST 방식 호출)

항목

타입

필수

설명

APIKEY

String

Y

유라클클라우드 데브콘솔에서 생성된 API키

CLOUD_PROJECT_ID

String

Y

유라클클라우드 데브콘솔에서 생성된 프로젝트아이디.

SENDERID

String

Y

발송자 정보. 통계정보 사용. Ex) MAILSYSTEM. 제약조건 영문 30byte 이하 문자

CUIDS

String

Y

한 명 : ex) {“아이디”:[“ 핸드폰번호”,이름””]}

여러명 ex) {“아이디”:[“ 핸드폰번호”,이름””], “아이디”:[“핸 드폰번호”,이름””]…}

P.S:핸드폰번호 : 0001234567 숫자만 입력

아이디 모를 경우 GUEST1,GUEST2… 임의의 아이디 생성하여 보냄.

RESERVEDATE

String

N

발송예약 날자형식 : YYYY-MM-DD HH:MM .

FRIENDTOLK_SVCID

String

Y

LGCNS톡드림에 등록된 카카오친구톡 서비스아이디 ex)1910028xxxx

FRIENDTOLK_MSG

String

Y

친구톡 메시지. 최대 4000byte

PLUS_ID

String

Y

친구톡 플러스친구 아이디

KKO_BTN_LINK1

String

N

카카오톡 챗버블 버튼

버튼 타입: DS: 배송조회, WL: 웹링크, AL: 앱링크, BK: 봇키워드, MD: 메시지전달

[예제]
WL 예제:
{“name”:”유

라클버튼”,”type”:”WL “,”url_pc”:”http://b log.naver.com/imaget ech1/221004457903”,” url_mobile”:”http:// blog.naver.com/image tech1/221004457903”}

AL 예제 :
{“

name”:”버튼명칭”,”ty pe”:”AL”,”scheme_ios “:”scheme://xxx.xx”,

“scheme_android

“:”scheme://xxx.xx”}

BK 예제 :

{“name”:”봇키워드”,

“type”:”BK”}

MD 예제 : { “name”:”메세지전달”, “type”:”MD”}

KKO_BTN_LINK2

String

N

KKO_BTN_LINK3

String

N

KKO_BTN_LINK4

String

N

KKO_BTN_LINK5

String

N

SMS_TITLE

String

N

MMS문자일 경우 타이틀.

SMS_MSG

String

N

보낼 문자내용. 90byte이상은 MMS로 발송됩니다.

CALLBACK_NUM

String

N

회신번호. SMS대체발송일 경우 필수

MMS_IMGURL

String

N

MMS일 경우 이미지 URL: http:/ /xxxx.com/sample.jpg

  • TYPE : 일반발송 응답 메세지

구분

항목

필수

반복

설명

HEADER

RESULTCODE

String

Y

N

0000 : 응답 성공

그외 : 에러 메시지

RESULTMSG

String

Y

N

OK : 응답 성공

그외 : 에러 메시지

BODY

reserveSeqno

String

Y

예약발송 시퀀스 고유번호.

processInfo

Object

Y

발송진행상태 ex) {“processTxt”: “Completed.”, “pr ocessPercent”: “100”}

  • 연동 예시

    {
       "HEADER":{
          "RESULTCODE":"0000",
          "RESULTMSG":"OK"
       },
       "BODY":{
          "reserveSeqno":"220",
          "processInfo":{
             "processTxt":"Completed.",
             "processPercent":"100"
          }
       }
    }
    

[카카오친구톡] UMS 회원 / CSV발송 (대량발송 or 치환발송)

구분

내용

Controller URL

/api/csvSendFrtApi.ums

METHOD

POST

Content-type

multipart/form-data or application/x-www-form-urlencoded

설명

친구톡 회원 CSV발송

비고

application/json 불가

  • Request (POST 방식 호출)

항목

타입

필수

설명

APIKEY

String

Y

유라클클라우드 데브콘솔에서 생성된 API키

CLOUD_PROJECT_ID

String

Y

유라클클라우드 데브콘솔에서 생성된 프로젝트아이디.

SENDERID

String

Y

발송자 정보. 통계정보 사용. Ex) MAILSYSTEM. 제약조건 영문 30byte 이하 문자

CSVFILE

MultipartFile

Y

CSV파일을 만들어 첨부한다.
P.S : 1번째 라인 컬럼정보, 2번째 라인부터 데이터
확인 : 푸시만 발송시에는 #{아이디} 하나만 넣어도 됨.
#{이름}, #{핸드폰번호} 생략가능. 회원정보에서 가져옴.
예1) csv파일 비 개인화
#{아이디} 첫번째라인 컬럼정보 헤드
user1

User2

예 2) 개인화 처리 CSV파일 만들기
#{아이디}, #{날자}, #{금액}
user1, 2019-05-01, 4,000

User2, 2019-05-04, 10,000

FRIENDTOLK_SVCID

String

Y

LGCNS톡드림에 등록된 카카오친구톡 서비스아이디 ex)1910028xxxx

FRIENDTOLK_MSG

String

Y

친구톡 메시지. 최대 4000byte

PLUS_ID

String

Y

친구톡 플러스친구 아이디

KKO_BTN_LINK1

String

N

카카오톡 챗버블 버튼

버튼 타입: DS: 배송조회, WL: 웹링크, AL: 앱링크, BK: 봇키워드, MD: 메시지전달

[예제]
WL 예제:

{“name”:”유라클버튼 “,”type”:”WL”,”url _pc”:”http://blog.n aver.com/imagetech1 /221004457903”,”url _mobile”:”http://bl og.naver.com/imaget ech1/221004457903”}

AL 예제 :
{“nam

e”:”버튼명칭”,”type “:”AL”,”scheme_ios” :”scheme://xxx.xx”,

“scheme_android”

:”scheme://xxx.xx”}

BK 예제 :

{“name”:”봇키워드”,

“type”:”BK”}

MD 예제 : {” name”:”메세지전달”, “type”:”MD”}

KKO_BTN_LINK2

String

N

KKO_BTN_LINK3

String

N

KKO_BTN_LINK4

String

N

KKO_BTN_LINK5

String

N

SMS_TITLE

String

N

MMS문자일 경우 타이틀.

SMS_MSG

String

N

보낼 문자내용. 90byte이상은 MMS로 발송됩니다.

MMS_IMGURL

String

N

MMS일 경우 이미지 URL: http:// xxxx.com/sample.jpg

CALLBACK_NUM

String

N

회신번호. SMS대체발송일 경우 필수

  • TYPE : 일반발송 응답 메세지

구분

항목

필수

반복

설명

HEADER

RESULTCODE

String

Y

N

0000 : 응답 성공

그외 : 에러 메시지

RESULTMSG

String

Y

N

OK : 응답 성공

그외 : 에러 메시지

BODY

processSeqno

String

Y

발송 시퀀스 고유번호.

pushSendCnt

int

Y

푸시 발송수

kkoAltCnt

int

Y

카카오 알림톡 발송수

kkoFrtCnt

int

Y

카카오 친구톡 발송수

smsCnt

int

Y

문자 발송수

failCnt

int

Y

실패수

processInfo

Object

Y

발송진행상태 ex) {“processTxt”: “Completed.”, “pr ocessPercent”: “100”}

  • 연동 예시

    {
       "HEADER":{
          "RESULTCODE":"0000",
          "RESULTMSG":"OK"
       },
       "BODY":{
          "kkoAltCnt":"1",
          "pushSendCnt":"0",
          "kkoFrtCnt":"0",
          "smsCnt":"0",
          "failCnt":0,
          "processInfo":{
             "processTxt":"Completed.",
             "processPercent":"100"
          },
          "processSeqno":"280"
       }
    }
    

[카카오친구톡] UMS 회원 / CSV예약발송 (대량발송 or 치환발송)

구분

내용

Controller URL

/api/csvSendFrtApi.ums

METHOD

POST

Content-type

multipart/form-data or application/x-www-form-urlencoded

설명

친구톡 회원 CSV 발송

비고

application/json 불가

  • Request (POST 방식 호출)

항목

타입

필수

설명

APIKEY

String

Y

유라클클라우드 데브콘솔에서 생성된 API키

CLOUD_PROJECT_ID

String

Y

유라클클라우드 데브콘솔에서 생성된 프로젝트아이디.

SENDERID

String

Y

발송자 정보. 통계정보 사용. Ex) MAILSYSTEM. 제약조건 영문 30byte 이하 문자

CSVFILE

MultipartFile

Y

CSV파일을 만들어 첨부한다.
P.S : 1번째 라인 컬럼정보, 2번째 라인부터 데이터
확인 : 푸시만 발송시에는 #{아이디} 하나만 넣어도 됨.
#{이름}, #{핸드폰번호} 생략가능. 회원정보에서 가져옴.
예1) csv파일 비 개인화
#{아이디} 첫번째라인 컬럼정보 헤드
user1

User2

예 2) 개인화 처리 CSV파일 만들기
#{아이디}, #{날자}, #{금액}
user1, 2019-05-01, 4,000

User2, 2019-05-04, 10,000

RESERVEDATE

String

N

발송예약 날자형식 : YYYY-MM-DD HH:MM .

FRIENDTOLK_SVCID

String

Y

LGCNS톡드림에 등록된 카카오친구톡 서비스아이디 ex)1910028xxxx

FRIENDTOLK_MSG

String

Y

친구톡 메시지. 최대 4000byte

PLUS_ID

String

Y

친구톡 플러스친구 아이디

KKO_BTN_LINK1

String

N

카카오톡 챗버블 버튼

버튼 타입: DS: 배송조회, WL: 웹링크, AL: 앱링크, BK: 봇키워드, MD: 메시지전달

[예제]
WL 예제:

{“name”:”유라클버튼 “,”type”:”WL”,”url _pc”:”http://blog.n aver.com/imagetech1 /221004457903”,”url _mobile”:”http://bl og.naver.com/imaget ech1/221004457903”}

AL 예제 :
{“nam

e”:”버튼명칭”,”type “:”AL”,”scheme_ios” :”scheme://xxx.xx”,

“scheme_android”

:”scheme://xxx.xx”}

BK 예제 :

{“name”:”봇키워드”,

“type”:”BK”}

MD 예제 : {” name”:”메세지전달”, “type”:”MD”}

KKO_BTN_LINK2

String

N

KKO_BTN_LINK3

String

N

KKO_BTN_LINK4

String

N

KKO_BTN_LINK5

String

N

SMS_TITLE

String

N

MMS문자일 경우 타이틀.

SMS_MSG

String

N

보낼 문자내용. 90byte이상은 MMS로 발송됩니다.

CALLBACK_NUM

String

N

회신번호. SMS대체발송일 경우 필수

MMS_IMGURL

String

N

MMS일 경우 이미지 URL: http:// xxxx.com/sample.jpg

  • TYPE : 일반발송 응답 메세지

구분

항목

필수

반복

설명

HEADER

RESULTCODE

String

Y

N

0000 : 응답 성공

그외 : 에러 메시지

RESULTMSG

String

Y

N

OK : 응답 성공

그외 : 에러 메시지

BODY

reserveSeqno

String

Y

예약발송 시퀀스 고유번호.

processInfo

Object

Y

발송진행상태 ex) {“processTxt”: “Completed.”, “pr ocessPercent”: “100”}

  • 연동 예시

    {
       "HEADER":{
          "RESULTCODE":"0000",
          "RESULTMSG":"OK"
       },
       "BODY":{
          "reserveSeqno":"220",
          "processInfo":{
             "processTxt":"Completed.",
             "processPercent":"100"
          }
       }
    }
    

[카카오친구톡] UMS 비회원 / CSV발송 (대량발송 or 치환발송)

구분

내용

Controller URL

/api/csvSendFrtMnApi.ums

METHOD

POST

Content-type

multipart/form-data or application/x-www-form-urlencoded

설명

친구톡 비회원 CSV발송

비고

application/json 불가

  • Request (POST 방식 호출)

항목

타입

필수

설명

APIKEY

String

Y

유라클클라우드 데브콘솔에서 생성된 API키

CLOUD_PROJECT_ID

String

Y

유라클클라우드 데브콘솔에서 생성된 프로젝트아이디.

SENDERID

String

Y

발송자 정보. 통계정보 사용. Ex) MAILSYSTEM. 제약조건 영문 30byte 이하 문자

CSVFILE

MultipartFile

Y

CSV파일을 만들어 첨부한다.
P.S : 1번째 라인 컬럼정보, 2번째 라인부터 데이터

확인 : 발송시에는 #{아이디},#{이름}, #{핸드폰번호} 반드시 넣어야 함.

예1) csv파일 비 개인화
#{아이디}, #{이름}, #{핸드폰번호} 첫번째라인 컬럼정보 헤드
user1, 홍길동1, 01000011111

User2, 홍길동2, 01000002222

예 2) 개인화 처리 CSV파일 만들기
#{아이디}, #{이름}, #{핸드폰번호}, #{날자}, #{금액}
user1, 홍길동1, 01000011111, 2019-05-01, 4,000

User2, 홍길동1, 01000011111, 2019-05-04, 10,000

FRIENDTOLK_SVCID

String

Y

LGCNS톡드림에 등록된 카카오친구톡 서비스아이디 ex)1910028xxxx

FRIENDTOLK_MSG

String

Y

친구톡 메시지. 최대 4000byte

PLUS_ID

String

Y

친구톡 플러스친구 아이디

KKO_BTN_LINK1

String

N

카카오톡 챗버블 버튼

버튼 타입: DS: 배송조회, WL: 웹링크, AL: 앱링크, BK: 봇키워드, MD: 메시지전달

[예제]
WL 예제:

{“name”:”유라클버튼 “,”type”:”WL”,”url _pc”:”http://blog.n aver.com/imagetech1 /221004457903”,”url _mobile”:”http://bl og.naver.com/imaget ech1/221004457903”}

AL 예제 :
{“nam

e”:”버튼명칭”,”type “:”AL”,”scheme_ios” :”scheme://xxx.xx”,

“scheme_android”

:”scheme://xxx.xx”}

BK 예제 :

{“name”:”봇키워드”,

“type”:”BK”}

MD 예제 : {” name”:”메세지전달”, “type”:”MD”}

KKO_BTN_LINK2

String

N

KKO_BTN_LINK3

String

N

KKO_BTN_LINK4

String

N

KKO_BTN_LINK5

String

N

SMS_TITLE

String

N

MMS문자일 경우 타이틀.

SMS_MSG

String

N

보낼 문자내용. 90byte이상은 MMS로 발송됩니다.

MMS_IMGURL

String

N

MMS일 경우 이미지 URL: http:// xxxx.com/sample.jpg

CALLBACK_NUM

String

N

회신번호. SMS대체발송일 경우 필수

  • TYPE : 일반발송 응답 메세지

구분

항목

필수

반복

설명

HEADER

RESULTCODE

String

Y

N

0000 : 응답 성공

그외 : 에러 메시지

RESULTMSG

String

Y

N

OK : 응답 성공

그외 : 에러 메시지

BODY

processSeqno

String

Y

발송 시퀀스 고유번호.

pushSendCnt

int

Y

푸시 발송수

kkoAltCnt

int

Y

카카오 알림톡 발송수

kkoFrtCnt

int

Y

카카오 친구톡 발송수

smsCnt

int

Y

문자 발송수

failCnt

int

Y

실패수

processInfo

Object

Y

발송진행상태 ex) {“processTxt”: “Completed.”, “pr ocessPercent”: “100”}

  • 연동 예시

    {
       "HEADER":{
          "RESULTCODE":"0000",
          "RESULTMSG":"OK"
       },
       "BODY":{
          "kkoAltCnt":"1",
          "pushSendCnt":"0",
          "kkoFrtCnt":"0",
          "smsCnt":"0",
          "failCnt":0,
          "processInfo":{
             "processTxt":"Completed.",
             "processPercent":"100"
          },
          "processSeqno":"280"
       }
    }
    

[카카오친구톡] UMS 비회원 / CSV예약발송 (대량발송 or 치환발송)

구분

내용

Controller URL

/api/csvSendFrtMnApi.ums

METHOD

POST

Content-type

multipart/form-data or application/x-www-form-urlencoded

설명

친구톡 비회원 CSV예약발송

비고

application/json 불가

  • Request (POST 방식 호출)

항목

타입

필수

설명

APIKEY

String

Y

유라클클라우드 데브콘솔에서 생성된 API키

CLOUD_PROJECT_ID

String

Y

유라클클라우드 데브콘솔에서 생성된 프로젝트아이디.

SENDERID

String

Y

발송자 정보. 통계정보 사용. Ex) MAILSYSTEM. 제약조건 영문 30byte 이하 문자

CSVFILE

MultipartFile

Y

CSV파일을 만들어 첨부한다.
P.S : 1번째 라인 컬럼정보, 2번째 라인부터 데이터

확인 : 발송시에는 #{아이디},#{이름}, #{핸드폰번호} 반드시 넣어야 함.

예1) csv파일 비 개인화
#{아이디}, #{이름}, #{핸드폰번호} 첫번째라인 컬럼정보 헤드
user1, 홍길동1, 01000011111

User2, 홍길동2, 01000002222

예 2) 개인화 처리 CSV파일 만들기
#{아이디}, #{이름}, #{핸드폰번호}, #{날자}, #{금액}
user1, 홍길동1, 01000011111, 2019-05-01, 4,000

User2, 홍길동1, 01000011111, 2019-05-04, 10,000

RESERVEDATE

String

N

발송예약 날자형식 : YYYY-MM-DD HH:MM .

FRIENDTOLK_SVCID

String

Y

LGCNS톡드림에 등록된 카카오친구톡 서비스아이디 ex)1910028xxxx

FRIENDTOLK_MSG

String

Y

친구톡 메시지. 최대 4000byte

PLUS_ID

String

Y

친구톡 플러스친구 아이디

KKO_BTN_LINK1

String

N

카카오톡 챗버블 버튼

버튼 타입: DS: 배송조회, WL: 웹링크, AL: 앱링크, BK: 봇키워드, MD: 메시지전달

[예제]
WL 예제:

{“name”:”유라클버튼 “,”type”:”WL”,”url _pc”:”http://blog.n aver.com/imagetech1 /221004457903”,”url _mobile”:”http://bl og.naver.com/imaget ech1/221004457903”}

AL 예제 :
{“nam

e”:”버튼명칭”,”type “:”AL”,”scheme_ios” :”scheme://xxx.xx”,

“scheme_android”

:”scheme://xxx.xx”}

BK 예제 :

{“name”:”봇키워드”,

“type”:”BK”}

MD 예제 : {” name”:”메세지전달”, “type”:”MD”}

KKO_BTN_LINK2

String

N

KKO_BTN_LINK3

String

N

KKO_BTN_LINK4

String

N

KKO_BTN_LINK5

String

N

SMS_TITLE

String

N

MMS문자일 경우 타이틀.

SMS_MSG

String

N

보낼 문자내용. 90byte이상은 MMS로 발송됩니다.

CALLBACK_NUM

String

N

회신번호. SMS대체발송일 경우 필수

MMS_IMGURL

String

N

MMS일 경우 이미지 URL: http:// xxxx.com/sample.jpg

  • TYPE : 일반발송 응답 메세지

구분

항목

필수

반복

설명

HEADER

RESULTCODE

String

Y

N

0000 : 응답 성공

그외 : 에러 메시지

RESULTMSG

String

Y

N

OK : 응답 성공

그외 : 에러 메시지

BODY

reserveSeqno

String

Y

예약발송 시퀀스 고유번호.

processInfo

Object

Y

발송진행상태 ex) {“processTxt”: “Completed.”, “pr ocessPercent”: “100”}

  • 연동 예시

    {
       "HEADER":{
          "RESULTCODE":"0000",
          "RESULTMSG":"OK"
       },
       "BODY":{
          "reserveSeqno":"220",
          "processInfo":{
             "processTxt":"Completed.",
             "processPercent":"100"
          }
       }
    }