Docs

Getting Started

Core

Tutorials & Guides

تحديث صورة WhatsApp الفوري لـ WooCommerce

يعني تحديث صورة WhatsApp الفوري لـ WooCommerce أن البطاقة الصحيحة تكون جاهزة في اللحظة التي تحفظ فيها منتجًا — وليس أن 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 المخزّنة مؤقتًا لا تزال تحتوي على عنوان URL القديم og:image، لذا حتى البطاقة المُعاد بناؤها بإتقان لا يتم اكتشافها أبدًا. طهّر ذاكرة التخزين المؤقت للصفحات أولًا، ثم انظر إلى الباقي.

الصفان 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 سجل الكتالوج الخاص بالمتجر، بحيث يُستمد الغلاف التالي من البيانات الحالية.
تُوضع مهمة RefreshMetaPreview في قائمة الانتظار لعنوان URL الخاص بصفحة ذلك المنتج. تُوضع في قائمة الانتظار بدلًا من التنفيذ المباشر — إذ يجب ألا تضيف مزامنة الكتالوج الكامل استدعاءً حاجزًا واحدًا إلى Meta لكل عنصر — كما تُزال التكرارات، بحيث لا يؤدي إعادة حفظ المنتج نفسه مرارًا إلى استهلاك حد المعدل لدى Meta.
تستدعي المهمة نقطة نهاية الاستخراج (scrape endpoint) الخاصة بـ Meta باستخدام رمز وصول للتطبيق (app access token)، فتُستبدل Meta نسختها المخزّنة مؤقتًا من المعاينة لتلك الصفحة.

هذا تنفيذ على أساس بذل أقصى جهد (best-effort) بحكم التصميم. فإذا كانت Meta بطيئة أو رفضت الطلب أو فرضت حدًا للمعدل، تظل المزامنة ناجحة: فالوسم على صفحتك صحيح بالفعل، والتكلفة الوحيدة هي أن Meta تُحدّث وفق جدولها الخاص بدلًا من التحديث الفوري.

ولا يُحدّث WhatsApp أو LinkedIn أو X، لأن أياً منها لا يوفر API لتحديث أي شيء. وهذا ليس قيدًا في FastOG — بل هو غياب نقطة نهاية عند الطرف الآخر.

تحقق منه بالترتيب الصحيح

عندما لا يتم تحديث المعاينة، اتبع هذا القائمة بالترتيب بدلًا من التخمين:

bash

# 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 قبل التعديل، فلا شيء في المراحل اللاحقة سيساعد — امسح ذاكرة التخزين المؤقت للصفحة (page cache). إذا أظهرت الخطوة 1 URL جديدًا وأعادت الخطوة 2 200 OK مع image/png، فجانب المتجر صحيح وأنت تنظر إلى صف ذاكرة التخزين المؤقت رقم 2، وهو ساعة WhatsApp.

هل تريد رؤية الصفوف الأربعة كلها من الخارج؟ الصق URL المنتج في See Your Links The Way Buyers Do — فهو يجلب الصفحة بالطريقة التي يفعلها الزاحف (crawler)، ويقرأ الوسوم الحية، ويعرض النتيجة كما تُظهرها WhatsApp وX وMessenger، إلى جانب غلاف FastOG مبني من بيانات المنتج نفسها. دون تسجيل.

هل يساعد إضافة إبطال التخزين المؤقت أو `?v=2`؟

تساعد بطريقة ضيقة واحدة، والمقايضة حقيقية.

تُخزَّن المعاينة مؤقتًا مقابل الرابط الذي شاركه الأشخاص. أما الرابط الذي لم يشاركه أحد قط فليس له معاينة مخزَّنة مؤقتًا — ولهذا فإن إلحاق سلسلة استعلام متغيّرة (?v=2) حيلة شائعة إلى هذا الحد. إنها تعمل، لكنها تكلّفك: لم يعد الرابط المشارَك عنوان URL القانوني لمنتجك، وترى محركات البحث عنوانًا ثانيًا، وتنقسم حركة المرور في التحليلات.

يطبّق FastOG الآلية نفسها على مستوى أدنى، حيث تكون مجانية. يبقى عنوان URL للصفحة قانونيًا؛ ولا يتغيّر مع المحتوى سوى عنوان URL للصورة. لذا لا يمكن تقديم صورة الغلاف القديمة مرة أخرى، ويظل الرابط الذي تشاركه هو صفحة المنتج التي تريد فهرستها.

ما لا يمكن لأحد إصلاحه، ولماذا نقول ذلك

