쿠팡 WING 오픈API 발급·연동 가이드
쿠팡을 제디 에이전트에 연결하면 WING의 고객 상품 문의를 모아 보고 우리 매장 전용 CS AI 에이전트와 답변을 준비할 수 있어요. WING에서 발급한 액세스 키·시크릿 키, 업체코드와 답변 작성에 사용할 WING 아이디를 입력해 연결해요.
최종 업데이트
쿠팡 문의도 한 화면에서
고객 상품 문의를 다른 판매 채널의 문의와 함께 확인해 응대 동선을 줄여요.
답변 준비에 드는 수고를 줄여요
AI가 매장 기준과 확인 가능한 상품·주문 정보를 참고해 답변 초안을 준비해요.
검토하고 WING으로 전송
문의함에서 내용을 다듬어 보내면 쿠팡 고객 문의에 답변이 등록돼요.
시작 전에 확인하세요.
준비할 것
- 사업자 인증과 입점 절차가 끝난 쿠팡 WING 판매자 계정
- 제디 에이전트 계정과 제디 서버 IP(로그인 후 판매 채널 연동의 쿠팡 연결 입력칸에 보여요)
- 다른 연동 솔루션을 사용 중이라면 현재 업체 입력 방식과 기존 업체의 서버 IP
한눈에 보기
- 설정하는 곳
- 쿠팡 WING → 판매자정보 → 추가판매정보 → OPEN API 키 발급
- 준비할 정보
- 액세스 키 · 시크릿 키 · 업체코드 · WING 아이디
- 함께 설정
- 업체 입력 방식 · 제디 서버 IP
- 키 관리
- 유효기간 180일 · 만료 전 재발급
연결 순서
제디 서버 IP를 먼저 확인해요
WING에서 키를 발급할 때 제디 서버 IP를 입력해야 해요. 제디에 로그인해 판매 채널 연동에서 쿠팡을 선택하고 연결하기를 누르면 입력칸 위에 제디 서버 IP가 보여요. 처음 설정 화면이 떠 있다면 판매 채널 연결하기 단계에서도 같은 자리에 보여요. 복사 버튼으로 복사해 두세요. 키 발급 화면의 IP 주소 칸에 그대로 붙여넣어요.
로그인하면 이 자리에 제디 서버 IP가 보여요. 그림에서는 값을 가렸어요. WING에서 추가판매정보를 열어요
WING 왼쪽 메뉴의 판매자정보에서 추가판매정보를 열어요. 오른쪽 위 아이디를 눌러 들어가도 돼요. 들어갈 때 WING 비밀번호를 한 번 더 입력해요. 사업자 인증이 완료된 계정에서 진행할 수 있어요.
쿠팡 WING으로 이동API Key 발급 받기를 누르고 사용 목적을 골라요
OPEN API 키 발급 항목에서 API Key 발급 받기를 눌러요. 이미 키를 쓰고 있다면 새로 발급하지 않고 연동 정보의 수정을 눌러요. 사용 목적은 OPEN API를 선택하고 약관에 동의해요. 플레이오토 웹 솔루션으로 받은 키는 쓸 수 없어요.
쿠팡 공식 키 발급 안내업체 입력 방식은 자체개발(직접입력)을 골라요
업체 입력 방식에서 자체개발(직접입력)을 골라요. 이 방식이어야 제디 서버 IP를 직접 넣을 수 있어요. 이미 연동업체 선택으로 다른 솔루션을 쓰고 있다면 바꾸기 전에 자주 묻는 질문의 기존 솔루션과 함께 쓰는 방법을 먼저 확인해요. 기존 업체의 서버 IP 없이 바꾸면 그쪽 연동이 멈춰요.
업체명과 URL, 제디 서버 IP를 넣어요
업체명에는 제디 에이전트를, URL에는 zediagent.com을 적어요. IP 주소 칸에는 앞에서 확인한 제디 서버 IP를 넣어요. 쿠팡이 접속을 허용할 IP를 적는 칸이에요. 기존 솔루션과 함께 쓴다면 업체명과 URL은 적혀 있는 값을 그대로 두고 그 업체에서 확인한 서버 IP를 함께 넣어요. PC에 설치해 쓰는 프로그램이라면 그 PC의 IP가 필요해요. IP는 10개까지 넣을 수 있어요.
IP 주소 칸에 제디 서버 IP를 추가하는 모습을 그린 그림이에요. 실제 화면과는 모양이 달라요. 키와 업체코드, 답변 작성자 아이디를 준비해요
발급 화면의 액세스 키와 시크릿 키, 판매자의 업체코드를 확인해요. 답변 작성자에는 WING에 로그인하는 사용자 아이디를 사용해요. WING 아이디는 판매자정보의 계정정보에서 확인할 수 있어요. 업체코드와 WING 아이디는 서로 다른 값이에요.
제디에 입력하고 실제 수집을 확인해요
판매 채널 연동에서 쿠팡을 선택해 액세스 키, 시크릿 키, 업체코드, WING 사용자 아이디 네 칸을 채워요. 연결 후 지금 확인하기를 실행해 수집 결과를 확인해요. 처음 발급한 키는 쿠팡의 접근 권한이 열리기까지 24시간 넘게 걸릴 수 있어요. IP나 연동 정보를 고친 직후에는 쿠팡 안내로 최대 30분이 걸리고 그보다 오래 걸리는 경우도 있어요.
제디의 쿠팡 카드에서 연결하기를 누르면 나오는 입력칸이에요.
연결을 마치면 확인해 주세요.
- 입력한 업체코드와 답변 작성자 WING 아이디가 해당 판매자 계정의 값인지 확인해요.
- 연결 후 지금 확인하기를 실행하고 채널의 오류 안내와 문의 수집 결과를 살펴봐요.
- 매장 기준을 가르친 뒤 검토 후 전송 모드에서 답변을 준비하고 기존 솔루션도 정상 작동하는지 확인해요.
입력할 정보는 여기 있어요.
| 입력할 정보 | 찾는 위치와 확인 방법 |
|---|---|
| 액세스 키 (access key) | WING의 오픈API 키 발급 정보에 표시된 Access Key를 복사해요. |
| 시크릿 키 (secret key) | 같은 발급 정보의 Secret Key예요. 발급한 화면에서 바로 복사해 보관해요. 나중에 같은 화면에서 다시 볼 수 있다는 안내가 많지만 적어 두는 편이 안전해요. 다른 판매자나 이전에 폐기한 키가 아닌지 확인해요. |
| 업체코드 (vendor id) | WING 오른쪽 위의 업체명이나 아이디를 누르면 보이는 코드예요. A 또는 C로 시작하고 키 발급 화면에도 함께 표시돼요. WING 로그인 아이디와 구분해서 입력해요. |
| WING 사용자 아이디 (답변 작성자) | 해당 판매자 계정에서 답변을 작성할 WING 로그인 아이디예요. 판매자정보의 계정정보에서 확인할 수 있어요. 업체코드를 입력하는 칸이 아니에요. |
여기부터 확인해 보세요.
발급 직후 연결했는데 문의를 가져오지 못해요.
처음 발급한 키는 접근 권한이 열리기까지 24시간 넘게 걸릴 수 있어요. IP 주소 칸에 제디 서버 IP가 들어 있는지, 업체코드와 키가 맞는지 확인한 뒤 시간을 두고 지금 확인하기를 다시 눌러 주세요. IP를 방금 고쳤다면 쿠팡 안내로 최대 30분이 걸려요. 1시간 넘게 걸리는 경우도 있으니 조금 더 기다렸다가 다시 확인해 주세요.
문의는 보이는데 답변이 전송되지 않아요.
답변 작성자 칸에 업체코드가 아닌 해당 계정의 WING 로그인 아이디가 들어 있는지 확인해요. 고객이 삭제한 문의에는 답변을 보낼 수 없어요.
키를 재발급한 뒤 기존 솔루션이 연결되지 않아요.
새 키를 제디뿐 아니라 같은 키를 사용하는 기존 솔루션에도 반영해요. 재발급 전 사용 중인 서비스를 확인해 두면 연결 정보를 함께 바꾸기 편해요.
연동 정보를 더 수정할 수 없다고 나와요.
쿠팡은 연동 정보 수정을 한 주에 10회까지만 허용해요. IP를 지우고 새로 넣는 것도 횟수에 들어가요. 횟수가 다시 생길 때까지 기다린 뒤 한 번에 정확히 입력해 주세요.
자주 묻는 질문
기존 주문·재고 솔루션과 함께 쓸 수 있나요?
기존 업체가 자체개발 방식의 공동 사용을 지원하는지 먼저 확인해요. 쿠팡은 연동업체와 자체개발을 동시에 등록할 수 없어요. 함께 쓰려면 자체개발 방식으로 제디와 기존 업체의 서버 IP를 모두 넣어야 해요. 자체개발로 바꿀 때 기존 업체의 IP가 빠져 있으면 그쪽 연동이 멈춰요. 변경 전에 기존 업체에 쿠팡 키 발급 화면에 넣을 서버 IP를 꼭 물어봐 주세요. IP를 알려 주지 않는 업체라면 함께 쓰기 어려워요.
처음 키를 발급하면 바로 쓸 수 있나요?
키 발급과 실제 접근 권한 반영 시점이 다를 수 있어요. 쿠팡은 최초 접근 권한에 24시간 이상 걸릴 수도 있다고 안내해요. 연결 정보와 IP 주소 칸을 확인하고 반영 후 지금 확인하기로 수집을 확인해 주세요.
키는 언제 다시 발급하나요?
쿠팡 오픈API 키는 발급 후 180일간 유효해요. 만료 14일 전부터 WING에서 재발급할 수 있고 쿠팡이 만료 2주 전과 1주 전에 판매자 이메일로 알려 줘요. 재발급하면 시크릿 키가 새로 만들어지고 이전 값은 바로 쓸 수 없어요. 화면의 액세스 키와 시크릿 키를 확인해 제디와 다른 솔루션에 다시 입력해 주세요.
업체코드와 답변 작성자 아이디는 같은 값인가요?
달라요. 업체코드는 판매 업체를 식별하는 값이에요. 답변 작성자 칸에는 WING 로그인 아이디를 입력해요. 문의 수집이 되더라도 작성자 아이디가 틀리면 답변을 보내지 못할 수 있어요.
쿠팡 문의는 얼마나 빨리 답해야 하나요?
쿠팡은 상품 문의에 24시간 안에 답했는지를 판매자 점수에 반영해요. 주말과 공휴일, 판매자 휴무일은 계산에서 빠져요. 제디가 준비한 답변을 확인하고 보내면 응대 시간을 줄일 수 있어요.
제디 서버 IP는 어디서 확인하나요?
제디에 로그인해 판매 채널 연동에서 쿠팡의 연결하기를 누르면 입력칸 위에 보여요. 이미 연결했다면 연결 정보 변경을 누르면 같은 자리에 보여요. 고객센터([email protected])로 요청해도 돼요.
쿠팡 고객센터에서 온 처리 요청도 답변하나요?
고객 상품 문의는 제디 문의함에서 답변해요. 쿠팡 고객센터에서 전달한 처리 요청은 판매처 요청에서 확인하고 WING으로 이동해 처리해요.
공식 문서
설정 화면이나 정책의 최신 안내는 아래 공식 문서에서 확인할 수 있어요. 이 가이드는 공식 문서와 실제 설정 화면 안내를 함께 확인해 관리해요.
반복 문의는 AI 직원에게 맡기고
매장 운영에 집중하세요.
제디 에이전트는 쇼핑몰 운영자를 위한 CS 전용 AI 에이전트예요. 여러 판매 채널의 문의를 한 화면에 모으고 우리 매장 기준과 말투에 맞는 답변 초안을 미리 써 둬요.
검토하고 보내기만 하면 돼요.