Shopify

Clodix는 아티클을 Shopify 스토어의 블로그에 바로 게시해요. Shopify는 더 이상 미리 만들어진 액세스 키를 발급하지 않으므로, 내 Shopify 개발자 계정에서 작은 앱을 만들고 그 자격 증명을 Clodix에 전달해야 해요. Shopify의 승인은 필요 없고 약 5분이면 끝나요.

앱 만들기

1. dev.shopify.com으로 이동해 앱을 열거나 새로 만드세요.
2. 앱 설정에서 다음과 같이 지정하세요.
   • App URL을 https://www.clodix.ai로 설정하세요. Shopify가 이 항목을 필수로 요구하지만, 내 스토어를 가리키면 안 돼요.
   • Embed app in Shopify admin — off로 끄세요.
   • Use legacy install flow — off로 끄세요.
3. API access에서 Select scopes를 클릭하고 "content"를 검색한 다음 read_content와 write_content를 체크하세요. Optional scopes는 비워 두세요.
4. Shopify는 설정을 버전으로 저장해요. 변경한 뒤에는 새 버전을 만들고 Release를 클릭하세요. 그러기 전까지는 이전 버전이 계속 실행돼요.

스토어에 설치하기

1. Install app을 클릭하고 스토어를 선택하세요.
2. Shopify가 권한 화면을 보여 주면 Install을 클릭하세요.
   • 대신 아무 일도 없이 스토어 홈페이지로 돌아간다면 위 4단계의 새 버전이 아직 Release되지 않은 거예요. 돌아가서 Release하세요.
3. 앱을 열고 Credentials에서 Client ID와 Client Secret을 복사하세요.

Clodix에서 연결하기

1. Settings → Publishing integrations를 열고 Shopify를 클릭하세요.
2. 다음을 입력하세요.
   • Store URL — Shopify에 로그인할 때 쓰는 주소예요. 예: mystore.myshopify.com(잘 모르겠다면 Shopify의 Settings → Domains에서 확인하세요. 스토어프론트 주소와는 달라요).
   • Client ID와 Client Secret — 방금 만든 앱에서 가져온 값.
3. Connect to Shopify를 클릭하세요.

게시된 포스트는 이렇게 보여요

• 아티클이 스토어의 첫 번째 블로그에 만들어져 바로 게시되며, 제목, 본문, 메타 요약이 함께 들어가요.
• 커버 이미지는 아티클의 이미지로 설정되고, 기술적인 .myshopify.com 주소가 아니라 사이트 자체 도메인에서 불러와요. 그래서 아티클 사이의 링크가 실제 도메인에 유지돼요.
• 나중에 아티클을 수정하고 다시 게시하면 같은 Shopify 아티클이 업데이트돼요. Clodix는 사본을 따로 만들지 않아요.
• Unpublish를 하면 Shopify에서 아티클이 게시되지 않음(초안) 상태로 되돌아가요.

자주 발생하는 문제

Connect가 실패하면 폼 아래의 메시지가 문제를 알려 줘요. 아래에서 찾아보세요.

스토어프론트 주소를 입력했어요

You see: "That is your storefront address — we need the admin one" 또는 "Store URL should look like mystore.myshopify.com".

관리자 주소가 아니라 스토어의 공개 도메인(예: mystore.com)을 입력했어요. .myshopify.com으로 끝나는 주소를 사용하세요. Shopify의 Settings → Domains에서 찾을 수 있어요.

이 주소에 Shopify 스토어가 없어요

You see: "There is no Shopify store at …".

Store URL이 어떤 스토어도 가리키지 않아요. 대개 오타이거나 스토어프론트 주소로 짐작해서 적은 이름이에요. 관리자 링크에서 이름을 가져오세요. admin.shopify.com/store/NAME은 NAME.myshopify.com을 의미해요.

Shopify가 Client ID와 Client Secret을 인식하지 못해요

You see: "Shopify does not accept this Client ID and Client Secret".

다른 앱의 값이거나, 복사한 뒤에 시크릿이 재생성되었어요. dev.shopify.com에서 같은 앱의 Credentials를 열어 두 값을 다시 복사하세요.

스토어에 앱이 설치되지 않았어요

You see: "The app is not installed on … yet".

앱은 만들었지만 스토어에 설치하지 않았어요. dev.shopify.com에서 Install app을 클릭하고 스토어를 선택한 다음 권한 화면을 마무리하세요.

Shopify가 앱을 찾을 수 없어요

You see: "Shopify cannot find this app".

개발자 계정에서 앱이 삭제되었어요. 앱을 다시 만들고, 스토어에 설치한 다음 새 Client ID와 Client Secret으로 연결하세요.