يخزّن WhatsApp المعاينة مؤقتًا في تطبيق المستلم. لا توجد واجهة برمجية (API) ولا أداة تصحيح ولا أي أداة — بما فيها أدواتنا — تستطيع الوصول إليها.
لا يوفّر LinkedIn وX أي واجهة برمجية موثّقة لإبطال الذاكرة المؤقتة برمجيًا. تعيد برامج الزحف الخاصة بهما القراءة وفق جداولها الزمنية الخاصة؛ فلا تعامل تقدير التوقيت من طرف ثالث كضمان من المنصة.
Facebook هو الاستثناء، وهو المنصة الوحيدة التي يرسل إليها FastOG طلبًا نيابةً عنك. راجع فرض تحديث ذاكرة Open Graph المؤقتة على Facebook لمعرفة الآلية.

أي مورّد يخبرك أنه يحدّث ذاكرة WhatsApp المؤقتة إنما يصف سلوك Facebook ويأمل ألا تتحقق. نحن نفضّل أن نعطيك الخريطة الدقيقة.

الأسئلة الشائعة

هل يمكنني إجبار WhatsApp على تحديث معاينة الرابط فورًا؟

لا. لا يوفّر WhatsApp أي نقطة نهاية للتحديث أو أداة تصحيح، والمعاينة المخزّنة مؤقتًا موجودة في تطبيق المستلم. كل ما يمكنك فعله هو التأكد من أن الصورة الصحيحة جاهزة عند القراءة التالية.

كم من الوقت يحتفظ WhatsApp بمعاينة الرابط؟

لا يوجد رقم منشور ولا طريقة للاستعلام عنه — فهو لكل مستلم ولكل جهاز. تعامل معه على أنه "حتى يقرر WhatsApp غير ذلك" وحسّن جانب المتجر بدلًا من ذلك.

لماذا تحدّثت عندي ولم تتحدّث عند عميلي؟

لأنك اختبرت بمشاركة رابط لم يُشارَك قط من جهازك، أو أرسلته إلى محادثة جديدة. عميلك يقرأ معاينة مخزّنة مؤقتًا. معاينته ومعاينتك مستقلتان.

هل يؤدي تغيير URL المنتج إلى فرض تحديث؟

الرابط الذي لم يشاركه أحد ليس له معاينة مخزّنة مؤقتًا، لذا نعم — على حساب عنوان ثانٍ للمنتج نفسه. تغيير URL الصورة يحقق الأثر نفسه دون المساس بالرابط الدائم (permalink)، وهو ما يفعله FastOG.

هل أحتاج إلى إضافة (plugin)، أم يمكنني تعديل القالب بنفسي؟

وجود og:image ثابت في قالبك أفضل بكثير من لا شيء، وهو مجاني. ما لا يستطيعه هو أن يختلف لكل منتج دون إنشاء صورة يدويًا لكل منتج — أو تتبّع تغيّر السعر. عند هذه النقطة تصبح الصورة الديناميكية مستحقة التكلفة.

موقعي ليس على FastOG. هل ما زال أي من هذا مفيدًا؟

نعم. الذاكرات المؤقتة الأربع وترتيب الفحص وحدود المنصات هي سلوك المنصات، وليست سلوك FastOG. اتبع القائمة باستخدام curl وأدوات التصحيح.

هل توجد خطة مجانية؟

نعم. تغطي الفئة المجتمعية المجانية (Community) حتى 100 عنصر عبر صفحات المنتجات والفئات والمتجر ومقالات المدونة، مع خمسة قوالب أساسية إضافة إلى قوالب منتجات Black Friday وSeasonal Offer. أغلفتها نظيفة — لا تحمل أي خطة علامة مائية، بما في ذلك Community. تُصيَّر Community على خادم Community المشترك وتحدّها حدود معدّل المتجر/IP بدلًا من العلامة التجارية. تستخدم الخطط المدفوعة خادمًا مخصصًا منفصلًا عن Community، وترفع حصة العناصر وتفتح قوالب وإمكانات إضافية (شارات التقييم من Starter، وربط الحقول المخصصة (metafield mapping) من Pro، والقواعد محددة النطاق والتصيير ذو الأولوية من Scale). تتضمن الخطط المدفوعة أيضًا تجربة مجانية لمدة 14 يومًا دون الحاجة إلى بطاقة ائتمان.

جرّبه مجانًا — لا حاجة للتسجيل

معاينة واختبار صور OG الديناميكية في ثوانٍ.

افتح أداة اختبار OG المجانية

الموضوع