اربط متجرك

يرتبط هيو ميل بالأماكن التي يوجد فيها عملاؤك أصلاً. تعرض البريد › الإعدادات › التكاملات بطاقة لكل ربط — ووردبريس وووكومرس وشوبيفاي وواجهة REST API والويب هوكس — مع حالته. ويشرح زر التفاصيل على البطاقة ما الذي ينتقل وفي أي اتجاه وبأي صلاحيات.

الربط	ما يفعله	طريقة الربط
ووردبريس	نماذج اشتراك بتأكيد مزدوج على موقعك	إضافة هيو ميل ومفتاح API
ووكومرس	العملاء والطلبات والمنتجات من متجرك	الإضافة نفسها، مع Webhooks موقّعة من WooCommerce وتصدير تدريجي
شوبيفاي	العملاء والطلبات والمنتجات من متجرك	الموافقة على تطبيق HyoNova في Shopify من البريد، بوصول للقراءة فقط

الموافقة لا تُفترض أبداً#

الربط تقني فقط. لا يصبح العميل المتزامَن مشتركاً — ولا يتلقى بريداً تسويقياً — إلا حين يرسل المتجر موافقة تسويقية صريحة:

WooCommerce: خانة الموافقة التي يمكن للإضافة إظهارها عند الدفع وفي نموذج التسجيل، أو حقل معروف للاشتراك في النشرة.
Shopify: حالة موافقة العميل على التسويق بالبريد في Shopify هي «مشترك».

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

من يستطيع الربط#

يحتاج ربط المتجر وفصله إلى صلاحية إدارة البريد — وهي افتراضياً للمالكين والمديرين العامين. ويحتاج إنشاء مفتاح API للإضافة إلى الصلاحية نفسها.

WordPress وWooCommerce#

المتطلبات#

WordPress بالإصدار 6.2 أو أحدث، وPHP بالإصدار 7.4 أو أحدث. ولمزامنة المتجر: WooCommerce بالإصدار 7.0 أو أحدث.
PHP مع OpenSSL، لتحفظ الإضافة مفتاح API مشفّراً.
مفتاح API بالصلاحيتين mail.integrations.write وmail.events.read. وتشمل كل الخطط الواجهة البرمجية.

التثبيت والربط#

