WP-Flow 오류가 났을 때

압축을 푼 폴더가 어디에 있는지 확인해주세요. 아래 위치에 두시면 안 됩니다.

• 바탕화면 · 문서 · 사진 폴더 — 요즘 윈도우는 이 폴더들을 OneDrive가 자동으로 관리합니다
• 경로에 OneDrive가 들어간 모든 폴더

OneDrive는 한동안 안 쓴 파일을 컴퓨터에서 지우고 클라우드에만 남겨둡니다. 그러면 크롬이 확장 파일을 못 읽어서 잘 쓰던 확장이 갑자기 사라지거나 오류가 납니다.
해결 방법 — C:\EonsFlow\WP-Flow처럼 C 드라이브 바로 아래에 폴더를 새로 만들어 그 안에 압축을 풀고, chrome://extensions에서 [압축해제된 확장 프로그램을 로드]로 다시 등록해주세요.
한 번 옮겨두시면 다시 사라지지 않습니다. 이 문제로 문의 주시는 분이 가장 많습니다.

크롬 버전이 낮은 것입니다. WP-Flow가 쓰는 사이드패널 기능은 크롬 114 버전 이상에서만 동작합니다.
설치 자체는 되기 때문에 고장난 것처럼 보이지만 버전 문제입니다.

• 크롬 오른쪽 위 점 세 개 → 도움말 → Chrome 정보
• 버전 숫자를 확인하고, 업데이트가 있으면 받은 뒤 [다시 실행]
• 크롬을 다시 켠 뒤 확장을 실행해보세요

회사 컴퓨터라 업데이트가 막혀 있다면 관리자에게 요청하셔야 합니다.
엣지·웨일·파이어폭스에서는 동작하지 않습니다. 크롬에서 사용해주세요.

백신이 파일을 지운 것입니다. 확장 파일 중 일부를 위험한 것으로 잘못 판단하는 백신이 있습니다. 실제로 문제가 있는 파일은 아닙니다.

• 백신의 격리 보관함(검역소)을 확인하시고, 있으면 복원해주세요
• 압축을 풀 폴더를 백신의 예외(제외) 목록에 추가한 뒤 다시 풀어주세요
• 급하시면 백신 실시간 감시를 잠시 끄고 압축을 푼 뒤 다시 켜셔도 됩니다

파일이 몇 개 빠진 채로 압축이 풀리면 확장이 등록은 되는데 실행 중에 이상하게 동작합니다. 이 경우 폴더를 통째로 지우고 처음부터 다시 풀어주세요.

완료 (안전모드: 발행 직전 정지) 고장이 아닙니다. 일부러 멈춘 것입니다.
안전모드가 켜져 있으면 발행 직전까지만 하고 실제로는 올리지 않습니다. 처음 쓰실 때 실수로 발행되는 것을 막기 위한 기능입니다.
실제로 올리시려면 [안전 모드] 체크를 끄고 다시 발행해주세요.
"다 됐다고 나오는데 블로그에 글이 없다"는 문의의 대부분이 이것입니다.

블로그 주소 '○○'가 올바르지 않습니다 — 표시명이 아니라 주소 앞부분(영문).
예: dword25.tistory.com → dword25 블로그 이름(표시명)이 아니라 주소의 영문 부분을 넣으셔야 합니다.
블로그 주소가 dword25.tistory.com이면 dword25만 넣으시면 됩니다. 한글 블로그 이름을 넣으면 안 됩니다.
주소창을 보시고 .tistory.com 앞부분만 복사해 넣어주세요.

선택한 블로그 '○○'의 에디터를 찾지 못했습니다. 지금 열려 있는 에디터는 '△△'입니다 다른 블로그의 글쓰기 창이 열려 있는 것입니다. 엉뚱한 블로그에 글이 올라가는 것을 막기 위해 멈춥니다.
열려 있는 △△ 블로그 탭을 닫으시거나, 올리려는 블로그의 글쓰기 화면을 열고 다시 실행해주세요.

발행 실패: 아이디 또는 앱 비밀번호가 틀렸습니다. ...
이미지 업로드 실패 — 파일이 너무 큽니다 ... 워드프레스가 돌려준 응답 코드에 따라 아래 안내가 붙습니다.

• 401 — 아이디나 앱 비밀번호가 틀렸습니다. 로그인 비밀번호가 아니라 [애플리케이션 비밀번호]를 띄어쓰기까지 그대로 넣으셔야 합니다
• 403 — 그 계정에 권한이 없거나(관리자 계정의 앱 비밀번호를 쓰세요), 보안 플러그인(Wordfence·SiteGuard 등)이 /wp-json/을 막은 것입니다. 해당 플러그인에서 REST API 차단을 해제해주세요
• 404 — 주소 오타이거나 고유주소 문제입니다. 관리자 → 설정 → 고유주소에서 아무것도 바꾸지 말고 [변경사항 저장]만 눌러보세요
• 413 — 이미지가 호스팅 업로드 한도를 넘었습니다
• 429 — 너무 많이 보냈습니다. 잠시 후 다시 하세요
• 500 · 502 · 503 — 워드프레스 서버 쪽 문제입니다. 잠시 뒤 재시도해주세요

