============================= 카카오 친구톡 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"} | +--------+--------------+--------+------+------+----------------+ * **연동 예시** .. code-block:: javascript** { "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"} | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ * **연동 예시** .. code-block:: javascript** { "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"} | +--------+--------------+--------+------+------+----------------+ * **연동 예시** .. code-block:: javascript** { "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"} | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ * **연동 예시** .. code-block:: javascript** { "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"} | +--------+--------------+--------+------+------+----------------+ * **연동 예시** .. code-block:: javascript** { "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"} | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ * **연동 예시** .. code-block:: javascript** { "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"} | +--------+--------------+--------+------+------+----------------+ * **연동 예시** .. code-block:: javascript** { "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"} | +--------+--------------+--------+------+------+----------------+ | | | | | | | +--------+--------------+--------+------+------+----------------+ * **연동 예시** .. code-block:: javascript** { "HEADER":{ "RESULTCODE":"0000", "RESULTMSG":"OK" }, "BODY":{ "reserveSeqno":"220", "processInfo":{ "processTxt":"Completed.", "processPercent":"100" } } }