MailerLite

المقدمة

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

يتولى هذا التكامل المصادقة باستخدام مفتاح API من MailerLite. لإنشاء مفتاح، افتح صفحة Integrations في MailerLite وانقر على Generate new token.

البدء

Open the Webhook Section

في لوحة تحكم Dodo Payments، انتقل إلى Developer → Webhooks وانقر على Add endpoint.

مربع حوار إضافة نقطة نهاية مع تحديد MailerLite في القائمة المنسدلة للتكامل

Select MailerLite

من قائمة Integration، حدّد MailerLite.

Enter API Key

الصق مفتاح API الخاص بـ MailerLite في حقل API key. يرسله Dodo Payments كعنوان Authorization في كل عملية تسليم.

Configure Transformation

عدّل الشيفرة الموجودة ضمن Transformation code بحيث يتحول كل حدث إلى طلب مشترك في MailerLite. ابدأ باستخدام الأمثلة أدناه.

Test & Create

ضمن Test this code، شغّل التحويل باستخدام حمولة نموذجية، ثم انقر على Create endpoint.

Done

تضيف أحداث الدفع الآن المشتركين وتحدّثهم في مجموعات MailerLite.

أمثلة كود التحويل

ترسل معظم الأمثلة طلب POST إلى API المشتركين في MailerLite. ينشئ MailerLite المشترك أو يحدّث المشترك الحالي الذي يملك عنوان البريد الإلكتروني نفسه. لا تزيل عملية upsert هذه الحقول أو المجموعات التي تتركها دون تحديد.

إضافة عميل عند نجاح الدفع

يضيف هذا المثال العميل إلى مجموعة واحدة عند نجاح عملية الدفع. استبدل your-group-id-here بمعرّف مجموعة في MailerLite.

add_customer.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: p.customer.email,
      fields: {
        name: p.customer.name,
        last_name: ""
      },
      groups: ["your-group-id-here"],
      status: "active"
    };
  }
  return webhook;
}

إضافة مشترك إلى مجموعات متعددة استنادًا إلى المنتج

يضيف هذا المثال كل عميل يدفع إلى مجموعة العملاء، ويضيف أيضًا العملاء الذين يدفعون POST دولارًا أو أكثر إلى مجموعة مميزة.

product_segmentation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    
    // Determine groups based on product or amount
    const groups = ["customers-group-id"];
    
    // Add to premium group if high-value purchase
    if (p.total_amount >= 10000) { // $100+
      groups.push("premium-customers-group-id");
    }
    
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: p.customer.email,
      fields: {
        name: p.customer.name,
        last_purchase_amount: (p.total_amount / 100).toFixed(2),
        last_purchase_date: new Date(webhook.payload.timestamp).toISOString().split('T')[0],
        payment_id: p.payment_id
      },
      groups: groups,
      status: "active"
    };
  }
  return webhook;
}

إضافة مشترك جديد عند تفعيل الاشتراك

يضيف هذا المثال العميل إلى مجموعتي مشتركين ويخزّن تفاصيل الخطة عند تفعيل الاشتراك.

subscription_subscriber.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: s.customer.email,
      fields: {
        name: s.customer.name,
        subscription_plan: s.product_id,
        subscription_amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
        billing_frequency: s.payment_frequency_interval,
        subscription_start: new Date().toISOString().split('T')[0]
      },
      groups: ["subscribers-group-id", "active-subscriptions-group-id"],
      status: "active"
    };
  }
  return webhook;
}

تحديث مشترك عند إلغاء الاشتراك

يحدّث هذا المثال مشتركًا موجودًا عند إلغاء الاشتراك. ويرسل طلب POST من نوع upsert باستخدام عنوان البريد الإلكتروني كمفتاح، لأن نقطة نهاية التحديث PUT في MailerLite تتطلب معرّف مشترك MailerLite، وهو غير موجود في حمولة Dodo Payments. يضيف طلب upsert المشترك إلى مجموعة العملاء الذين ألغوا اشتراكهم، ويحافظ على مجموعاته الأخرى.

subscription_cancelled.js

function handler(webhook) {
  if (webhook.eventType === "subscription.cancelled") {
    const s = webhook.payload.data;
    // POST upserts by email; PUT needs the MailerLite subscriber ID
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: s.customer.email,
      fields: {
        subscription_status: "cancelled",
        cancellation_date: new Date().toISOString().split('T')[0]
      },
      groups: ["churned-customers-group-id"]
    };
  }
  return webhook;
}

إضافة عميل باستخدام حقول مخصصة

يخزّن هذا المثال بيانات الموقع وبيانات الاتصال والدفع في حقول المشترك. أنشئ الحقول المخصصة في MailerLite أولًا، كما هو موضح في إعداد الحقول المخصصة.

custom_fields.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: p.customer.email,
      fields: {
        name: p.customer.name,
        country: p.billing?.country || "",
        city: p.billing?.city || "",
        phone: p.customer.phone_number || "",
        // Custom fields (must be created in MailerLite first)
        total_spent: (p.total_amount / 100).toFixed(2),
        customer_since: new Date().toISOString().split('T')[0],
        payment_method: p.payment_method || "unknown",
        currency: p.currency || "USD"
      },
      groups: ["paying-customers-group-id"],
      status: "active",
      subscribed_at: new Date().toISOString().replace('T', ' ').split('.')[0]
    };
  }
  return webhook;
}