확장이 응답하지 않습니다. 확장을 새로 로드한 뒤 다시 시도하세요.
content script 응답 없음 (페이지 로드 확인·F5). 확장이나 페이지가 잠들었거나 제대로 안 붙은 상태입니다. 순서대로 해보세요.

• 워드프레스 글쓰기 탭에서 F5(새로고침)
• 그래도 안 되면 주소창에 chrome://extensions 입력 → WP-Flow의 새로고침 아이콘 클릭
• 크롬을 완전히 껐다 켜기

크롬을 오래 켜두셨을 때 자주 납니다.

연결 실패 — 접근 실패 (HTTP 404) — 블로그 주소를 확인하세요. 그 주소의 블로그에 들어가지 못한 것입니다. 블로그 주소를 다시 확인해주세요.
내 블로그가 맞는지도 확인해주세요. 로그인한 계정이 소유하지 않은 블로그는 접근할 수 없습니다.

API 키 없음 — 설정 탭에 google API 키를 입력하세요. 고르신 모델과 넣으신 키가 맞지 않는 경우가 가장 많습니다.

• Gemini를 고르셨으면 구글 키
• GPT를 고르셨으면 OpenAI 키
• 니즈 조사·주제 찾기는 별도로 OpenRouter 키(sk-or-v1-로 시작)

키를 넣고 저장까지 누르셔야 반영됩니다. 앞뒤 공백이 붙지 않았는지도 확인해주세요.

크레딧 부족(402) — OpenRouter 충전 필요
키 무효(401/403)
요청 한도 초과(429)

• 402 — OpenRouter 잔액이 없습니다. 충전해주세요
• 401 · 403 — 키가 틀렸거나 만료됐습니다. 다시 발급받아 넣어주세요
• 429 — 짧은 시간에 너무 많이 보냈습니다. 잠시 후 다시 하세요

다건 발행 중이라면 멈추지 않고 계속 진행됩니다. 니즈 조사만 건너뛰고 제목 기반으로 글을 씁니다. 키를 고치고 설정을 저장하면 다시 정상 동작합니다.

빈 응답 (2회 시도) — 모델을 바꾸거나 잠시 후 다시 시도하세요.
응답 시간 초과 (180초) — 네트워크·방화벽·백신을 확인하세요. 빈 응답 — AI가 글을 안 내놓은 경우입니다. 모델을 다른 것으로 바꿔서 다시 해보세요. Gemini Flash에서 가끔 납니다.
시간 초과 — 3분을 기다려도 답이 없는 경우입니다. 인터넷 상태를 확인하시고, 회사 네트워크나 백신이 막는지도 봐주세요.

재료 부족 — 제목/주제, 메인 키워드, 참고 글, 유튜브 URL, 상품 키워드 중 하나를 채우세요. 무엇에 대해 쓸지가 하나도 없는 상태입니다. 다섯 칸 중 하나만 채우시면 됩니다.
가장 간단한 건 제목/주제 칸에 쓰고 싶은 주제를 적는 것입니다.

참고 글을 읽지 못했습니다 — URL을 확인하세요.
본문을 읽지 못했습니다 (비공개 글이거나 로그인이 필요한 페이지일 수 있음) 참고 글 주소를 넣으셨는데 내용을 못 가져온 것입니다. 이때는 일부러 생성을 멈춥니다.
참고 글이 빠진 채로 쓰면 같은 이름의 다른 사람·다른 제품 정보가 섞이는 일이 실제로 있었기 때문입니다.

• 그 주소를 시크릿 창에서 열어보세요. 안 열리면 비공개 글이라 읽을 수 없습니다
• 참고 글 없이 쓰시려면 그 칸을 비우고 다시 생성하시면 됩니다

이 영상에 자막이 없습니다. 자막 있는 영상으로 시도하세요.
유효한 유튜브 URL이 아닙니다. WP-Flow는 영상의 자막을 읽어서 재료로 씁니다. 자막이 없는 영상은 사용할 수 없습니다.
유튜브에서 영상을 열고 [CC] 자막 버튼이 있는지 확인해보세요. 자동 생성 자막도 괜찮습니다.

경험 은행이 비어 있습니다 — [경험 인터뷰]를 먼저 진행하거나 승인 모드를 끄세요. 애드센스 승인 모드는 고객님의 실제 경험을 재료로 글을 씁니다. 그래서 경험이 없으면 시작할 수 없습니다.
[경험 인터뷰]를 한 번만 진행하시면 이후 글에는 자동으로 반영됩니다.
경험 없이 그냥 쓰시려면 승인 모드 체크를 끄고 생성하시면 됩니다.

