도움말

문제 해결

게시 문제

최종 업데이트:

증상과 원인별, 플랫폼별 게시 문제 해결 — 연결되지 않음, 만료된 자격 증명, 자동 게시 실패, 시간 초과를 다뤄요.

아티클이 게시되지 않거나, 예상하지 못한 곳에 게시됐다면 여기서 시작하세요.

시간 초과된 게시를 다시 시도하기 전에

게시가 시간 초과된 것처럼 보이거나 페이지에 확인 메시지가 뜨지 않았다면, Publish를 다시 누르기 전에 사이트를 먼저 확인하세요. Clodix가 응답을 기다리기를 멈춘 뒤에도 요청이 플랫폼 쪽에서는 계속 처리되어 완료될 수 있어요. 바로 다시 시도하면 같은 아티클이 두 개 게시될 수 있어요. 먼저 사이트(또는 플랫폼의 게시물 목록)를 열어보세요. 게시물이 이미 있다면 끝난 거예요. 없다면 다시 시도해도 안전해요.

"Your site isn't connected for one-click publishing"

원인: 이 사이트에 연결된 게시 플랫폼이 아직 없어요.

해결 방법: Settings → Publishing integrations로 이동해 플랫폼을 연결하세요. 그동안은 아티클을 열고 Export 상자의 Copy with formatting을 사용해 사이트의 에디터에 붙여넣은 다음, 돌아와서 Mark as published를 눌러주세요. 그러면 이후 아티클이 이 아티클로 링크할 수 있어요.

"Auto-publish didn't go through"

원인: Publish articles automatically가 켜져 있고(Brand DNA → Autopilot) 예약된 게시가 실패했을 때 표시돼요. 사이트가 시간 초과나 짧은 장애 같은 일시적인 응답을 보내면 Clodix가 자동으로 재시도해요. 첫 시도 이후 약 10시간 동안 총 네 번 시도하며, 대략 1시간, 4시간, 10시간 뒤에 다시 시도해요. 모든 시도가 실패하면 아티클은 Draft로 돌아가고, 에디터에 사이트가 응답한 내용이 그대로 표시돼요.

해결 방법:

  1. 안내 상자에 인용된 응답을 읽어보세요. 일반적인 문구가 아니라 사이트 자체의 오류 메시지예요.
  2. Settings → Publishing integrations에서 연결 상태를 확인하고, Not active로 표시되면 다시 연결하세요.
  3. 문제를 해결했다면 아티클에서 직접 Publish를 누르세요. 자동 게시는 Draft로 돌아간 아티클을 스스로 다시 시도하지 않아요.

"The operation was aborted due to a timeout"

Clodix는 사이트가 게시물을 받을 때까지 약 30초를 기다려요. 이 메시지는 사이트가 시간 안에 응답하지 않았다는 뜻이에요. 사이트가 다운되었거나, 매우 느리거나, 보호 장치(방화벽이나 봇 차단 플러그인)가 요청을 붙잡았을 수 있어요. 사이트가 정상적으로 열리는지 확인하고, 게시물이 실제로는 등록됐을 수도 있으니 게시물 목록도 살펴보세요(시간 초과된 게시를 다시 시도하기 전에 참고). 게시물이 없고 사이트도 정상이라면, 호스팅 지원팀에 Clodix가 사이트의 API에 접근할 수 있게 허용해 달라고 요청한 뒤(WordPress에서는 /wp-json/, user agent는 Clodix/1.0) 아티클에서 Publish를 다시 누르세요.

아티클은 작성됐는데 사이트에 올라가지 않아요

아티클이 계속 생성되고 있고(Articles에서 볼 수 있어요) 초안 상태로만 남아 웹사이트에는 나타나지 않는 경우예요. 이유는 두 가지가 있어요.

  1. 게시용으로 연결된 사이트가 없어요. 보낼 곳이 없으면 완성된 아티클은 초안으로 남고, Publish를 누르면 "Your site isn't connected for one-click publishing…"이라고 답해요. Generate articles automatically가 켜져 있어도 마찬가지예요. Clodix는 계속 글을 쓰지만, 글쓰기에는 연결된 사이트가 필요하지 않고 게시에는 필요하기 때문이에요. Settings → Publishing integrations에서 플랫폼을 연결하세요. 목록에 플랫폼이 없다면 Other platform 타일을 사용하고, 그동안은 에디터의 Export 상자에 있는 Copy with formatting으로 아티클을 복사해 가세요.
  2. 사이트는 연결되어 있지만 자동 게시가 꺼져 있어요. 이 경우 모든 아티클이 에디터에서 Publish를 누르기를 기다려요. 아티클을 하나씩 먼저 검토하고 싶다면 좋은 설정이에요. 완전히 자동으로 하려면 Brand DNA → Autopilot을 열고 Publish articles automatically를 켜세요. 그러면 새 아티클이 계획된 날짜에 게시돼요. 이미 초안으로 대기 중인 아티클은 각각의 Publish 버튼으로 게시할 수 있어요.

