Mailchimp
أبقِ جمهور Mailchimp متزامنًا مع B1 تلقائيًا: ينضم الأشخاص مع أسمائهم وبريدهم الإلكتروني وأرقام هواتفهم، وتتحول عضوية المجموعات والقوائم إلى وسوم في Mailchimp، ويُؤرشَف الأشخاص المحذوفون. المزامنة مدمجة في B1، فلا حاجة إلى خدمة طرف ثالث ولا رسوم على كل مهمة، وتصل التغييرات شبه فورًا بدلًا من أن تُعالج مرة واحدة كل ليلة.
قبل أن تبدأ
- حساب Mailchimp يحتوي على الجمهور الذي تريد أن يديره B1
- مفتاح API من Mailchimp (أيقونة الملف الشخصي ← الحساب والفوترة ← الإضافات ← مفاتيح API)
- معرّف الجمهور (Mailchimp: الجمهور ← الإعدادات ← اسم الجمهور والإعدادات الافتراضية)
- مستخدم في B1Admin لديه صلاحية تعديل الإعدادات (Edit Settings)
ما الذي يتم مزامنته
| التغيير في B1 | الأثر في Mailchimp |
|---|---|
| إضافة شخص أو تحديثه | إضافة المشترك أو تحديثه (الاسم الأول واسم العائلة والهاتف؛ يُضاف المشتركون الجدد بحالة subscribed) |
| حذف شخص (أو محو بياناته وفق GDPR) | أرشفة المشترك |
| انضمام شخص إلى مجموعة | إضافة وسم يحمل اسم المجموعة |
| مغادرة شخص لمجموعة | إزالة ذلك الوسم |
| دخول شخص إلى قائمة محفوظة | إضافة وسم يحمل اسم القائمة |
| خروج شخص من قائمة محفوظة | إزالة ذلك الوسم |
القوائم المحفوظة هي عادةً مصدر الوسوم الأفضل. القائمة المحفوظة في B1 جمهور قائم على قواعد يعيد تقييم نفسه تلقائيًا، مثل "كل من ينتمي إلى فرع الشمال" أو "الأعضاء الذين اشتركوا في رسائل الرعاية الراعوية". وجّه شرائح Mailchimp إلى وسوم القوائم لتتولى المزامنة الحفاظ عليها، واستخدم وسوم المجموعات للرسائل الموجهة إلى فرق الخدمة.
المزامنة أحادية الاتجاه (من B1 إلى Mailchimp) وتقتصر على الحقول القياسية في Mailchimp، لذلك لا تتعارض مع حقول الدمج أو الشرائح التي تديرها داخل Mailchimp.
الإعداد
- في B1Admin، انتقل إلى الإعدادات ← المطوّر ← Webhooks ← New Webhook.
- اضبط Connector Type على Mailchimp.
- الصق مفتاح Mailchimp API ومعرّف الجمهور. يُخزَّن المفتاح مشفّرًا ولا يُعرض مرة أخرى.
- الأحداث ذات الصلة مُحددة مسبقًا؛ ألغِ تحديد أي حدث لا تريده (مثلًا، أبقِ أحداث الأشخاص مفعّلة وتجاوز وسوم المجموعات).
- احفظ. يتحقق B1 من المفتاح والجمهور مع Mailchimp قبل القبول، فيفشل الخطأ الإملائي فورًا مع ذكر السبب.
يمكنك استخدام إرسال اختبار (Send Test) في أي وقت لإعادة التحقق من الاتصال. تُسجَّل كل محاولة مزامنة في سجل تسليم الـ webhook مع استجابة Mailchimp الفعلية، وتُعاد المحاولات الفاشلة تلقائيًا مع تأخير متزايد لمدة خمسة أيام تقريبًا.
الاستيراد الأولي
يزامن الموصّل التغييرات منذ تفعيله، ولا يستورد دليلك الحالي تلقائيًا. ليوم الإعداد:
- في B1Admin، انتقل إلى الأشخاص (People)، وابحث عن الأشخاص الذين تريدهم (أو شغّل قائمة محفوظة)، ثم انقر تصدير (Export) لتنزيل ملف CSV.
- في Mailchimp، استخدم الجمهور ← استيراد جهات الاتصال لتحميل ملف CSV، مع تطبيق أي وسوم أثناء الاستيراد.
إجراء التحميل الأولي عبر أداة الاستيراد في Mailchimp يبقيك متحكمًا في مسألة الموافقة، فلا تستورد إلا الأشخاص الذين وافقوا فعلًا على تلقي رسائلك. استيراد الدليل كاملًا كجهات اتصال مشتركة دفعة واحدة قد يخالف شروط Mailchimp وقوانين مكافحة الرسائل المزعجة (CAN-SPAM/GDPR).
الحدود والملاحظات
- مزامنة أحادية الاتجاه. لا تنتقل إلى B1 عمليات إلغاء الاشتراك أو الرسائل المرتدّة أو التعديلات التي تُجرى في Mailchimp. قد يستمر شخص ألغى اشتراكه في Mailchimp بتلقي رسائل ترسلها مباشرة من B1، لذا اعتبر Mailchimp المرجع الأساسي لموافقات البريد الجماعي.
- يتم تخطي الأشخاص الذين لا يملكون بريدًا إلكترونيًا (ويُسجَّل ذلك في سجل التسليم)، لأن مشتركي Mailchimp يُعرَّفون بالبريد الإلكتروني.
- تغيير البريد الإلكتروني ينشئ مشتركًا جديدًا. يُعرِّف Mailchimp الأشخاص بالبريد الإلكتروني، لذا عند تغيير بريد شخص في B1 يُضاف تحت العنوان الجديد، ويبقى المشترك القديم حتى تؤرشفه يدويًا في Mailchimp.
- تُزامَن الحقول القياسية فقط: الاسم الأول واسم العائلة والهاتف. حالة العضوية والفرع والحقول المخصصة في B1 لا تُربط بحقول الدمج في Mailchimp في هذا الإصدار، لذا استخدم وسوم القوائم للتقسيم.
- أسماء الوسوم هي أسماء المجموعات/القوائم. عند إعادة تسمية مجموعة أو قائمة، تبدأ الوسوم الجديدة باسمها الجديد، ويبقى الوسم القديم على المشتركين الحاليين حتى تزيله في Mailchimp.
- حدود جهات الاتصال في Mailchimp لا تزال سارية. إذا تجاوزت المزامنة سقف جمهور الخطة المجانية، فستظهر أخطاء
Member limit reachedفي سجل التسليم.
وصفات أخرى (Zapier / Make)
أي شيء يتجاوز مزامنة الجمهور، مثل وسم المتبرعين عند donation.created، أو الاتجاه العكسي من Mailchimp إلى B1، أو المزامنة مع منصة بريد إلكتروني مختلفة تمامًا (Constant Contact وBrevo وغيرهما)، ما زال متاحًا عبر Zapier أو Make، إذ تُفعَّل بالأحداث نفسها الخاصة بالـ webhook:
- وسم المتبرعين: B1 New Donation ← B1 Find Person ← Mailchimp Add Subscriber to Tag (
Gave-2026) - في الاتجاهين: Mailchimp New Subscriber ← B1 Create Person
إذا كنت قد ربطت مزامنة الأشخاص والمجموعات سابقًا عبر Zapier، فأوقف تلك الـ Zaps بعد تفعيل الموصّل المدمج. تشغيل الاثنين معًا يعالج كل حدث مرتين ويستهلك مهام Zapier دون فائدة.
استكشاف الأخطاء وإصلاحها
- يفشل الحفظ برسالة "Mailchimp rejected the API key": المفتاح ملغى أو مكتوب بشكل خاطئ. يجب أن تنتهي المفاتيح بلاحقة مركز البيانات مثل
-us21. - يفشل الحفظ برسالة "audience not found": معرّف الجمهور غير موجود ضمن هذا الحساب. انسخه من الجمهور ← الإعدادات ← اسم الجمهور والإعدادات الافتراضية (وهو ليس اسم الجمهور).
- لم يظهر شخص في Mailchimp أبدًا: راجع سجل تسليم الـ webhook. الرسالة "Skipped: person has no email address" تعني ذلك حرفيًا، أما رمز
4xxمن Mailchimp فيُبيّن السبب في نص الاستجابة. - توقفت عمليات التسليم كليًا: بعد فشل متكرر في التسليم يُعطَّل الـ webhook تلقائيًا. أصلح السبب (غالبًا مفتاح ملغى)، ثم أعد تفعيله واستخدم إرسال اختبار للتأكد.
انظر أيضًا
- Webhooks (المرجع للمطوّرين): المحرك الذي يعمل خلف الكواليس، وكتالوج الأحداث، وسلوك التسليم وإعادة المحاولة
- القوائم المحفوظة: جمهور قائم على القواعد يتوافق بشكل طبيعي مع وسوم Mailchimp
- Zapier (نظرة عامة): للوصفات التي تتجاوز مزامنة الجمهور