WooCommerce용 즉시 WhatsApp 이미지 업데이트
WooCommerce용 즉시 WhatsApp 이미지 업데이트란 상품을 저장하는 순간 올바른 카드가 준비된다는 뜻이며, WhatsApp이 명령에 따라 링크를 다시 읽는다는 뜻이 아닙니다. 누구도 WhatsApp이 링크를 다시 읽도록 만들 수 없습니다. WhatsApp은 수신자의 앱에 미리보기를 캐시하며 새로고침 API를 제공하지 않습니다. 여러분이 제어할 수 있는 것은 스토어 측의 모든 요소이며, 그것만으로도 다음에 링크를 공유하는 사람이 현재의 상품, 가격, 사진을 보게 만들기에 충분합니다.
간단한 답변
WhatsApp 미리보기에는 두 개의 시계가 있으며, 그중 하나만 여러분의 것입니다.
| 시계 | 소유자 | 즉시 반영 가능 여부 |
|---|---|---|
페이지가 제공하는 og:image |
여러분(스토어) | 예 — 이 부분을 수정해야 합니다 |
| WhatsApp이 페이지를 읽고 읽은 내용을 캐싱하는 것 | WhatsApp, 수신자별 | 아니요 — API도, 디버거도, 우회 방법도 없습니다 |
두 번째 행을 무시하는 모든 "즉시 업데이트" 주장은 거짓이며, 첫 번째 행만 수정하는 모든 제품도 WhatsApp이 다시 확인하는 즉시 올바른 이미지를 표시합니다. 핵심은 바로 이것입니다. 스토어 측을 검증 가능하게 올바르게 만든 다음, WhatsApp이 협조하기를 바라는 것을 멈추십시오.
업데이트가 반영되지 않는 이유
"가격을 바꿨는데"와 "미리보기가 바뀌었다" 사이에는 네 개의 별도 캐시가 존재합니다. 판매자들은 거의 항상 잘못된 캐시를 탓합니다.
| # | 캐시 | 키 기준 | 실제로 캐시를 지우는 방법 |
|---|---|---|---|
| 1 | 스토어의 페이지 캐시 / CDN | 페이지 URL | 페이지 캐시 퍼지 |
| 2 | WhatsApp의 링크 미리보기 캐시 | 사람들이 공유한 링크 | 없음 — WhatsApp의 일정에 따라 만료됩니다 |
| 3 | WhatsApp이 보관한 이미지 바이트 사본 | 이미지 URL | 새로운 이미지 URL |
| 4 | 이미지 CDN / 렌더 캐시 | 이미지 URL | 새로운 이미지 URL, 또는 해당 캐시 퍼지 |
1번 행이 사람들이 놓치는 부분입니다. 캐시된 HTML 페이지에는 여전히 이전 og:image URL이 포함되어 있으므로, 완벽하게 다시 빌드된 카드조차 발견되지 않습니다. 먼저 페이지 캐시를 퍼지한 다음 나머지를 확인하십시오.
3번과 4번 행이 이미지 URL에 버전을 추가하는 것이 유일하게 신뢰할 수 있는 캐시 무효화 방법인 이유입니다. 새로운 이미지 URL은 모든 곳에서 동시에 캐시 미스가 발생합니다.
WooCommerce 부분: 태그는 절대 오래된 상태로 남아서는 안 됩니다
WooCommerce에서 태그 문제는 보통 두 가지 중 하나이며, 어느 쪽도 WhatsApp의 잘못이 아닙니다:
og:image가 아예 없습니다. WordPress와 WooCommerce는product,product_cat또는 상점 페이지에 대해 아무것도 출력하지 않습니다. SEO 플러그인이 하나를 제공하며, 상품의 경우 정적 대표 이미지를 가져옵니다.- 태그는 존재하지만 고정된 파일을 가리킵니다. 정적 이미지 URL은 가격이 바뀔 때 변경될 수 없습니다. 수정 후의 모든 공유는 동일한 오래된 그림을 다시 캐시합니다.
FastOG는 다른 방식을 택합니다. 커버는 서명된 URL이며, 그 쿼리에는 이를 생성한 값들이 포함되어 있고, 매 요청마다 라이브 카탈로그에서 읽어옵니다: 상품명, 현재 가격(get_price() — 할인 상품의 경우 판매 가격), 비교 표시용 "정가" 가격, 세일 배지, 평점, 재고, 상품 사진입니다.
여기에는 분명히 짚고 넘어갈 만한 결과가 따릅니다: 가격 변경은 URL 변경입니다. 이전 URL은 더 이상 상품을 설명하지 않으므로 CDN이 제공할 오래된 것이 없으며, 다음 가져오기에서 다시 렌더링됩니다. 캐시 무효화 꼼수도, "내가 퍼지했던가" 체크리스트도 필요 없습니다.
제품에서 저장을 누르면 무슨 일이 일어나는가
Facebook의 경우 — 누구나 요청할 수 있게 해주는 유일한 플랫폼 — FastOG가 대신 요청합니다:
- WooCommerce가 자체
product.updated/product.created웹훅을 발생시킵니다 (permalink는 페이로드에 있습니다). - FastOG가 해당 스토어의 카탈로그 레코드를 갱신하여, 다음 커버가 최신 데이터로 그려지도록 합니다.
- 해당 제품 페이지 URL에 대해
RefreshMetaPreview작업이 큐에 등록됩니다. 인라인으로 처리되지 않고 큐에 등록되는 이유는, 전체 카탈로그 동기화가 항목마다 Meta에 대한 블로킹 호출을 하나씩 추가해서는 안 되기 때문이며, 중복 제거되므로 같은 제품을 반복해서 다시 저장해도 Meta의 요청 한도를 소모하지 않습니다. - 해당 작업이 앱 액세스 토큰과 함께 Meta의 스크레이프 엔드포인트를 호출하고, Meta가 해당 페이지의 미리보기 캐시 사본을 교체합니다.
이는 설계상 최선 노력 방식입니다. Meta가 느리거나, 거부하거나, 요청 한도를 초과하더라도 동기화는 여전히 성공합니다: 페이지의 태그는 이미 올바르며, 유일한 비용은 Meta가 즉시가 아니라 자체 일정에 따라 갱신한다는 점뿐입니다.
WhatsApp, LinkedIn, X는 갱신하지 않습니다, 이들 중 어느 것도 무언가를 갱신할 수 있는 API를 제공하지 않기 때문입니다. 이는 FastOG의 한계가 아니라, 반대편에 엔드포인트가 존재하지 않기 때문입니다.
올바른 순서로 확인하세요
미리보기가 갱신되지 않을 때는 추측하지 말고 이 목록을 따라 내려가며 확인하세요:
# 1. Does the page still serve the OLD tag? (page cache — cache row 1)
curl -s https://your-store.com/product/example | grep -i 'og:image'
# 2. Is that image URL reachable without credentials? (cache row 3)
curl -I "https://...the-og-image-url-from-step-1..."
# 3. Did the image URL change after the edit? Compare with the URL from before.
1단계에서 여전히 수정 전 URL이 표시된다면 이후 단계는 도움이 될 수 없습니다 — 페이지 캐시를 비우세요. 1단계에서 새 URL이 표시되고 2단계가 image/png와 함께 200 OK을 반환한다면 스토어 측은 정상이며, 현재 보고 있는 것은 캐시 2번 행, 즉 WhatsApp의 시계입니다.
네 가지 행을 모두 외부에서 확인하고 싶으신가요? 상품 URL을 See Your Links The Way Buyers Do에 붙여 넣으세요 — 크롤러가 하는 방식으로 페이지를 가져와 라이브 태그를 읽고, WhatsApp, X, Messenger가 표시하는 그대로의 결과를 같은 상품 데이터로 만든 FastOG 커버 옆에 렌더링합니다. 가입은 필요 없습니다.
캐시 무효화 플러그인이나 ?v=2이 도움이 되나요?
이들은 한 가지 좁은 방식으로 도움이 되며, 그 대가도 분명히 존재합니다.
미리보기는 사람들이 공유한 링크를 기준으로 캐시됩니다. 아무도 공유한 적 없는 URL에는 캐시된 미리보기가 없습니다. 그래서 변경되는 쿼리 문자열(?v=2)을 덧붙이는 것이 흔한 방법입니다. 이 방법은 동작하지만 대가가 따릅니다. 공유된 링크가 더 이상 정규 제품 URL이 아니게 되고, 검색 엔진은 두 번째 주소를 보게 되며, 분석 데이터는 트래픽이 나뉩니다.
FastOG는 같은 메커니즘을 한 단계 아래에서 적용하며, 그 지점에서는 비용이 들지 않습니다. 페이지 URL은 정규 URL로 유지되고, 이미지 URL만 콘텐츠에 따라 변경됩니다. 따라서 이전 커버 이미지가 다시 제공될 수 없고, 공유하는 링크는 여전히 색인되기를 원하는 제품 페이지입니다.
누구도 해결할 수 없는 것, 그리고 그렇게 말하는 이유
- WhatsApp은 수신자의 앱에 미리보기를 캐시합니다. API도, 디버거도, 저희를 포함한 어떤 도구도 그 캐시에 접근할 수 없습니다.
- LinkedIn과 X 역시 문서화된 프로그래밍 방식의 무효화 API를 제공하지 않습니다. 이들의 크롤러는 자체 일정에 따라 다시 읽습니다. 제3자의 타이밍 추정치를 플랫폼의 보장으로 받아들이지 마십시오.
- Facebook은 예외이며, FastOG가 대신 핑을 보내는 유일한 플랫폼입니다. 동작 방식은 Facebook Open Graph 캐시 강제 새로고침을 참고하십시오.
WhatsApp을 새로고침한다고 말하는 업체는 Facebook의 동작을 설명하면서 여러분이 확인하지 않기를 바라는 것입니다. 저희는 차라리 정확한 지도를 건네드리겠습니다.
FAQ
WhatsApp에서 링크 미리보기를 즉시 갱신하도록 강제할 수 있나요?
아니요. WhatsApp은 갱신 엔드포인트나 디버거를 제공하지 않으며, 캐시된 미리보기는 수신자의 앱에 남아 있습니다. 다음 조회 시 올바른 이미지가 준비되어 있도록 하는 것만 가능합니다.
WhatsApp은 링크 미리보기를 얼마나 오래 보관하나요?
공개된 수치도 없고 조회할 방법도 없습니다. 수신자별, 기기별로 다릅니다. "WhatsApp이 다른 결정을 내릴 때까지"로 간주하고, 대신 스토어 쪽을 최적화하십시오.
왜 제게는 갱신되었는데 고객에게는 갱신되지 않았나요?
제 기기에서 한 번도 공유된 적 없는 링크를 공유해 테스트했거나, 새 채팅으로 보냈기 때문입니다. 고객은 캐시된 미리보기를 보고 있습니다. 고객의 미리보기와 제 미리보기는 별개입니다.
상품 URL을 변경하면 갱신이 강제되나요?
아무도 공유하지 않은 URL에는 캐시된 미리보기가 없으므로 그렇습니다. 다만 같은 상품에 두 번째 주소가 생기는 대가를 치릅니다. 이미지 URL을 변경하면 퍼머링크를 건드리지 않고도 같은 효과를 얻을 수 있으며, FastOG가 하는 방식이 바로 이것입니다.
플러그인이 필요한가요, 아니면 테마를 직접 편집할 수 있나요?
테마에 정적 og:image를 넣는 것이 아무것도 없는 것보다 훨씬 낫고, 무료입니다. 다만 상품마다 이미지를 직접 제작하지 않고서는 상품별로 다르게 할 수 없고, 가격 변경을 추적할 수도 없습니다. 바로 그 지점에서 동적 커버가 비용을 정당화합니다.
제 사이트는 FastOG를 사용하지 않습니다. 그래도 도움이 되나요?
네. 네 가지 캐시, 확인 순서, 플랫폼 제한은 FastOG의 동작 방식이 아니라 플랫폼의 동작 방식입니다. curl과 디버거로 목록을 하나씩 처리하십시오.
무료 플랜이 있나요?
네. 무료 Community 등급은 상품, 카테고리, 샵, 블로그 글 페이지에 걸쳐 최대 100개 항목을 지원하며, 다섯 가지 기본 템플릿과 Black Friday 및 Seasonal Offer 상품 템플릿을 제공합니다. 커버는 깔끔합니다. Community를 포함해 어떤 플랜에도 워터마크가 없습니다. Community는 공유 Community 서버에서 렌더링되며, 브랜딩이 아니라 스토어/IP 속도 제한으로 제약을 받습니다. 유료 플랜은 Community와 분리된 전용 서버를 사용하고, 항목 허용량을 늘리며 추가 템플릿과 기능을 해제합니다(Starter부터 평점 배지, Pro부터 메타필드 매핑, Scale부터 범위 지정 규칙과 우선 렌더링). 유료 플랜에는 신용카드가 필요 없는 14일 체험도 포함됩니다.