نزّل الإضافة. نزّل الملف hyonova-mail-wordpress.zip.
ثبّتها. في WordPress، انتقل إلى Plugins › Add New › Upload Plugin، واختر الملف ثم Install Now، ثم Activate.
أنشئ مفتاح API. في هيو ميل، افتح البريد › الأتمتة › مفاتيح API، واختر مفتاح API جديد، وحدّد mail.integrations.write وmail.events.read، ثم انسخ المفتاح. راجع واجهة Mail البرمجية.
الصق المفتاح. في WordPress، افتح صفحة إعدادات الإضافة (Settings › HyoNova Mail)، والصق المفتاح في API key واختر Connect. وعند قبول المفتاح تعرض الصفحة اسم شركتك وصلاحيات المفتاح وآخر فحص. اترك API origin كما هو (https://api.hyonova.com).

يُلصق المفتاح مرة واحدة ويُحفظ مشفّراً بمفاتيح wp-config.php الخاصة بموقعك، ولا يُعرض مجدداً. وإذا لم يتوفر OpenSSL، تذكر صفحة الإعدادات أن المفتاح مُرمَّز فقط وليس مشفّراً؛ فاطلب من مزوّد الاستضافة تفعيل OpenSSL.

أضف نموذج اشتراك#

أنشئ نموذجاً في البريد › جهات الاتصال › النماذج. ويُنصح بالتأكيد المزدوج. راجع جهات الاتصال والجمهور.
في WordPress، تعرض صفحة إعدادات الإضافة نماذجك النشطة مع الرمز المختصر لكل منها.
أضف النموذج إلى صفحة بالرمز المختصر [hyonova_mail_form id="FORM_ID"] أو بكتلة HyoNova Mail Form.

لا يُرسل إلى HyoNova إلا ما يكتبه الزائر في النموذج. ومع التأكيد المزدوج لا يُضاف الشخص إلى جمهورك إلا بعد أن يؤكد عبر البريد.

اربط WooCommerce#

اضبط خانة الموافقة. في صفحة إعدادات الإضافة، تحت WooCommerce، فعّل Consent checkbox لإظهار خانة موافقة عند الدفع وفي نموذج التسجيل، وراجع Checkbox text.
اربط. اختر Connect WooCommerce. تُنشئ الإضافة Webhooks موقّعة للطلبات والعملاء والمنتجات، وترسل نبضة تحقق موقّعة.
انتظر النبضة. لا تتحول بطاقة ووكومرس في هيو ميل إلى متصل إلا بعد أن يتحقق HyoNova من تلك النبضة. ثم تصدّر الإضافة عملاءك وطلباتك ومنتجاتك الحالية على دفعات.

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

تغذّي الطلبات نسبة إيرادات الحملات، ويمكن استخدام المنتجات في كتل المنتجات وفي المصمم الذكي.

يعيد Export now في صفحة إعدادات الإضافة تشغيل التصدير. وفي هيو ميل، يطلب مزامنة الآن على البطاقة المتصلة من الإضافة أن تصدّر عند فحصها التالي كل ساعة.

الفصل#

يزيل Disconnect WooCommerce في الإضافة الـ Webhooks التي أنشأتها وسرّ المتجر. ويزيل Disconnect في ربط WordPress مفتاح API من موقعك، فتتوقف النماذج عن قبول الاشتراكات حتى يُلصق مفتاح من جديد. وتحتفظ جهات الاتصال الموجودة في هيو ميل بحالة موافقتها الحالية.

Shopify#

افتح البطاقة. في البريد › الإعدادات › التكاملات، اختر ربط على شوبيفاي.
أدخل متجرك. أدخل نطاق متجرك، مثل your-store.myshopify.com، واختر ربط.
وافق في Shopify. يطلب منك Shopify الموافقة على وصول للقراءة فقط — المنتجات والعملاء والطلبات. ثم تعود إلى البريد، وتعمل المزامنة الأولى في الخلفية.

بعد ذلك تصل عبر Webhooks موقّعة من Shopify تغييرات العملاء الجدد والمعدّلين، والطلبات الجديدة والمدفوعة، والمنتجات، ويبقى الكتالوج متزامناً. ويتحقق HyoNova من كل Webhook من Shopify ويتجاهل التكرار.

يزيل فصل في تفاصيل الربط الـ Webhooks من متجرك. وتحتفظ جهات الاتصال الموجودة في هيو ميل بحالة موافقتها الحالية.

تابع الربط#

افتح البطاقة المتصلة لترى المتجر وآخر مزامنة ناجحة وآخر خطأ وما تمت مزامنته حتى الآن (جهات الاتصال والمنتجات وأحداث الطلبات)، مع سجلات المزامنة وآخر الأحداث. وحين تفشل مزامنة أو Webhook تعرض البطاقة خطأ: أصلح السبب — يجب أن يكون المتجر متاحاً وبيانات اعتماده صالحة — ثم زامن مجدداً أو أعد الربط.

ابنِ ربطك الخاص#

للأنظمة الأخرى، استخدم واجهة Mail البرمجية لإنشاء جهات الاتصال مع موافقاتها وتسجيل الطلبات، وWebhooks لاستقبال أحداث جهات الاتصال والطلبات.

الحالة#

الميزة	الحالة	ملاحظات
إضافة WordPress وWooCommerce	متاح	نماذج اشتراك بتأكيد مزدوج على موقع WordPress، ومزامنة موقّعة للعملاء والطلبات والمنتجات من WooCommerce.
ربط Shopify	يتطلب إعداداً	اربط متجر Shopify بوصول للقراءة فقط وزامن العملاء والطلبات والمنتجات. يعمل بعد إعداد تطبيق HyoNova على Shopify؛ وحتى ذلك لا يمكن ربط بطاقة Shopify.