المقدمة
قم بمزامنة عملائك الذين يدفعون تلقائيًا إلى قوائم المشتركين في MailerLite عند حدوث أحداث الدفع. أضف العملاء إلى مجموعات محددة، وفعل سير العمل الأوتوماتيكي، وابقِ قوائم التسويق عبر البريد الإلكتروني محدثة ببيانات الدفع الحقيقية. MailerLite هي منصة قوية للتسويق عبر البريد الإلكتروني للنشرات الإخبارية، والحملات، والأتمتة. تساعدك هذه التكاملات على إدارة المشتركين تلقائيًا بناءً على نشاط الدفع - مثالية لتسلسلات الانضمام، وتقسيم العملاء، وحملات التسويق المستهدفة.تتطلب هذه التكاملات مفتاح API الخاص بك في MailerLite للمصادقة. يمكنك إنشاء واحد من صفحة تكاملات MailerLite.
البدء
1
فتح قسم Webhook
في لوحة معلومات Dodo Payments الخاصة بك، انتقل إلى Webhooks + إضافة نقطة نهاية وقم بتوسيع قائمة التكاملات.

2
اختيار MailerLite
اختر بطاقة تكامل MailerLite.
3
إدخال مفتاح API
قدم مفتاح API الخاص بك في MailerLite في الإعدادات.
4
تكوين التحويل
قم بتحرير كود التحويل لتنسيق بيانات المشتركين لواجهة برمجة تطبيقات MailerLite.
5
اختبار وإنشاء
اختبر باستخدام حمولات عينة وانقر على إنشاء لتفعيل مزامنة المشتركين.
6
تم!
ستتم الآن مزامنة أحداث الدفع تلقائيًا للعملاء إلى قوائم MailerLite الخاصة بك.
أمثلة كود التحويل
إضافة عميل عند الدفع الناجح
add_customer.js
إضافة مشترك إلى مجموعات متعددة بناءً على المنتج
product_segmentation.js
إضافة مشترك جديد عند تفعيل الاشتراك
subscription_subscriber.js
تحديث مشترك عند إلغاء الاشتراك
subscription_cancelled.js
إضافة عميل مع حقول مخصصة
custom_fields.js
تفعيل الأتمتة عبر الحدث
trigger_automation.js
نصائح
- أنشئ حقولًا مخصصة في MailerLite قبل استخدامها في التحويلات الخاصة بك
- استخدم المجموعات لتقسيم العملاء حسب المنتج، أو مستوى الخطة، أو سلوك الشراء
- قم بإعداد سير العمل الأوتوماتيكي في MailerLite الذي يتم تفعيله عند تحديث الحقول
- استخدم سلوك upsert (POST إلى /subscribers) لتجنب أخطاء المشتركين المكررين
- قم بتخزين بيانات الدفع الوصفية في حقول مخصصة للحصول على رؤى أفضل عن العملاء
- اختبر مع مجموعة صغيرة قبل التفعيل لجميع المدفوعات
إعداد الحقول المخصصة
قبل استخدام الحقول المخصصة، تحتاج إلى إنشائها في MailerLite:- انتقل إلى لوحة معلومات MailerLite الخاصة بك
- انتقل إلى حقول المشتركين
- انقر على إنشاء حقل وأضف حقولًا مثل:
total_spent(رقم)customer_since(تاريخ)subscription_plan(نص)payment_method(نص)last_payment_amount(رقم)
استكشاف الأخطاء وإصلاحها
المشتركون لا يتم إضافتهم
المشتركون لا يتم إضافتهم
- تحقق من أن مفتاح API صحيح ونشط
- تحقق من أن عنوان البريد الإلكتروني صالح (متوافق مع RFC 2821)
- تأكد من أن معرفات المجموعات صحيحة وتوجد في حسابك
- ملاحظة: لا يمكن إعادة تفعيل المشتركين الذين تم إلغاء اشتراكهم، أو الذين تم ارتدادهم، أو الذين تم وضعهم في البريد العشوائي عبر API
الحقول المخصصة لا تتحدث
الحقول المخصصة لا تتحدث
- تحقق من أن الحقول المخصصة موجودة في MailerLite قبل استخدامها
- تحقق من أن أسماء الحقول تتطابق تمامًا (حساسة لحالة الأحرف)
- تأكد من أن قيم الحقول تتطابق مع النوع المتوقع (نص، رقم، تاريخ)
أخطاء حد المعدل
أخطاء حد المعدل
- تحتوي واجهة برمجة تطبيقات MailerLite على حد معدل يبلغ 120 طلبًا في الدقيقة
- استخدم نقاط النهاية الجماعية إذا كنت تعالج العديد من المشتركين
- نفذ استراتيجيات التراجع في السيناريوهات ذات الحجم الكبير
تعيين المجموعة لا يعمل
تعيين المجموعة لا يعمل
- تحقق من أن معرفات المجموعات هي سلاسل رقمية
- تحقق من أن المجموعات موجودة في حساب MailerLite الخاص بك
- ملاحظة: استخدام PUT مع المجموعات سيزيل المشترك من المجموعات غير المدرجة
مرجع API
تقبل واجهة برمجة تطبيقات مشتركي MailerLite المعلمات الرئيسية التالية:| المعلمة | النوع | مطلوب | الوصف |
|---|---|---|---|
email | string | نعم | عنوان بريد إلكتروني صالح (RFC 2821) |
fields | object | لا | كائن يحتوي على أزواج اسم الحقل/القيمة |
fields.name | string | لا | الاسم الأول للمشترك |
fields.last_name | string | لا | الاسم الأخير للمشترك |
fields.company | string | لا | اسم الشركة |
fields.country | string | لا | الدولة |
fields.city | string | لا | المدينة |
fields.phone | string | لا | رقم الهاتف |
groups | array | لا | مصفوفة من معرفات المجموعات لإضافة المشترك إليها |
status | string | لا | واحد من: نشط، غير مشترك، غير مؤكد، ارتداد، بريد عشوائي |
subscribed_at | string | لا | التاريخ بالتنسيق yyyy-MM-dd HH:mm:ss |
ip_address | string | لا | عنوان IP للمشترك |