كيف أثبّت تكاملًا مع VeloCMS وأربطه وأعالج مشكلاته؟

تعمل معظم تكاملات VeloCMS بالطريقة نفسها: يحدث أمر ما في موقعك، كتسجيل عضو أو دفع طلب، فيرسل VeloCMS نسخة منه إلى الأداة الأخرى. تشرح مقالات HubSpot وXero وShippo وTapfiliate وغيرها ما تتلقاه كل أداة. أما هذه المقالة فتغطي الجزء المشترك بينها، لتبقى تلك الصفحات مخصصة للأداة نفسها.

كيف أثبّت تكاملًا؟

افتح «لوحة التحكم ← الإضافات»، وابحث عن التكامل، ثم اضغط «تثبيت». يظهر مربع حوار بعنوان «تثبيت» متبوعًا باسم الإضافة، ويسرد ما تستطيع الإضافة الوصول إليه، كأعضائك وطلباتك، والخدمات الخارجية التي يحق لها الاتصال بها. اقرأ القائمة، ثم اضغط «منح الصلاحيات والتثبيت». وعند الانتهاء افتح الإضافة من «لوحة التحكم ← الإضافات» لتصل إلى لوحة إعداداتها.

الإضافة المعطّلة تبقى مثبّتة لكنها لا تعمل. أما إلغاء التثبيت فيزيل الإضافة وجميع إعداداتها نهائيًا، فعطّلها بدلًا من ذلك إن أردت إيقافًا مؤقتًا فقط.

هل يستخدم تكاملي مفتاحًا أم OAuth؟

• تلصق مفتاحًا أو رمزًا أو عنوانًا: ActiveCampaign وCircle.so وKeygen وPabbly Connect وShippo وShipStation وTaxJar وTapfiliate وTypeform.
• تضغط Connect وتوافق على الصلاحيات في صفحة الأداة الأخرى نفسها: HubSpot وQuickBooks Online وEtsy وXero. لا يوجد مفتاح لتنسخه.

تُخزَّن المفاتيح الملصوقة ورموز OAuth مشفّرة. تذكر عدة لوحات صراحةً أن المفتاح لا يُعرض مرة أخرى بعد حفظه، ولاستبدال مفتاح أدخل المفتاح الجديد واحفظ من جديد.

ماذا يحدث عندما أضغط Connect؟

يحوّلك الزر إلى صفحة تسجيل الدخول في الأداة الأخرى. توافق على الصلاحيات المعروضة، ثم تعود إلى لوحة VeloCMS نفسها وقد صارت تعرض «Connected to» متبوعًا باسم الأداة، وبجوارها زر Disconnect. يحتفظ VeloCMS بالرموز الناتجة، ولا يطّلع أبدًا على كلمة مرورك في الأداة الأخرى.

إذا ظهر في اللوحة إشعار بأن الموصل «قريبًا» بدلًا من زر Connect، فهذا يعني أن تطبيق OAuth الخاص بتلك الأداة لم يُعدّ بعد من جانب VeloCMS. لا يمكنك إصلاح ذلك من اللوحة؛ راسل [email protected].

يحذف Disconnect الرموز المخزّنة، ويطلب من الأداة إلغاءها متى سمحت بذلك. تبقى السجلات التي أُنشئت سابقًا في الأداة الأخرى كما هي. أما Etsy فاستثناء من جهة الإلغاء: يحذف VeloCMS نسخته فقط، فأزل VeloCMS أيضًا من التطبيقات المصرّح لها في إعدادات حسابك على Etsy.

هل هناك مفتاح تشغيل يجب أن أفعّله؟

غالبًا نعم. لدى Shippo وShipStation وTaxJar وTapfiliate مفتاح تفعيل يبدأ مُعطَّلًا، فلا يُرسل المفتاح المحفوظ وحده شيئًا حتى تفعّل المفتاح وتحفظ. أما مفتاح Keygen فيبدأ مفعّلًا. وفي Pabbly Connect مفتاح لكل حدث، وكلها مفعّلة افتراضيًا. وأكثر أسباب ظهور التكامل كأنه لا يفعل شيئًا هو مفتاح محفوظ مع بقاء زر التفعيل مُعطَّلًا.

ماذا يفعل «اختبار الاتصال» فعليًا؟

يفحص «اختبار الاتصال» الإعدادات التي حفظتها آخر مرة، لا ما كتبته في الحقل، فاضغط «حفظ الإعدادات» أولًا. معظم الاختبارات تسأل الأداة الأخرى سؤالًا غير ضار، لكن ثلاثة منها تترك أثرًا:

• Keygen يُصدر ترخيصًا تجريبيًا حقيقيًا على سياستك الافتراضية، ويمكنك إلغاؤه (revoke) من Keygen.
• ShipStation ينشئ طلبًا بحالة On Hold يحمل الرقم velocms-connection-test. وتحدّث الاختبارات المتكررة الطلب نفسه ولا تضيف غيره.
• Tapfiliate يرسل تحويلًا بقيمة صفر لعميل تجريبي، ولا يُعدّ الاختبار فاشلًا إلا إذا رُفض المفتاح.

متى تعمل المزامنة، وماذا لو فشلت؟

تتفاعل التكاملات مع الأحداث الجديدة: تسجيل عضو، أو طلب مدفوع، أو منشور منشور، أو حساب محذوف. وتعمل في الخلفية بعد الحدث، فلا يؤخّر تكامل بطيء أو معطوب تسجيلًا ولا طلبًا. كما أنها لا تملأ الماضي: الأعضاء والطلبات الموجودون قبل الربط لا يُرسَلون.

يُسجَّل كل إرسال فاشل في «التكاملات ← نشاط المزامنة»، مع نوع السجل (عضو أو منشور أو طلب)، وعدد محاولات إعادة المحاولة، وما الذي حدث. وإذا لم يفشل شيء تعرض الصفحة «جميع عمليات المزامنة سليمة». ولا يظهر زر إعادة المحاولة إلا للموصلات التي لا يُنتج فيها تكرار الطلب نسخة مكررة: Mailchimp وKit وbeehiiv وBrevo وMailerLite وKlaviyo وMastodon وCircle.so. أما في غيرها فأصلح السبب الظاهر، وإن كان السجل مهمًا فأدخله في الأداة الأخرى يدويًا.

يعمل Typeform في الاتجاه المعاكس: فهو يستقبل إرسالات النماذج بدل أن يرسل بيانات إلى الخارج، لذا لا يظهر أبدًا في نشاط المزامنة.

ماذا أفحص عندما لا يصل شيء؟

1. «لوحة التحكم ← الإضافات»: هل التكامل مثبّت ومفعّل؟
2. في لوحته: هل مفتاح التفعيل شغّال، وهل ضغطت «حفظ الإعدادات» بعد تشغيله؟
3. لأدوات OAuth: هل تعرض اللوحة Connected؟ وإن عرضت Connect فأعد التفويض.
4. بيانات الاعتماد: أعد إدخال المفتاح واحفظ، ثم استخدم «اختبار الاتصال» إن وُجد في اللوحة.
5. نشاط المزامنة: هل هناك صف فاشل للسجل الذي توقعته، وماذا يقول سببه؟
6. التوقيت: هل أُنشئ التسجيل أو الطلب أو المنشور بعد الربط؟ ما قبله لا يُرسَل.

إذا أشار السبب إلى الأداة الأخرى، كاستجابة «غير مصرّح»، فأعد إنشاء المفتاح هناك واحفظه هنا. وإذا ذكر عنوانًا أو إعدادًا ناقصًا، فمقالة التكامل نفسه تسرد الحقول التي يحتاجها.