اربط متجر WooCommerce على ووردبريس ليُنشئ كل طلب جهة اتصال العميل أو يحدّثها، ويظهر في سجله، ويُحسب في تقارير المبيعات مع حملته. لا يُثبَّت أي شيء على المتجر: تضيف أربعة Webhooks من إعدادات WooCommerce نفسها.
في ووردبريس تفعل إضافة ووردبريس كل هذا دفعة واحدة برمز واحد: تنشئ Webhooks الأربعة وتعيد تشغيلها كل يوم، وتضيف خانة موافقة واتساب في صفحة الدفع، وتربط كل طلب بالزيارات التي سبقته. وإن كنت ربطت المتجر يدويًا من قبل تتولى الإضافة ذلك الربط وتعطيه سرها الخاص، فاحذف الـWebhooks التي أضفتها يدويًا. اتبع هذه الصفحة فقط إن أردت ربط المتجر يدويًا. واستيراد الطلبات السابقة واحد في الحالتين، كما هو موضح أدناه.
قبل أن تبدأ
- من يستطيع ذلك: مالك الشركة ومسؤولوها.
- الباقة: متاح عندما تشمل باقتك ربط المتاجر. وعدد المتاجر المربوطة النشطة حدّ من حدود الباقة.
- مسار مبيعات: يطلب الربط مرحلة. إن لم يكن في الشركة مسار بعد، فأنشئه أولًا من الفرص ثم مسارات المبيعات. راجع الفرص والمسارات.
- صلاحية في ووردبريس: مستخدم يستطيع فتح WooCommerce ثم Settings ثم Advanced.
- متجر عام يعمل عبر HTTPS: يرسل WooCommerce الـWebhooks من خادم موقعك، فيجب أن يصل الخادم إلى https://rutbacrm.com عبر HTTPS.
الخطوة 1: أنشئ الربط
- من القائمة الجانبية افتح المنتجات، ثم اضغط ربط المتاجر. إن كانت باقتك تشمل ربط المتاجر دون المنتجات، تفتح المنتجات صفحة ربط المتاجر مباشرة.
- املأ نموذج ربط متجر:
| الحقل | ما تكتبه |
|---|---|
| اسم المتجر | اسم يعرفه فريقك، حتى 120 حرفًا |
| منصة المتجر | WooCommerce (ووردبريس) |
| عملة المتجر | عملة أسعار المتجر. تُستخدم للمنتجات، ويحتفظ كل طلب بعملته |
| سر التوقيع من Shopify أو سلة | اتركه فارغًا |
| تبدأ طلبات عروض الأسعار في | أي مرحلة. لا يرسل WooCommerce طلبات عروض أسعار، فهي محفوظة للمستقبل فقط |
| إسناد الفرص الجديدة إلى | اختياري. جهات الاتصال الجديدة من المتجر تُسند إلى هذا الشخص |
- اضغط ربط متجر.
- يظهر مربع بعنوان سر التوقيع. انسخ السر الآن واحفظه في مكان آمن، فلن يظهر مرة أخرى.
- في بطاقة المتجر الجديدة انسخ العنوان في حقل العنوان الذي يرسل إليه متجرك. هذا هو عنوان التسليم.
الخطوة 2: أضف أربعة Webhooks في WooCommerce
في ووردبريس افتح WooCommerce ثم Settings ثم Advanced ثم Webhooks، واضغط Add webhook، وأنشئ أربعة بالقيم نفسها ما عدا الموضوع:
| حقل WooCommerce | القيمة |
|---|---|
| Name | أي اسم، مثل اسم الموضوع |
| Status | Active |
| Topic | واحد لكل Webhook: Order created وOrder updated وProduct created وProduct updated |
| Delivery URL | العنوان المنسوخ من العنوان الذي يرسل إليه متجرك |
| Secret | سر التوقيع من الخطوة 1 |
| API Version | WP REST API Integration v3 |
عند حفظ كل Webhook يرسل WooCommerce طلب اختبار قصيرًا، ويرد عليه رُتبة CRM دون أن يغيّر شيئًا، فيبقى الـWebhook نشطًا.
الخطوة 3: فعّل نسبة الطلبات للحملات
حتى يحمل الطلب حملته، يجب أن يسجل WooCommerce مصدر العميل. في ووردبريس افتح WooCommerce ثم Settings ثم Advanced ثم Features وفعّل Order Attribution. عندها يقرأ رُتبة CRM قيم utm_source وutm_medium وutm_campaign التي يحفظها WooCommerce مع كل طلب.
يجب أن تحمل روابط إعلاناتك utm_campaign كي تظهر الحملة باسمها، وإلا ظهر الطلب تحت مصدره أو تحت بلا حملة. ولإعلانات Google راجع Google Ads.
الخطوة 4: اختبر الربط
- افتح متجرك برابط مثل
https://YOUR_STORE/?utm_source=test&utm_medium=test&utm_campaign=crm-test. - اطلب طلبًا تجريبيًا، ويُفضل بالدفع عند الاستلام أو بوضع الاختبار في بوابة الدفع.
- في رُتبة CRM افتح جهات الاتصال وابحث عن العميل. ستجد الطلب في سجله.
- افتح ربط المتاجر. تعرض البطاقة آخر حدث: بوقت الطلب.
- غيّر حالة الطلب إلى Cancelled في WooCommerce، ثم افتح التقارير: لم يعد الطلب محسوبًا في المبيعات.
- تأكد أن الحملة
crm-testظهرت في التقارير تحت المبيعات حسب الحملة.
ما يصل وما لا يصل
| يصل | لا يصل |
|---|---|
| الطلبات الجديدة وكل تغير في حالتها | الطلبات السابقة للربط، حتى تستوردها (انظر أدناه) |
| اسم العميل وبريده وهاتفه وشركته من بيانات الفوترة | كلمات السر وبيانات البطاقات |
| بنود الطلب: SKU والاسم والكمية ومجموع البند | المخزون |
| المنتجات عند إنشائها أو تعديلها | العملاء الذين يسجلون في المتجر دون أن يطلبوا |
| مصدر الطلب ووسيطه وحملته | تكلفة الإعلانات. أضفها من Google Ads أو يدويًا |
كيف تُطابق الطلبات وتُحسب
- مطابقة العميل: البريد أولًا. إن لم تحمل أي جهة هذا البريد يُجرَّب الهاتف، لكن مع جهة لا تحمل بريدًا آخر فقط، حتى لا يُدمج شخصان يتشاركان هاتفًا. ولا تُطابق الجهات المؤرشفة. ولا يُكتب فوق اسم جهة موجودة أو بريدها أو هاتفها.
- أرقام الهواتف: يتحول الرقم المحلي إلى الصيغة الدولية حسب دولة الفوترة، للسعودية والإمارات والكويت وقطر والبحرين وعُمان ومصر والأردن وتركيا. فيلتقي طلب من
0501234567مع محادثة واتساب للشخص نفسه. - المبيعات: تُحسب الطلبات بالحالات processing وcompleted وpaid وdelivered. لذلك يُحسب طلب الدفع عند الاستلام من حالة processing. الطلبات الملغاة والمستردة والفاشلة لا تُحسب، والاسترداد الجزئي لا يُخصم من المجموع.
- جهات الاتصال الجديدة تبدأ عملاء محتملين، وأول طلب يُحسب بيعًا يحوّلها إلى عميل.
- التكرار آمن: قد يرسل WooCommerce التحديث نفسه مرتين. التحديث الأقدم مما حُفظ، أو المطابق له تمامًا، يُتجاهل.
- حالات بوابات الدفع (مثل حالة تضيفها خدمة تقسيط) تُحفظ كما هي، ولا تدخل المبيعات حتى يصل الطلب إلى إحدى الحالات أعلاه.
- المسودات التي تحفظها صفحة الدفع قبل أن يُكمل العميل تُتجاهل.
استيراد الطلبات والمنتجات السابقة
ترسل الـWebhooks ما يحدث من الآن فقط. لجلب ما سبق:
- في ووردبريس افتح WooCommerce ثم Settings ثم Advanced ثم REST API، واضغط Add key، واختر صلاحية Read فقط.
- في رُتبة CRM، في بطاقة المتجر، افتح استيراد الطلبات والمنتجات السابقة.
- أدخل عنوان المتجر (العنوان العام بـ
https://دون منفذ) وConsumer key وConsumer secret، ثم اضغط حفظ المفاتيح. تُحفظ المفاتيح مشفرة ولا تظهر مرة أخرى. اكتبها بنفسك، ولا ترسلها في أي محادثة أو بريد. - اختر إن أردت الطلبات منذ (فارغ للكل)، ثم اضغط بدء الاستيراد.
يعمل الاستيراد في الخلفية، المنتجات أولًا ثم الطلبات، بما يصل إلى نحو 500 سجل في الدقيقة. يظهر تقدمه في البطاقة، مثل يعمل: استُورد 120 ورُفض 2. وتكراره لا يضيف شيئًا مرتين. الطلبات المستوردة لا تُشغّل الأتمتة ولا التذكيرات ولا الإشعارات الصادرة، ولا تغيّر آخر حدث:. ولا تُستورد إلا المنتجات المنشورة.
معلومات مفيدة
- الطلبات غير المكتملة: إن أردت تذكير العملاء على واتساب بالطلبات غير المدفوعة، فاضبطه من الرئيسية ثم التنبيهات والأتمتة. أضف إلى صفحة الدفع خانة موافقة، واكتب اسم حقلها، مثل
whatsapp_opt_in، في حقل الطلب الذي يحفظ موافقة واتساب. وإضافة ووردبريس تضيف هذه الخانة وتكتب اسم الحقل بنفسها. وتُقرأ الموافقة في كل طلب، دُفع فورًا أم لا. وفي WooCommerce، من Settings ثم Products ثم Inventory، اترك Hold stock (minutes) فارغًا، وإلا ألغى WooCommerce الطلبات غير المدفوعة بعد تلك المدة وتعطل رابط الدفع. راجع التنبيهات والملخصات. - الخصوصية: تنتقل أسماء العملاء وبريدهم وهواتفهم إلى رُتبة CRM، فاذكر ذلك في سياسة خصوصية متجرك قبل التشغيل الفعلي.
- إيقاف الربط يمنعه من استقبال الأحداث، فتفشل إرسالات WooCommerce. أعد تشغيله بزر تشغيل.
حل المشكلات
| ما تراه | ما تفعله |
|---|---|
| لم يصل أي حدث بعد. بعد طلب تجريبي | تأكد أن حالة الـWebhook في WooCommerce هي Active، وأن عنوان التسليم مطابق تمامًا للعنوان المنسوخ، وأن خادمك يصل إلى https://rutbacrm.com عبر HTTPS |
| أحداث مرفوضة: مع رقم | أحداث تعذّر حفظها. أكثر الأسباب أن الطلب بعملة غير USD وEUR وGBP وTRY وSAR وAED، أو بلا بريد ولا هاتف. وتُعد هنا أيضًا الأحداث التي تصل وباقتك لا تشمل ربط المتاجر. يُرد عليها كأنها وصلت حتى يبقي WooCommerce الـWebhook يعمل، لكن لا يُحفظ منها شيء |
| WooCommerce يعرض الـWebhook بحالة Disabled | يعطل WooCommerce الـWebhook بعد خمس محاولات فاشلة متتالية، مثلًا أثناء انقطاع. أعده إلى Active بعد أي انقطاع. ومع إضافة ووردبريس اضغط افحص ربط المتجر، والإضافة تعيد تشغيل Webhooks الخاصة بها مرة كل يوم أيضًا |
| فشل الإرسال بعد استبدال السر | يجب لصق السر الجديد في الـWebhooks الأربعة، وحتى ذلك الحين تُرفض |
| رفض المتجر المفاتيح. | أنشئ مفتاحًا جديدًا بصلاحية قراءة فقط. بعض الاستضافات تحذف ترويسة التفويض من طلبات API، فاطلب من الاستضافة السماح بها |
| لم توجد واجهة المتجر. | تأكد من عنوان المتجر، ومن أن واجهة REST في ووردبريس تعمل على /wp-json |
| الطلبات تصل بلا حملة | فعّل Order Attribution، وتأكد أن روابط إعلاناتك تحمل utm_campaign |
آخر تحديث 2026-11-08