============================= 카카오 알림톡 APIs ============================= [카카오알림톡] UMS 회원 발송 (단건 치환발송) -------------------------------------------- ============== ======================================================== 구분 내용 ============== ======================================================== Controller URL /api/umsSendAltApi.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명 가능 | +---------------------+--------+------+-------------------------+ | KKOALT_SVCID | String | Y | LGCNS톡드림에 등록된 | | | | | 카카오알림톡 | | | | | 서비스아이디 | | | | | ex)1910028xxxx | +---------------------+--------+------+-------------------------+ | ALLIMTOLK_TEMPLCODE | String | Y | 카카오알림톡 | | | | | 등록템플릿코드 ex) | | | | | 10138 | +---------------------+--------+------+-------------------------+ | REPLACE_VARS | String | N | | - 알림톡 템플릿에 | | | | | 내용에 #{변수명}과 | | | | | 같은 치환변수가 | | | | | 템플릿 내용에 있을 | | | | | 경우 필수값. | | | | | | - 메시지 형태 JSON | | | | | Object | | | | | | | | | | - ex) | | | | | | | | | | | 메시지 내용 : | | | | | 안녕하세요. 결제일은 | | | | | #{날짜} 입니다. | | | | | #{금액}이 청구됩니다. | | | | | | 넘겨야 될 파라미터값 | | | | | : | | | | | { | | | | | “#{날짜}”:”2019-07-07”, | | | | | “#{금액}”:”1,000”} | +---------------------+--------+------+-------------------------+ | PLUS_ID | String | Y | 카카오톡 플러스친구 | | | | | 아이디 | +---------------------+--------+------+-------------------------+ | KKO_BTN_LINK1 | String | N | 카카오톡 챗버블 버튼 | | | | | | | | | | 버튼 타입: DS: | | | | | 배송조회, WL: 웹링크, | | | | | AL: 앱링크, BK: | | | | | 봇키워드, MD: | | | | | 메시지전달 | | | | | | | | | | | **[예제]** | | | | | | - **알림톡 예제** | | | | | : | | | | | http:// | | | | | xxx.com||http://xxx.com | | | | | | - **친구톡 예제** | | | | | : | | | | | | **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/umsSendAltApi.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명 가능 | +---------------------+------------+-------+----------------------+ | KKOALT_SVCID | String | Y | LGCNS톡드림에 등록된 | | | | | 카카오알림톡 | | | | | 서비스아이디 | | | | | ex)1910028xxxx | +---------------------+------------+-------+----------------------+ | ALLIMTOLK_TEMPLCODE | String | Y | 카카오알림톡 | | | | | 등록템플릿코드 ex) | | | | | 10138 | +---------------------+------------+-------+----------------------+ | REPLACE_VARS | String | N | | - 알림톡 템플릿에 | | | | | 내용에 #{변수명}과 | | | | | 같은 치환변수가 | | | | | 템플릿 내용에 있을 | | | | | 경우 필수값. | | | | | | - 메시지 형태 JSON | | | | | Object | | | | | | | | | | - ex) | | | | | | | | | | | 메시지 내용 : | | | | | 안녕하세요. | | | | | 결제일은 #{날짜} | | | | | 입니다. #{금액}이 | | | | | 청구됩니다. | | | | | | 넘겨야 될 | | | | | 파라미터값 : | | | | | {“#{ | | | | | 날짜}”:”2019-07-07”, | | | | | “#{금액}”:”1,000”} | +---------------------+------------+-------+----------------------+ | PLUS_ID | String | Y | 카카오톡 플러스친구 | | | | | 아이디 | +---------------------+------------+-------+----------------------+ | **RESERVEDATE** | **String** | **N** | **발송예약 날자형식 | | | | | : YYYY-MM-DD HH:MM | | | | | .** | +---------------------+------------+-------+----------------------+ | KKO_BTN_LINK1 | String | N | 카카오톡 챗버블 버튼 | | | | | | | | | | 버튼 타입: DS: | | | | | 배송조회, WL: | | | | | 웹링크, AL: 앱링크, | | | | | BK: 봇키워드, MD: | | | | | 메시지전달 | | | | | | | | | | | **[예제]** | | | | | | - **알림톡 | | | | | 예제** : | | | | | http://xxx | | | | | .com||http://xxx.com | | | | | | - **친구톡 | | | | | 예제** : | | | | | | **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/umsSendAltMnApi.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… 임의의 | | | | | 아이디 생성하여 보냄. | +---------------------+--------+------+-------------------------+ | KKOALT_SVCID | String | Y | LGCNS톡드림에 등록된 | | | | | 카카오알림톡 | | | | | 서비스아이디 | | | | | ex)1910028xxxx | +---------------------+--------+------+-------------------------+ | ALLIMTOLK_TEMPLCODE | String | Y | 카카오알림톡 | | | | | 등록템플릿코드 ex) | | | | | 10138 | +---------------------+--------+------+-------------------------+ | REPLACE_VARS | String | N | | - 알림톡 템플릿에 | | | | | 내용에 #{변수명}과 | | | | | 같은 치환변수가 | | | | | 템플릿 내용에 있을 | | | | | 경우 필수값. | | | | | | - 메시지 형태 JSON | | | | | Object | | | | | | | | | | - ex) | | | | | | | | | | | 메시지 내용 : | | | | | 안녕하세요. 결제일은 | | | | | #{날짜} 입니다. | | | | | #{금액}이 청구됩니다. | | | | | | 넘겨야 될 파라미터값 | | | | | : | | | | | { | | | | | “#{날짜}”:”2019-07-07”, | | | | | “#{금액}”:”1,000”} | +---------------------+--------+------+-------------------------+ | PLUS_ID | String | Y | 카카오톡 플러스친구 | | | | | 아이디 | +---------------------+--------+------+-------------------------+ | KKO_BTN_LINK1 | String | N | 카카오톡 챗버블 버튼 | | | | | | | | | | 버튼 타입: DS: | | | | | 배송조회, WL: 웹링크, | | | | | AL: 앱링크, BK: | | | | | 봇키워드, MD: | | | | | 메시지전달 | | | | | | | | | | | **[예제]** | | | | | | - **알림톡 예제** | | | | | : | | | | | http:// | | | | | xxx.com||http://xxx.com | | | | | | - **친구톡 예제** | | | | | : | | | | | | **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 | 보낼 문자내용 | +---------------------+--------+------+-------------------------+ | 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/umsSendAltMnApi.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 | | | | | .** | +---------------------+------------+-------+----------------------+ | KKOALT_SVCID | String | Y | LGCNS톡드림에 등록된 | | | | | 카카오알림톡 | | | | | 서비스아이디 | | | | | ex)1910028xxxx | +---------------------+------------+-------+----------------------+ | ALLIMTOLK_TEMPLCODE | String | Y | 카카오알림톡 | | | | | 등록템플릿코드 ex) | | | | | 10138 | +---------------------+------------+-------+----------------------+ | REPLACE_VARS | String | N | | - 알림톡 템플릿에 | | | | | 내용에 #{변수명}과 | | | | | 같은 치환변수가 | | | | | 템플릿 내용에 있을 | | | | | 경우 필수값. | | | | | | - 메시지 형태 JSON | | | | | Object | | | | | | | | | | - ex) | | | | | | | | | | | 메시지 내용 : | | | | | 안녕하세요. | | | | | 결제일은 #{날짜} | | | | | 입니다. #{금액}이 | | | | | 청구됩니다. | | | | | | 넘겨야 될 | | | | | 파라미터값 : | | | | | {“#{ | | | | | 날짜}”:”2019-07-07”, | | | | | “#{금액}”:”1,000”} | +---------------------+------------+-------+----------------------+ | PLUS_ID | String | Y | 카카오톡 플러스친구 | | | | | 아이디 | +---------------------+------------+-------+----------------------+ | KKO_BTN_LINK1 | String | N | 카카오톡 챗버블 버튼 | | | | | | | | | | 버튼 타입: DS: | | | | | 배송조회, WL: | | | | | 웹링크, AL: 앱링크, | | | | | BK: 봇키워드, MD: | | | | | 메시지전달 | | | | | | | | | | | **[예제] 파이프 | | | | | 2개 구분자로 | | | | | 링크구분.** | | | | | | - **알림톡 예제** | | | | | : | | | | | http://xxx | | | | | .com||http://xxx.com | +---------------------+------------+-------+----------------------+ | 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/csvSendAltApi.ums METHOD POST Content-type multipart/form-data or application/x-www-form-urlencoded 설명 UMS 회원 알림톡 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 | +---------------------+---------------+------+---------------------+ | KKOALT_SVCID | String | Y | LGCNS톡드림에 | | | | | 등록된 카카오알림톡 | | | | | 서비스아이디 | | | | | ex)1910028xxxx | +---------------------+---------------+------+---------------------+ | ALLIMTOLK_TEMPLCODE | String | Y | 카카오알림톡 | | | | | 등록템플릿코드 ex) | | | | | 10138 | +---------------------+---------------+------+---------------------+ | PLUS_ID | String | Y | 카카오톡 플러스친구 | | | | | 아이디 | +---------------------+---------------+------+---------------------+ | KKO_BTN_LINK1 | String | N | 카카오톡 챗버블 | | | | | 버튼 | | | | | | | | | | 버튼 타입: DS: | | | | | 배송조회, WL: | | | | | 웹링크, AL: 앱링크, | | | | | BK: 봇키워드, MD: | | | | | 메시지전달 | | | | | | | | | | | **[예제]** | | | | | | - **알림톡 | | | | | 예제** : | | | | | http://xxx. | | | | | com||http://xxx.com | | | | | | - **친구톡 | | | | | 예제** : | | | | | | **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 | 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/csvSendAltApi.ums METHOD POST Content-type multipart/form-data or application/x-www-form-urlencoded 설명 UMS 회원 알림톡 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 | | | | | .** | +---------------------+---------------+-------+---------------------+ | KKOALT_SVCID | String | Y | LGCNS톡드림에 | | | | | 등록된 카카오알림톡 | | | | | 서비스아이디 | | | | | ex)1910028xxxx | +---------------------+---------------+-------+---------------------+ | ALLIMTOLK_TEMPLCODE | String | Y | 카카오알림톡 | | | | | 등록템플릿코드 ex) | | | | | 10138 | +---------------------+---------------+-------+---------------------+ | PLUS_ID | String | Y | 카카오톡 플러스친구 | | | | | 아이디 | +---------------------+---------------+-------+---------------------+ | KKO_BTN_LINK1 | String | N | 카카오톡 챗버블 | | | | | 버튼 | | | | | | | | | | 버튼 타입: DS: | | | | | 배송조회, WL: | | | | | 웹링크, AL: 앱링크, | | | | | BK: 봇키워드, MD: | | | | | 메시지전달 | | | | | | | | | | | **[예제]** | | | | | | - **알림톡 | | | | | 예제** : | | | | | http://xxx. | | | | | com||http://xxx.com | | | | | | - **친구톡 | | | | | 예제** : | | | | | | **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/csvSendAltMnApi.ums METHOD POST Content-type multipart/form-data or application/x-www-form-urlencoded 설명 UMS 비회원 알림톡 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 | +---------------------+---------------+------+---------------------+ | KKOALT_SVCID | String | Y | LGCNS톡드림에 | | | | | 등록된 카카오알림톡 | | | | | 서비스아이디 | | | | | ex)1910028xxxx | +---------------------+---------------+------+---------------------+ | ALLIMTOLK_TEMPLCODE | String | Y | 카카오알림톡 | | | | | 등록템플릿코드 ex) | | | | | 10138 | +---------------------+---------------+------+---------------------+ | PLUS_ID | String | Y | 카카오톡 플러스친구 | | | | | 아이디 | +---------------------+---------------+------+---------------------+ | KKO_BTN_LINK1 | String | N | 카카오톡 챗버블 | | | | | 버튼 | | | | | | | | | | 버튼 타입: DS: | | | | | 배송조회, WL: | | | | | 웹링크, AL: 앱링크, | | | | | BK: 봇키워드, MD: | | | | | 메시지전달 | | | | | | | | | | | **[예제]** | | | | | | - **알림톡 | | | | | 예제** : | | | | | http://xxx. | | | | | com||http://xxx.com | | | | | | - **친구톡 | | | | | 예제** : | | | | | | **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/csvSendAltMnApi.ums METHOD POST Content-type multipart/form-data or application/x-www-form-urlencoded 설명 UMS 비회원 알림톡 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 | | | | | .** | +---------------------+---------------+-------+---------------------+ | KKOALT_SVCID | String | Y | LGCNS톡드림에 | | | | | 등록된 카카오알림톡 | | | | | 서비스아이디 | | | | | ex)1910028xxxx | +---------------------+---------------+-------+---------------------+ | ALLIMTOLK_TEMPLCODE | String | Y | 카카오알림톡 | | | | | 등록템플릿코드 ex) | | | | | 10138 | +---------------------+---------------+-------+---------------------+ | PLUS_ID | String | Y | 카카오톡 플러스친구 | | | | | 아이디 | +---------------------+---------------+-------+---------------------+ | KKO_BTN_LINK1 | String | N | 카카오톡 챗버블 | | | | | 버튼 | | | | | | | | | | 버튼 타입: DS: | | | | | 배송조회, WL: | | | | | 웹링크, AL: 앱링크, | | | | | BK: 봇키워드, MD: | | | | | 메시지전달 | | | | | | | | | | | **[예제]** | | | | | | - **알림톡 | | | | | 예제** : | | | | | http://xxx. | | | | | com||http://xxx.com | | | | | | - **친구톡 | | | | | 예제** : | | | | | | **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" } } }