كيف أربط ActiveCampaign لمزامنة الأعضاء كجهات اتصال وصفقات؟
ألصق مفتاح API وعنوان حساب ActiveCampaign، فيصبح كل عضو جديد في المدونة جهة اتصال (Contact) — مع وسم اختياري — وينشئ كل طلب صفقة (Deal).
يُبقي موصل ActiveCampaign نظام إدارة العملاء لديك محدّثًا دون تصدير يدوي: كل عضو جديد في المدونة يصبح جهة اتصال (Contact)، وكل طلب يصبح صفقة (Deal). وهو بديل مجاني عن دفع ثمن تكامل CRM مخصص.
طريقة تثبيت الإضافة وما يُفحص عندما يبدو الموصل صامتًا واحدة في كل التكاملات، لذا فهي في الدليل المشترك للتكاملات. وهذه الصفحة تغطي ما يخص ActiveCampaign.
الخطوة 1 — احصل على مفتاح API وعنوان الحساب
في ActiveCampaign اذهب إلى Settings ← Developer ← API Access لتجد مفتاح API وعنوان API لحسابك — يبدو مثل https://youraccountname.api-us1.com/api/3/ مع استبدال "youraccountname" بالنطاق الفرعي لحسابك.
الخطوة 2 — املأ لوحة ActiveCampaign
افتح «لوحة التحكم ← الإضافات ← ActiveCampaign»، والصق مفتاح API وعنوان الحساب، واضبط اختياريًا «الوسم الافتراضي» (مثل "blog-subscriber") ليُطبَّق على كل جهة اتصال تُزامَن. لا يوجد مفتاح تفعيل في هذه اللوحة: ما إن يُحفظ مفتاح وعنوان صالحان حتى تصبح المزامنة حيّة.
يجب أن يحتوي عنوان حسابك على api-us1.com — فالموصل لا يجري اتصالات شبكية إلا بالنطاق الفرعي لحساب ActiveCampaign الخاص بك، ويرفض أي عنوان لا يطابق ذلك.
ما الذي يُزامَن، ومتى
- يُرسَل تسجيل العضو الجديد إلى ActiveCampaign جهةَ اتصال ببريده واسمه. ويُقسَم الاسم عند أول مسافة: «Ana Maria Lopez» يصبح الاسم الأول Ana والاسم الأخير Maria Lopez.
- إذا ضبطت وسمًا افتراضيًا، يبحث عنه VeloCMS بالاسم، وينشئه في ActiveCampaign إن لم يكن موجودًا، ثم يطبّقه على جهة الاتصال.
- الطلب المكتمل ينشئ صفقة عنوانها «VeloCMS Order» متبوعًا برقم الطلب، بقيمة إجمالي الطلب، وببريد المشتري جهةَ اتصال.
- عندما يحذف عضو حسابه، أو يلغي اشتراكه عبر الرابط في إحدى نشراتك، تُضبَط جهة اتصاله على «Unsubscribed». ولا تُحذف، وتُتجاهَل جهة الاتصال التي لم تعد موجودة.
تفاصيل تستحق المعرفة
تُنشأ الصفقة بحالة Open، وتُرسَل العملة دائمًا USD، فمتجر يحاسب بعملة أخرى سيرى الرقم الصحيح موسومًا بالدولار. ولا يختار VeloCMS مسارًا ولا مرحلة، فتطبّق ActiveCampaign افتراضياتها. وفشل تطبيق وسم يُسجَّل في السجلات لكنه لا يعدّ مزامنة جهة الاتصال فاشلة؛ فالذي يعدّها كذلك هو فشل طلب جهة الاتصال وحده. ولا يبحث VeloCMS عن جهة اتصال موجودة مسبقًا، فما يحدث حين يكون البريد نفسه موجودًا أصلًا في ActiveCampaign يعود إلى قواعد ActiveCampaign نفسها.
المزامنة باتجاه واحد فقط: يدفع VeloCMS البيانات إلى ActiveCampaign. إذا تعذّر الوصول إلى ActiveCampaign مؤقتًا أو كانت بيانات اعتمادك خاطئة، تفشل المحاولة بصمت في الخلفية — ولا تعطّل أو تؤخّر تسجيل العضو ولا الطلب أبدًا. ويظهر كل فشل في «التكاملات ← نشاط المزامنة». ولا يحصل ActiveCampaign على زر إعادة المحاولة هناك، فجهة الاتصال الفائتة تُضاف في ActiveCampaign يدويًا متى عاد المفتاح يعمل.
قطع الاتصال
امسح مفتاح API في نفس اللوحة لإيقاف المزامنة. لن تُنشأ أي جهات اتصال أو صفقات جديدة بعد ذلك، وتبقى السجلات الموجودة في ActiveCampaign كما هي.