الحلقات

المقدمة

يحوّل تكامل Loops أحداث Dodo Payments إلى أحداث Loops، بحيث تُرسل تأكيدات الدفع وتحديثات الاشتراكات وإشعارات فشل الدفع كرسائل بريد إلكتروني من Loops. تعمل عملية تحويل على تعيين كل حدث دفع إلى حدث Loops، ويؤدي هذا الحدث إلى تشغيل مهمة سير العمل المطابقة في Loops.

تحتاج إلى API key لـ Loops. في Loops، انتقل إلى Settings → API وأنشئ مفتاحًا.

البدء

Open the Webhook Section

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

Add endpoint dialog with Loops selected in the Integration dropdown

Select Loops

في قائمة Integration، حدّد Loops.

Enter API Key

الصق API key الخاص بـ Loops في حقل API key. يرسله Dodo Payments كرأس Authorization في كل عملية تسليم. يحدّد التكامل عنوان الوجهة، لذا فإن المفتاح هو القيمة الوحيدة التي تقدمها.

Configure Transformation

عدّل الرمز الموجود ضمن Transformation code بحيث يصبح كل حدث حدثًا في Loops. ابدأ من الأمثلة أدناه. ضمن Subscribed events، حدّد الأحداث التي يعالجها الرمز.

Test & Create

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

Done

تؤدي أحداث الدفع الآن إلى تشغيل رسائل البريد الإلكتروني من خلال Loops.

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

يعيد كل مثال كتابة نوع واحد من الأحداث في نص واجهة برمجة التطبيقات Send an Event الخاصة بـ Loops: eventName، وemail الخاص بجهة الاتصال، وeventProperties الذي يمكن لرسائل البريد الإلكتروني في Loops استخدامه.

رسالة تأكيد الدفع

يرسل هذا المثال حدث payment_confirmation عند نجاح عملية الدفع.

payment_confirmation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_confirmation",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        currency: p.currency || "USD",
        payment_method: p.payment_method || "unknown",
        payment_date: new Date(webhook.payload.timestamp).toLocaleDateString()
      }
    };
  }
  return webhook;
}

رسالة ترحيب بالاشتراك

يرسل هذا المثال حدث subscription_welcome عند تنشيط الاشتراك.

subscription_welcome.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "subscription_welcome",
      email: s.customer.email,
      eventProperties: {
        customer_name: s.customer.name,
        subscription_id: s.subscription_id,
        product_id: s.product_id,
        amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
        frequency: s.payment_frequency_interval,
        next_billing: s.next_billing_date
      }
    };
  }
  return webhook;
}

إشعار فشل الدفع

يرسل هذا المثال حدث payment_failed مع رسالة الخطأ ورابط لإعادة المحاولة. استبدل yourdomain.com بنطاقك الخاص.

payment_failure.js

function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_failed",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        error_message: p.error_message || "Payment processing failed",
        retry_link: `https://yourdomain.com/retry-payment/${p.payment_id}`
      }
    };
  }
  return webhook;
}

نصائح

امنح كل حدث اسمًا وصفيًا، مثل payment_confirmation، للحفاظ على تنظيم رسائل البريد الإلكتروني في Loops.
أدرج خصائص العميل التي تستخدمها رسائل البريد الإلكتروني للتخصيص.
في Loops، أنشئ مهمة سير عمل ورسالة بريد إلكتروني لكل اسم حدث ترسله.
استخدم أسماء الخصائص نفسها في جميع الأحداث.
اختبر تسليم البريد الإلكتروني قبل بدء التشغيل الفعلي.

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

Emails Not Being Sent

تحقّق من أن API key صحيح ونشط.
تحقّق من أن اسم كل حدث يطابق الحدث الذي يشغّل مهمة سير العمل في Loops.
تحقّق من صحة عناوين البريد الإلكتروني للمستلمين.
راجع حدود الإرسال والحصص في Loops.

Transformation Errors

تحقّق من أن الحمولة تطابق تنسيق Loops API: eventName، بالإضافة إلى email أو userId.
تحقّق من وجود جميع الحقول المطلوبة.
تحقّق من تنسيق أسماء الأحداث بشكل صحيح.
امنح كل خاصية حدث قيمة من نوع string أو number أو boolean أو date.
تحقّق من أذونات API key.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

المقدمة

البدء

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

رسالة تأكيد الدفع

رسالة ترحيب بالاشتراك

إشعار فشل الدفع

نصائح

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

​المقدمة

​البدء

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

​رسالة تأكيد الدفع

​رسالة ترحيب بالاشتراك

​إشعار فشل الدفع

​نصائح

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

المقدمة

البدء

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

رسالة تأكيد الدفع

رسالة ترحيب بالاشتراك

إشعار فشل الدفع

نصائح

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