"아티클을 게시됨으로 표시했는데 사이트에 없어요"

Mark as published는 사이트로 아무것도 보내지 않아요. 아티클을 직접 게시했다는 사실과 그 위치를 기록할 뿐이에요. 아티클을 직접 붙여넣는 사람들을 위한 기능이에요. 아티클을 웹사이트로 보내는 것은 Publish 버튼이고, 연결된 사이트가 있어야 해요.

열리지 않는 링크로 실수로 표시했다면 그 아티클은 실제로 게시된 것이 아니에요. 사이트를 연결하고 Publish를 누르거나, 아티클을 사이트에 직접 붙여넣은 뒤 실제 주소로 표시하세요. Mark as published를 참고하세요.

"게시된 아티클을 수정했는데 사이트에는 예전 텍스트가 보여요"

게시된 아티클을 수정했을 때 일어나는 일은 플랫폼에 따라 달라요. WordPress, Shopify, Ghost, HubSpot, FTP에서는 변경 사항을 저장한 다음 에디터 헤더의 Update on site를 누르세요. 그러면 사이트의 게시물이 교체돼요(사이트에서 직접 한 수정은 덮어써져요). 위젯이나 RSS 피드에서는 새 버전이 약 5분 안에 저절로 나타나요. Wix와 webhook, 그리고 직접 게시한 아티클은 Clodix가 게시된 글을 바꿀 수 없으니 사이트의 에디터에서 수정하세요. 전체 표는 아티클 수정에 있어요.

"내 플랫폼이 목록에 없어요" / "사이트 빌더에 자체 블로그가 있어요"

Settings → Publishing integrations에서 Other platform 타일을 클릭하고 사이트가 어떤 플랫폼으로 운영되는지 알려주세요. 그 플랫폼에 게시하는 가장 좋은 방법을 안내해 드릴게요. 그동안 멈추는 것은 없어요. 아티클은 계속 작성되고, Copy with formatting으로 원하는 아티클을 직접 게시할 수 있어요.

게시 연결이 없는 웹사이트 빌더(Webflow, Squarespace, BigCommerce, Duda 등)에서는 HTML 위젯이 코드를 붙여넣은 페이지에 아티클을 보여줘요. 빌더 자체 블로그 섹션 안에 게시물을 만들지는 않아요. 그러니 기본 /blog/에 아티클이 나타나길 기대한다면 대신 직접 복사해서 넣으세요.

사이트가 폐쇄형 빌더이거나 HTML 페이지 하나이거나 다른 사람이 운영해요

일부 사이트 빌더(예: Hostinger Website Builder, Tilda, Tertulia for Authors)는 외부 도구의 게시물을 받지 않아서 Clodix가 블로그에 게시할 수 없어요. 방법은 두 가지예요. 에디터에서 아티클을 하나씩 복사(Copy with formatting)해 빌더의 블로그에 넣고 Mark as published로 표시하거나, 빌더에서 페이지에 직접 만든 코드를 추가할 수 있다면 HTML 위젯을 사용하세요. 위젯이 그 페이지에 아티클 목록을 자동으로 보여줘요. 직접 작성한 HTML 페이지 하나로 된 사이트(예: CMS 없는 Netlify)도 마찬가지예요. 위젯 코드를 페이지의 HTML에 한 번 붙여넣고 사이트를 다시 업로드하세요. "Hostinger"는 두 가지를 뜻할 수 있어요. Hostinger 호스팅의 WordPress는 정상적으로 연결되고(WordPress), Hostinger 자체의 Website Builder는 폐쇄형 빌더예요.

다른 사람이 사이트를 관리한다면 Settings → Publishing integrations → HTML widget의 위젯 코드를 전달하세요. 한 번만 추가하면 돼요. 아무도 할 수 없다면 support@clodix.ai로 사이트가 어떤 플랫폼으로 운영되는지 알려주세요.

"아티클은 게시됐는데 커버 이미지가 없어요"

아티클의 Featured image 상자에 "Image generation is temporarily unavailable on our side — please try again later."라고 표시된다면, 커버가 필요한 시점에 Clodix의 이미지 서비스를 사용할 수 없었던 거예요. 크레딧이나 설정 문제가 아니고, 아티클 자체는 정상적으로 게시됐어요. 커버는 선택이라서 커버 없이 게시돼요.

해결 방법: 나중에 다시 시도하세요. 아티클을 열고 SEO Settings → Featured image → Generate를 누르세요. 커버가 없는 아티클의 첫 커버는 무료이고, 실패한 시도에는 비용이 들지 않아요. 아티클이 이미 게시된 상태라면 커버가 웹사이트에 반영되도록 그 뒤에 Update on site를 누르세요. 다른 커버 관련 메시지와 비용은 커버 이미지에 있어요.