تشغيل Automation عبر حدث

يحدّث هذا المثال حقل تشغيل عند كل عملية دفع ناجحة. أنشئ Automation في MailerLite يبدأ عند تغيّر last_payment_trigger.

trigger_automation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    
    // First, ensure subscriber exists
    webhook.url = "https://connect.mailerlite.com/api/subscribers";
    webhook.payload = {
      email: p.customer.email,
      fields: {
        name: p.customer.name,
        // Add a trigger field that your automation watches
        last_payment_trigger: new Date().toISOString(),
        last_payment_amount: (p.total_amount / 100).toFixed(2)
      },
      status: "active"
    };
    
    // Tip: Create an automation in MailerLite that triggers
    // when 'last_payment_trigger' field is updated
  }
  return webhook;
}

نصائح

أنشئ الحقول المخصصة في MailerLite قبل استخدامها في عملية تحويل.
استخدم المجموعات لتقسيم العملاء حسب المنتج أو مستوى الخطة أو سلوك الشراء.
أعد إعداد مسارات عمل Automation في MailerLite تبدأ عند تحديث أحد الحقول.
أرسل طلب POST إلى /subscribers لإجراء upsert، مما يمنع أخطاء المشتركين المكررين.
خزّن بيانات الدفع الوصفية في الحقول المخصصة لمعرفة المزيد عن عملائك.
اختبر التكامل باستخدام مجموعة صغيرة قبل تفعيله لجميع عمليات الدفع.

إعداد الحقول المخصصة

أنشئ كل حقل مخصص في MailerLite قبل أن تكتب عملية التحويل البيانات فيه:

افتح لوحة تحكم MailerLite.
انتقل إلى Subscribers → Fields.
انقر على Create field وأضف حقولًا مثل:
- total_spent (Number)
- customer_since (Date)
- subscription_plan (Text)
- payment_method (Text)
- last_payment_amount (Number)

استكشاف الأخطاء وإصلاحها

Subscribers Not Being Added

تحقّق من أن API key صحيحة ونشطة.
تحقّق من أن عنوان البريد الإلكتروني صالح وفق RFC 2821.
تحقّق من صحة كل معرّف مجموعة ومن وجود المجموعة في حسابك.
لا تعيد MailerLite تفعيل المشتركين الذين ارتدت رسائلهم أو صُنّفت رسائلهم كرسائل غير مرغوب فيها عبر API. لإعادة اشتراك مشترك ألغى اشتراكه سابقًا، أضف resubscribe: true إلى نص طلب POST.

Custom Fields Not Updating

تحقّق من وجود كل حقل مخصص في MailerLite.
تحقّق من تطابق أسماء الحقول تمامًا. فهي حساسة لحالة الأحرف.
تحقّق من توافق كل قيمة مع نوع الحقل: نص أو رقم أو تاريخ.

Rate Limit Errors

تسمح MailerLite API بإجراء 120 طلبًا في الدقيقة.
استخدم نقطة نهاية batch عند معالجة عدد كبير من المشتركين.
أضف استراتيجية backoff للسيناريوهات ذات الحجم الكبير.

Group Assignment Not Working

تحقّق من أن معرّفات المجموعات عبارة عن سلاسل رقمية.
تحقّق من وجود المجموعات في حساب MailerLite الخاص بك.
يزيل طلب PUT الذي يتضمن groups المشترك من كل مجموعة لا يدرجها. أما طلب POST فيضيف المجموعات فقط.

مرجع API

تقبل نقطة نهاية إنشاء المشترك أو إجراء upsert في MailerLite المعلمات الأساسية التالية:

Parameter	Type	Required	Description
`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 الخاص بالمشترك
`resubscribe`	boolean	No	اضبطه على `true` لإعادة اشتراك مشترك ألغى اشتراكه سابقًا

للاطلاع على وثائق API الكاملة، راجع Mailerlite Developers.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

المقدمة

البدء

أمثلة كود التحويل

إضافة عميل عند نجاح الدفع

إضافة مشترك إلى مجموعات متعددة استنادًا إلى المنتج

إضافة مشترك جديد عند تفعيل الاشتراك

تحديث مشترك عند إلغاء الاشتراك

إضافة عميل باستخدام حقول مخصصة

تشغيل Automation عبر حدث

نصائح

إعداد الحقول المخصصة

استكشاف الأخطاء وإصلاحها

مرجع API

​المقدمة

​البدء

​أمثلة كود التحويل

​إضافة عميل عند نجاح الدفع

​إضافة مشترك إلى مجموعات متعددة استنادًا إلى المنتج

​إضافة مشترك جديد عند تفعيل الاشتراك

​تحديث مشترك عند إلغاء الاشتراك

​إضافة عميل باستخدام حقول مخصصة

​تشغيل Automation عبر حدث

​نصائح

​إعداد الحقول المخصصة

​استكشاف الأخطاء وإصلاحها

​مرجع API

المقدمة

البدء

أمثلة كود التحويل

إضافة عميل عند نجاح الدفع

إضافة مشترك إلى مجموعات متعددة استنادًا إلى المنتج

إضافة مشترك جديد عند تفعيل الاشتراك

تحديث مشترك عند إلغاء الاشتراك

إضافة عميل باستخدام حقول مخصصة

تشغيل Automation عبر حدث

نصائح

إعداد الحقول المخصصة

استكشاف الأخطاء وإصلاحها

مرجع API