GPT 이미지 실패(...) → "○○" 소제목은 이미지 없이 갑니다. [다시 만들기]로 다시 시도하세요
카드 생성 실패(스킵): ... 글은 정상 발행됩니다. 그 이미지만 빠집니다.
이미지를 만들거나 올리지 못하면 그 소제목만 이미지 없이 넘어갑니다.
이미지가 꼭 필요하시면 미리보기에서 그 이미지를 눌러 [다시 만들기]로 다시 시도하시거나, 발행 후 직접 넣어주세요.

썸네일 배경 이미지 실패(단색 배경으로 대체): ...
대표 썸네일 생성 실패(썸네일 없이 진행): ... 단색 배경으로 대체는 썸네일이 만들어지긴 한 것입니다. 배경 그림만 빠지고 글자는 들어갑니다. 그대로 쓰셔도 됩니다. 설정 탭에 OpenAI API Key가 없으면 GPT 이미지 배경을 만들 수 없어 처음부터 단색 배경으로 만듭니다.
썸네일 없이 진행은 아예 못 만든 경우입니다. 글생성 탭에서 [썸네일 미리보기]를 다시 눌러 시도해보세요.

발행 실패: 발행 버튼을 찾지 못했습니다
발행 실패: 발행 패널 버튼 미발견 워드프레스 편집기에서 눌러야 할 버튼을 못 찾은 것입니다. 아래 순서로 해보세요.

• 워드프레스 글쓰기 탭을 새로고침(F5)하고 다시 실행
• 발행 중에 그 탭을 만지거나 다른 창을 띄우지 마세요
• 보안문자가 떠 있는지 확인해주세요. 떠 있으면 버튼이 가려집니다

워드프레스가 화면을 바꾼 경우일 수도 있습니다. 계속 같은 자리에서 멈추면 알려주시면 확인해 드리겠습니다. 그동안은 원고를 복사해 수동 발행하시면 됩니다.

캡차 풀이 실패: ... 워드프레스가 보안문자를 띄운 것입니다.
설정에 2Captcha 키를 넣으셨다면 자동으로 풀리는데, 실패하면 이 문구가 나옵니다. 편집기 창에서 직접 입력해주세요.
키를 안 넣으셨다면 자동 풀이를 시도하지 않습니다. 보안문자가 뜨면 발행 버튼만 눌리지 않은 채 멈출 수 있으니, 발행이 이유 없이 안 되면 편집기 화면을 확인해보세요.

경고: 태그 입력창을 못 찾음 — 태그 없이 발행됩니다 글은 정상 발행됩니다. 태그만 빠집니다.
발행 후 워드프레스에서 직접 태그를 추가해주시면 됩니다.

예약하려면 예약 체크 후 날짜/시간을 입력하세요. [예약] 체크박스를 먼저 켜고 날짜와 시간을 넣어주세요.
예약 시간은 현재보다 최소 10분 이후로 잡으셔야 합니다. 지난 시간을 넣으면 즉시 발행될 수 있습니다.

본문이 비어 있습니다.
제목이 비어 있습니다.
이미 발행이 진행 중입니다. 비어 있음 — 원고 생성이 실패했는데 발행을 누르신 경우입니다. 원고부터 다시 만들어주세요.
이미 진행 중 — 앞선 발행이 안 끝났습니다. 완료될 때까지 기다려주세요. 두 번 누르면 글이 두 개 올라갈 수 있어 막아둔 것입니다.

라이선스 이메일 미입력 — 설정 탭에서 승인 이메일을 등록하세요.
라이선스 미승인/차단 — 발행 불가. 관리자 승인 후 이용하세요.
라이선스 서버 확인 실패(네트워크) — 발행 중단.

• 미입력 — 설정 탭에 구매하신 이메일을 넣고 저장해주세요
• 미승인 — 아직 승인 전입니다. 승인 후 이용 가능하며, 오래 걸리면 카카오톡 'eonsflow' 채널로 문의해주세요
• 서버 확인 실패 — 인터넷 연결 문제입니다. 연결을 확인하고 다시 시도해주세요. 회사 네트워크라면 휴대폰 핫스팟으로 시도해보세요

대부분은 해결되지 않습니다. 로그인이나 발행 실패는 워드프레스 쪽 상태나 설정 문제라서 다시 설치해도 그대로입니다.
오히려 설정과 API 키가 지워집니다.
먼저 chrome://extensions에서 새로고침 아이콘만 눌러보세요. 이것으로 해결되는 경우가 많습니다.
새 버전이 나와서 저희가 안내드린 경우에만 다시 받으시면 됩니다.