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

أمثلة كود التحويل
إضافة عميل عند الدفع الناجح
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 الخاصة بك
- انتقل إلى حقول المشتركين
- انقر على Create field وأضف حقول مثل:
total_spent(رقم)customer_since(تاريخ)subscription_plan(نص)payment_method(نص)last_payment_amount(رقم)
استكشاف الأخطاء وإصلاحها
Subscribers not being added
Subscribers not being added
- تحقق من أن مفتاح API صحيح ونشط
- تأكد من أن عنوان البريد الإلكتروني صالح (متوافق مع RFC 2821)
- تأكد من أن معرفات المجموعات صحيحة وموجودة في حسابك
- ملاحظة: لا يمكن إعادة تنشيط المشتركين الذين ألغوا الاشتراك أو ارتدت رسائلهم أو تم تصنيفهم كرسائل غير مرغوب فيها عبر واجهة برمجة التطبيقات
Custom fields not updating
Custom fields not updating
- تحقق من وجود الحقول المخصصة في MailerLite قبل استخدامها
- تأكد من تطابق أسماء الحقول تمامًا (حساسية لحالة الأحرف)
- تأكد من أن قيم الحقول تتطابق مع النوع المتوقع (نص، رقم، تاريخ)
Rate limit errors
Rate limit errors
- واجهة برمجة تطبيقات MailerLite لها حد سرعة يبلغ 120 طلبًا في الدقيقة
- استخدم نقاط النهاية الدُفعية إذا كنت تعالج العديد من المشتركين
- نفذ استراتيجيات تراجع في حالات الحجم الكبير
Group assignment not working
Group assignment not working
- تحقق من أن معرفات المجموعات هي سلاسل رقمية
- تحقق من وجود المجموعات في حساب MailerLite الخاص بك
- ملاحظة: سيؤدي استخدام PUT مع المجموعات إلى إزالة المشترك من المجموعات غير المدرجة
مرجع API
تقبل واجهة برمجة تطبيقات مشتركي MailerLite المعلمات الرئيسية التالية:| الوسيط | النوع | مطلوب | الوصف |
|---|---|---|---|
email | string | Yes | عنوان بريد إلكتروني صالح (RFC 2821) |
fields | object | No | كائن يحتوي على أزواج اسم/قيمة للحقول |
fields.name | string | No | الاسم الأول للمشترك |
fields.last_name | string | No | اسم عائلة المشترك |
fields.company | string | No | اسم الشركة |
fields.country | string | No | البلد |
fields.city | string | No | المدينة |
fields.phone | string | No | رقم الهاتف |
groups | array | No | مصفوفة بمعرفات المجموعات التي يجب إضافة المشترك إليها |
status | string | No | أحد الخيارات: active، unsubscribed، unconfirmed، bounced، junk |
subscribed_at | string | No | تاريخ بالتنسيق yyyy-MM-dd HH:mm:ss |
ip_address | string | No | عنوان بروتوكول الإنترنت (IP) للمشترك |