"Facebook, Instagram, LinkedIn, X를 연결할 수 없어요"

해당 채널은 아직 사용할 수 없어요. Social Media 페이지에 Soon으로 표시되어 있어요. 지금은 Telegram만 실제로 게시되고, Social Media 피드에도 Telegram만 표시돼요. 다른 네트워크는 아티클의 링크와 텍스트를 복사해서 직접 게시할 수 있어요. 소셜 미디어 개요를 참고하세요.

자격 증명이 만료되었거나 변경됐어요

증상: 잘 게시되던 플랫폼이 갑자기 실패하기 시작하고, 보통 거부된 비밀번호, 토큰, 키를 언급하는 메시지가 표시돼요.

원인: 애플리케이션 비밀번호, API 키, 액세스 토큰이 플랫폼 쪽에서 변경되었거나 폐기됐어요. 비밀번호 재설정, 보안 플러그인 업데이트, 연동을 다시 만든 뒤에 자주 생겨요.

해결 방법: Settings → Publishing integrations → [platform] → Manage → Disconnect로 이동한 다음, 새 자격 증명으로 다시 연결하세요. Clodix가 실시간으로 확인하므로 양식이 통과되면 게시가 다시 정상 작동해요. 연결이 해제된 동안 잃는 것은 없어요. 연결이 복구될 때까지 아티클은 초안으로 남아요.

플랫폼별 안내

플랫폼흔한 문제확인할 곳
WordPress잘못된 사용자 이름, Application Password 대신 로그인 비밀번호 사용, 또는 호스팅이 Authorization 헤더를 제거함WordPress
Shopify잘못된 앱의 자격 증명, 앱이 설치되지 않음, 또는 스토어에 블로그가 없음Shopify
WixAPI 키에 IST. 접두어나 올바른 권한이 없음Wix
GhostAdmin API 키 대신 Content API 키를 사용함Ghost
HubSpot블로그가 없거나 블로그에 작성자가 지정되지 않음HubSpot
Webhook엔드포인트가 2xx 상태로 응답하지 않음Next.js 및 커스텀 사이트
FTP / SFTP잘못된 호스트, 포트, 자격 증명, 또는 폴더 경로FTP, SFTP 및 정적 사이트
웹사이트 빌더(위젯)위젯이 비어 보임. 단, 빌더 자체 에디터 안에서만 그래요웹사이트 빌더

"Could not save the connection" / "Could not disconnect"

원인: 자격 증명이 아니라 Clodix 쪽 문제예요. 플랫폼이 무언가를 거부한 것이 아니라, 데이터베이스에 저장하는 과정에서 일시적인 오류가 생긴 거예요.

해결 방법: 1분 뒤에 다시 시도하세요. 계속되면 고객 지원에 문의하세요.

위젯이 내 사이트에 아무것도 보여주지 않아요

대부분 다음 둘 중 하나예요.

  • 실제로 게시된 사이트가 아니라 빌더 자체의 에디터 화면을 보고 있어요. 일부 빌더는 편집하는 동안 붙여넣은 코드를 샌드박스에서 실행해요. 대신 실제 사이트를 열어보세요.
  • 아티클 목록이 정말로 비어 있어요. 아직 게시된 것이 없거나 연결한 지 얼마 안 됐어요(첫 아티클이 나타나기까지 몇 분 걸릴 수 있어요).
  • 코드가 방문자에게 보이는 페이지에 없어요(게시되지 않았거나, 코드를 제거하는 텍스트 블록에 넣었거나, 캐시된 경우). 이때 Clodix는 코드 옆에 Not found on your site yet를 표시해요.

체크리스트는 웹사이트 빌더(HTML 위젯)를 참고하세요.

자주 묻는 질문

게시했는데 사이트에 아티클이 보이지 않아요. 어떻게 하나요?

먼저 사이트를 직접 확인하세요. Clodix의 확인 응답이 느렸더라도 게시는 처리됐을 수 있어요. 정말 없다면 Settings → Publishing integrations에서 플랫폼 상태를 확인하고, 에디터의 아티클에 표시된 구체적인 오류를 살펴보세요.

실패한 게시를 다시 시도하면 크레딧이 또 차감되나요?

아니요. 크레딧이 드는 것은 아티클 작성이에요. 사이트에 다시 게시하는 것은 자동 재시도를 포함해 모두 무료예요.

플랫폼이 연결되지 않고 위의 방법도 도움이 되지 않아요. 어떻게 하나요?

Clodix에 표시된 정확한 오류 메시지를 적어 고객 지원에 문의하세요. 무슨 일이 생겼는지 가장 빠르게 파악할 수 있는 방법이에요.

관련 문서

아직 해결되지 않았나요? support@clodix.ai 주소로 문의해 주세요. 사람이 직접 답변해 드려요.

게시 문제 — Clodix 도움말