카카오 비즈니스 고객파일 api 관련

curl -v -X POST “https://kapi.kakao.com/v1/talkchannel/create/target_user_file
-H “Authorization: KakaoAK {{apikey}}”
-H “Content-Type: application/json”
-d ‘{
“channel_public_id”: “{{mychannel}}”,
“file_name”: “file_name”,
“schema”:{
“전화번호”:“string”,
“이름”:“string”,
“생년월일”:“string”,
“가입일”:“string”,
“회원타입”:“number”,
“최근구매일”:“string”,
“응모일”:“string”,
“최근구매상품”:“number”,
“카테고리”:“number”
}
}’

위와 같은 api를 통해 파일을 생성 후 조회시
스키마가 아래와 같이 구성되는 것을 확인했습니다.

{ "생년월일":"number", "회원타입":"number", "최근구매상품":"number", "응모일":"number", "가입일":"number", "카테고리":"number", "최근구매일":"number" }

문자열의 경우 지정된 필드만 사용가능한걸로 알고있습니다.
그리고 Date 관련 필드의 경우 string으로 지정하더라도 내부적으로 number 로 치환하는걸로 알고있습니다.
다만 전화번호, 이름등의 필드가 제시된 샘플파일에 존재하여 동일하게 사용하고자 위와 같이 처리했는데

전화번호, 이름가 스키마에 누락되었습니다.

질문은 아래와 같습니다.

  1. 누락된 이유를 알 수 있을까요?

  2. 누락된 상태로도 api를 통해 고객 추가시 스키마에 누락된 필드에 대해서도 정보가 정상적으로 추가가 되나요?

  3. 샘플파일의 경우 이름, 전화번호 등이 존재하지만 해당 샘플파일을 파일 업로드를 통해 고객파일을 추가한 다음
    스키마를 조회 시 아래와 같이 반환됩니다.
    “schema”: “{}”
    파일 업로드/api 를 통한 파일 생성 두가지 방법 모두 스키마가 누락되는 문제가 있는것으로 보이는데 위와 같은 구성으로 파일을 생성하고자 한다면 어떤 방법을 취해야 할까요?

안녕하세요.

확인을 위해 앱 ID 부탁드립니다.


앱ID
https://developers.kakao.com/ 의 내 애플리케이션>앱 설정>요약 정보 : 기본정보에 있는 앱 ID
숫자로된 ID 입니다

ex) 123456

확인에 시간이 다소 소요되어 미리 양해 부탁드립니다
전달해 주신 정보로 확인 중이며 확인 후 답변 드리겠습니다.

1개의 좋아요

@kjg3493
안녕하세요.
본문의 답변 드립니다.

1.누락된 이유를 알 수 있을까요?

string 유형은 기본 제공 키 값인 생년월일, 국가, 지역, 성별, 연령, 구매금액, 포인트, 가입일, 최근 구매일, 응모일 만 등록 가능합니다.

그 외, 직접 관리하실 항목은 number 형태로만 등록가능합니다.
(단, “전화번호”, “앱유저아이디” 항목은 예약된 항목으로 등록 불가)

위 규칙에 의해 "이름": "string" 의 경우 등록 불가하였습니다.
참고: 디벨로퍼스 가이드

2. 누락된 상태로도 api를 통해 고객 추가시 스키마에 누락된 필드에 대해서도 정보가 정상적으로 추가가 되나요?
누락된 필드는 친구그룹 목록에서 사용불가 합니다.
“전화번호”, “앱유저아이디” 항목의 경우 고객 식별용도로 되는 예약된 항목으로서 스키마에 포함되지 않습니다. 이들 값은 사용자 추가하기 시, id 파라미터에서 사용되며, 직접 파일 업로드는 첫번째 열에서 사용됩니다.

3. 샘플파일의 경우 이름, 전화번호 등이 존재하지만 해당 샘플파일을 파일 업로드를 통해 고객파일을 추가한 다음
스키마를 조회 시 아래와 같이 반환됩니다.

채널 관리자 센터에서 파일을 직접 업로드 시, 파일내 유효한 고객이 1명도 없는 경우 스키마는"{}"와 같이 처리됩니다.

1개의 좋아요

친절한 답변 감사합니다.