카페24 고객파일 REST API 로 카카오채널에 고객파일 등록하기 문제점

infonfckr1 · 8월 28, 2023, 5:18오전

앱ID : 628915 (아까 628925 로 잘못 알려드렸었습니다. 죄송합니다.)

안녕하세요,

https://developers.kakao.com/docs/latest/ko/kakaotalk-channel/rest-api#create-user-file

위 지침에 따라서 잘 연동한 후
API 를 호출해서
카페24 고객파일이 저희 카카오채널 관리자에 업로드 되는 것을 확인했습니다.

그런데 고객파일에서 카카오id 식별자로 1열에 "전화번호"를 위치하게 하려 했는데요,
문제는 카페24 데이터항목명은 "휴대폰번호"입니다. 1열 항목으로 휴대폰번호를 수집되지만 그 항목명이 "전화번호"가 아니라서 카카오채널 친구 매칭이 안되고 있는 것 같습니다.
또한 회원등급 등 추가항목의 경우, 문자가 "숫자"로 해야 한다고 하는데, 카페24에서 API로 고객정보 취합할 때는 일반/골드/VIP회원 등의 문자로 들어옵니다.

그렇다면 API로 고객파일 등록/갱신은 어려운지요?

수동으로 파일 업로드 하지 않고 API로 고객파일 등록/갱신 하고 싶습니다.
어떻게 해야할지 도움 주시면 매우 감사하겠습니다.

tim.l · 8월 28, 2023, 5:34오전

카카오톡채널 관리자센터

식별자로 사용하시려면 항목명을 전화번호로 사용해주셔야합니다. API 처리 시, 명칭 변경 부탁드려요.

2) 1열에 앱유저아이디 또는 전화번호를 택일하여 입력해주세요. 
전화번호를 입력할 경우 항목명 또한 '전화번호'로 수정해주셔야합니다.

또한 회원등급 등 추가항목의 경우, 문자가 "숫자"로 해야 한다고 하는데, 카페24에서 API로 고객정보 취합할 때는 일반/골드/VIP회원 등의 문자로 들어옵니다.

API로 처리 시, 숫자로 치환하셔서 호출 부탁드립니다.

카페 24에서 받은 파일을 이용하여 카카오 API 호출 하시는 것으로 이해 했는데요.
직접 프로그램을 개발하여 호출하시는게 아닌가요?
위에서 설명드린 것처럼 카페24에서 받은 파일 로드 하며 카카오톡 채널 고객파일 시스템에 맞게 치환 하시면 될 것같은데
다른 상황이시라면 말씀해주세요~

infonfckr1 · 8월 28, 2023, 5:43오전

답변 감사합니다.

카페24에서 고객파일을 다운 받아서, 카카오채널 고객파일 등록하는 것이 매번 번거로워서요,
API연동으로 고객파일 갱신하려고 시도 중입니다.

https://developers.kakao.com/docs/latest/ko/kakaotalk-channel/rest-api#create-user-file-sample

curl -v -X POST “https://kapi.kakao.com/v1/talkchannel/create/target_user_file”
-H “Authorization: KakaoAK MY-REST-API-KEY”
-H “Content-Type: application/json”
-d ‘{
“channel_public_id”: “_xxxxx”,
“file_name”: “vip고객리스트_dad2”,
“schema”:{
“전화번호”:“number”,
“아이디”:“string”,
“연령”:“number”
}
}’

위 예제를 변형하여 INSOMNIA라는 REST API 클라이언트 프로그램에 입력하여
전송했더니 카카오채널 관리자 페이지에 일단 등록(업로드)되는 것은 확인했습니다.

(위 스샷 맨밑의 kakaosample1.csv 는 수동으로 올린 거라, 1열 전화번호로 친구매칭이 되었는데, 나머지 파일들은 친구매칭이 안되었어요. 카페24에서 수집된 1열 항목명이 전화번호값이 휴대폰번호가 아니라 일반전화번호였습니다…ㅠ)

사실 제가 관련지식이 별로 없는 사람입니다. API로 처리시 명칭변경, 숫자로 치환해서 호출하는 방법을 모릅니다…

위 예제코드에서 휴대폰번호를 전화번호로 바꿔서 만들라는,
schema 명칭을 바꿔서 → csv 파일이 만들어져서 → 카카오채널에 등록되는 방법이 있는 걸까요?
도움말 부탁드립니다.

tim.l · 8월 28, 2023, 5:59오전

INSOMNIA는 사용해본적이 없어서 어떤 기능이 있는지 안내는 어려운데요.

API로 고객파일 등록은 크게 두가지 철차로 이루어집니다.

(1) 고객파일 등록하기