아티클 게시가 "applicationcannotbe_found"로 실패하나요? 원인은 같고 나중에 발견된 경우예요. Shopify를 연결한 뒤에 앱이 삭제되었거나 다시 만들어져서 Clodix가 가진 키가 더 이상 어디에도 맞지 않아요. 아티클은 초안으로 남아 있어요. Manage → Disconnect를 누르고, 앱을 다시 만든 다음 새 키로 연결하고, 초안에서 Publish를 누르세요.

앱이 다른 Shopify 계정에 속해 있어요

You see: "This app belongs to a different Shopify account".

스토어를 소유한 계정이 아닌 다른 Shopify 계정으로 앱을 만들었어요. 스토어를 소유한 계정으로 dev.shopify.com에 로그인한 상태에서 앱을 다시 만드세요.

앱에 content 권한이 없어요

You see: "The app is missing the content permissions".

앱이 블로그 콘텐츠에 접근할 수 없어요. 앱의 API access → Select scopes에서 read_content와 write_content를 체크한 다음 새 버전을 만들고 Release를 클릭하세요.

스토어에 아직 블로그가 없어요

You see: "This store has no blog yet".

게시할 블로그가 없어요. Shopify의 Content → Blog posts에서 블로그를 만든 다음 다시 연결하세요.

Shopify가 응답하지 않았어요

You see: "Shopify did not answer — try again in a few minutes".

Shopify가 응답하지 않은 것이며, 입력한 정보에는 문제가 없어요. 몇 분 기다렸다가 Connect를 다시 누르세요.

Install 후에 문서 예시용이라는 페이지가 나와요

Install을 클릭했더니 "This domain is for use in documentation examples"라는 페이지가 나와요. 문제가 있는 것이 아니에요. 임시로 넣은 App URL일 뿐이고 앱은 설치된 상태예요. dev.shopify.com → 내 앱 → Credentials로 돌아가 Client ID와 Client Secret을 복사하고 Clodix에서 연결하세요.

배포 방식이 없어서 앱을 설치할 수 없어요

You see: "This app can't be installed yet — the developer needs to select a distribution method".

이미 막혀 있는 이전 설치 경로를 사용했어요. 이 페이지의 단계를 처음부터 따라 하세요. Dev Dashboard에서 앱을 만들고, 스코프를 설정하고, 버전을 Release한 다음 Install app을 클릭하세요.

Install을 누르면 스토어 홈페이지로 이동해요

Install을 클릭하면 스토어 홈페이지로 이동하고 아무것도 설치되지 않아요. 앱 설정이 여전히 레거시 설치 흐름을 사용하거나, App URL이 내 스토어 주소로 되어 있어요. 앱의 Versions → Create version에서 Use legacy install flow를 끄고, App URL을 스토어프론트 주소가 아닌 아무 주소로 설정하세요(https://www.clodix.ai면 돼요). 그런 다음 Release하고 Install app을 다시 클릭하세요.

앱을 설치했는데 Clodix에는 여전히 Connect가 표시돼요

스토어에 앱을 설치하는 것은 앱에 권한을 부여할 뿐이고, 실제 연결은 Clodix에서 이뤄져요. dev.shopify.com에서 앱을 열고 Credentials에서 Client ID와 Client Secret을 복사한 다음, Clodix의 Settings → Publishing integrations → Shopify에서 .myshopify.com 주소와 함께 붙여 넣으세요.

Scopes 입력란이 비어 있어요

새 앱에는 스코프가 없어요. 앱의 버전 설정에서 Scopes에 read_content,write_content를 입력하세요(쉼표로 구분, 공백 없음). 또는 Select scopes를 사용해 "content"를 검색하고 두 항목을 체크하세요. 그런 다음 버전을 Release하고 다시 설치하세요.

FAQ

Clodix를 사용하려면 Shopify의 승인이 필요한가요?

아니요. 앱은 내 Shopify 개발자 계정에 있고 내 스토어에만 설치되므로 Shopify의 검토 단계는 없어요.

예전처럼 액세스 토큰을 그냥 붙여 넣을 수는 없나요?

Shopify가 커스텀 앱용 미리 생성된 액세스 토큰을 폐지했어요. 지금 만드는 Client ID / Client Secret 쌍은 Clodix가 게시할 때마다 새 토큰을 자동으로 발급해요. 연결한 뒤에는 다시 손댈 필요가 없어요.

스토어의 테마나 체크아웃에 영향을 주나요?

아니요. 앱의 권한은 블로그 콘텐츠를 읽고 쓰는 것(read_content, write_content)으로 제한돼요. 상품, 주문, 테마, 체크아웃에는 접근할 수 없어요.

관련 문서

• 웹사이트 연결하기
• 게시 문제
• 아티클 게시하기