등록할 고객파일의 이름과 스키마를 생성하는 것으로 전화번호와 같은 키값은 정의하지 않아도 됩니다.

(2) 사용자 추가하기

파일 등록을 하신 것 보니 API 호출은 하신 것 같습니다.
전화번호를 키값으로 생성한 고객파일에 사용자 정보 추가하시려면 아래와 같이 user_type에 phone으로 설정하시고 id에 전화번호 설정해주시면됩니다.

{
            "file_id": 00000,
            "channel_public_id": "_XXXXXX",
            "user_type": "phone",
            "users": [
            {
                "id": "0100000000",
                "field" : {
                    "생년월일": "2000-01-01",
                    "성별": "남자", 
                    "age": 19
                }
            },
            ...
        ]
    }

기재해주신 628925 디벨로퍼스앱은 최근 2주간 API 호출 이력이 없는데요.
등록하신 고객파일이 API 호출로 등록하신게 맞나요?

엑셀파일을 읽어 채널 고객파일 생성 및 사용자 추가 API 호출하는 것이 난이도 높은 것은 아니나
개발자 도움 없이 처리하시기에는 어려움이 있을 것같습니다.

필요시 외주 개발의뢰 해보시면 좋을 것 같아요.

infonfckr1 · 8월 28, 2023, 6:15오전

네, API 호출로 등록한 것입니다. 오늘 새벽에 했었습니다.

아, 그러면 고객파일을 등록하는 것은 껍데기를 등록하는 것인가요?
그런 다음에 고객파일에 사용자를 추가하는 방식이었군요. 제가 살짝 잘못 이해하고 있었습니다.

그럼 카페24에서 엑셀파일을 다운 받은 뒤 그걸 읽어서 사용자 추가 api 를 호출하는 건가요,
아니면 엑셀파일 다운 없이 api 로 카페24 → 카카오채널로 사용자추가가 직접 되는 건가요?

감사합니다.

tim.l · 8월 28, 2023, 6:35오전

아, 그러면 고객파일을 등록하는 것은 껍데기를 등록하는 것인가요?

넵. 맞습니다. (API로 등록할때는 껍데기를 등록하고 내용을 채워넣는 형태입니다.)

그럼 카페24에서 엑셀파일을 다운 받은 뒤 그걸 읽어서 사용자 추가 api 를 호출하는 건가요,
아니면 엑셀파일 다운 없이 api 로 카페24 → 카카오채널로 사용자추가가 직접 되는 건가요?

일반적으로 자사몰인경우 DB에서 고객정보를 조회하여 직접 카카오 채널 API 를 호출하지만,
카페24의 경우 엑셀파일 다운로드 하지 않고 정보를 받을 수 없어서 (1) 엑셀을 받고 (2) 엑셀을 읽어서 사용자 추가해야합니다.

참고로 API로 업로드 가능한 대상 유저는 운영하시는 사이트에 카카오 로그인했고 채널 친구인 경우만 추가됩니다.

628925 디벨로퍼스앱에는 연결된 채널이 없는데요. 카페24에 설정된 디벨로퍼스앱이 맞는지 확인해보시겠어요?

infonfckr1 · 8월 28, 2023, 7:40오전

아, 엑셀을 다운받아서 읽고 사용자 추가하는 것이군요. 잘 알겠습니다.
아… 죄송합니다. 아까 제가 앱ID를 잘못 알려드렸습니다. 628915 였습니다. 죄송합니다!!!

"식탁보감"이라는 이름의 채널과 연결되어 있습니다.
카카오 로그인도 하고 있고요.

tim.l · 8월 28, 2023, 7:50오전

넵, 앱ID 확인 감사합니다.

이 내용과 별건이지만,
(1) 배송지 제3자 정보제공동의항목을 활성화 하시면 카카오 로그인으로 배송지 정보를 받을 수 있습니다.

카페24 관리자 페이지에서 “운영방식설정의 상세항목 표시” 주소 필수 설정으로 수집가능합니다.

카페24 “카카오 싱크 간편 설정”, "카카오톡 공유하기", "카카오톡 채널" 자주하는 질문

(2) 고객파일의 사용자 정보 추가는 위에 안내드린 것처럼 식별자는 id 항목에 담아 API 호출하시면 됩니다.

(3) 카카오 로그인으로 가입한 사용자가 채널 친구인지 확인하는 방법은

아래 채널 관계 확인하기 API로 조회 해볼 수 있으며, 다건 조회도 가능합니다.

REST API | Kakao Developers REST API

참고 부탁드려요~

infonfckr1 · 8월 28, 2023, 9:33오전

진심으로 감사드립니다!