الانتقال إلى المحتوى الرئيسي

المقدمة

تتيح لك تكامل AutoSend وDodo Payments إرسال إشعارات بريد إلكتروني تلقائية في الوقت الفعلي لجميع أحداث الدفع، من المعاملات الناجحة إلى المحاولات الفاشلة وتأكيدات المبالغ المستردة. أرسل رسائل بريد إلكتروني معاملات لأحداث الدفع باستخدام واجهة برمجة تطبيقات البريد الإلكتروني القوية من AutoSend.
يتطلب هذا التكامل مفتاح واجهة برمجة تطبيقات AutoSend الخاص بك للمصادقة. يمكنك العثور على مفتاح واجهة برمجة التطبيقات الخاص بك في لوحة معلومات AutoSend تحت الإعدادات > مفاتيح واجهة برمجة التطبيقات.

البدء

اتبع هذه الخطوات لتكامل AutoSend مع Dodo Payments:
1

فتح قسم Webhook

انتقل إلى قسم Webhooks في لوحة معلومات Dodo Payments الخاصة بك.
إضافة نقطة النهاية وقائمة التكاملات
2

اختيار تكامل AutoSend

اختر AutoSend من قائمة التكاملات المتاحة.
3

إدخال مفتاح API

قدم مفتاح واجهة برمجة التطبيقات الخاص بـ AutoSend للمصادقة. يمكنك العثور على مفتاح واجهة برمجة التطبيقات الخاص بك في لوحة معلومات AutoSend تحت الإعدادات > مفاتيح واجهة برمجة التطبيقات.

تعلم كيفية إنشاء وإدارة مفاتيح API

قم بزيارة وثائق AutoSend للحصول على تعليمات مفصلة حول إنشاء وإدارة مفاتيح API.
4

تكوين التحويل

قم بإعداد معالجات تحويل JavaScript لتخصيص محتوى البريد الإلكتروني بناءً على أحداث الدفع.
5

اختبار وإنشاء

اختبر تكوين webhook الخاص بك للتأكد من إرسال الرسائل الإلكترونية بشكل صحيح، ثم قم بإنشاء التكامل.
6

اكتمل التفعيل

🎉 تم تفعيل تكامل AutoSend الخاص بك الآن وسيقوم تلقائيًا بإرسال رسائل البريد الإلكتروني لأحداث الدفع المكونة.

أمثلة على الكود

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

أرسل رسالة تأكيد عند معالجة الدفع بنجاح:
payment_confirmation.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "payments@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Payment Successful - Thank you for your purchase!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        paymentId: p.payment_id,
        paymentDate: new Date(p.created_at).toLocaleDateString(),
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

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

أرسل رسالة ترحيب عند إنشاء اشتراك جديد:
subscription_welcome.js
function handler(webhook) {
  if (webhook.eventType === "subscription.created") {
    const s = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: s.customer.email,
        name: s.customer.name,
      },
      from: {
        email: "subscriptions@mail.yourdomain.com",
        name: "Your Company",
      },
      subject: "Welcome to your subscription!",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: s.customer.name,
        planName: s.plan.name,
        billingInterval: s.billing_interval,
        nextBillingDate: new Date(s.next_billing_at).toLocaleDateString(),
        subscriptionId: s.subscription_id,
      },
      replyTo: {
        email: "support@yourdomain.com",
        name: "Support Team",
      },
    };
  }
  return webhook;
}

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

أرسل رسالة إشعار عند فشل الدفع:
payment_failure.js
function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://api.autosend.com/v1/mails/send";
    webhook.payload = {
      to: {
        email: p.customer.email,
        name: p.customer.name,
      },
      from: {
        email: "billing@mail.yourdomain.com",
        name: "Your Company Billing",
      },
      subject: "Payment Failed - Action Required",
      templateId: "A-61522f2xxxxxxxxx",
      dynamicData: {
        customerName: p.customer.name,
        amount: p.amount,
        currency: p.currency,
        failureReason: p.failure_reason,
        paymentId: p.payment_id,
        retryUrl: `https://yourdomain.com/billing/retry/${p.payment_id}`,
      },
      replyTo: {
        email: "billing@yourdomain.com",
        name: "Billing Support",
      },
    };
  }
  return webhook;
}

أفضل الممارسات

  • تحقق من نطاق المرسل الخاص بك: تأكد من أن نطاق البريد الإلكتروني المرسل الخاص بك تم التحقق منه في AutoSend لتحسين إمكانية التسليم وتجنب مشكلات المصادقة. تساعد النطاقات الموثقة في منع رسائل البريد الإلكتروني من الهبوط في مجلدات البريد العشوائي.
  • استخدم بيانات ديناميكية للتخصيص: استخدم حقل dynamicData لتخصيص رسائل البريد الإلكتروني بمعلومات محددة للعملاء مثل الأسماء، ومبالغ الدفع، وتفاصيل الاشتراك. رسائل البريد الإلكتروني المخصصة لها معدلات تفاعل أعلى.
  • اكتب عناوين واضحة: اكتب عناوين وصفية تشير بوضوح إلى غرض البريد الإلكتروني. تجنب كلمات تحفيز البريد العشوائي واحتفظ بالعناوين مختصرة (أقل من 50 حرفًا).
  • اختبر قبل الإنتاج: اختبر دائمًا رسائل البريد الإلكتروني الخاصة بك قبل إرسالها في الإنتاج. يضمن ذلك أن محتوى البريد الإلكتروني يظهر بشكل صحيح وأن جميع البيانات الديناميكية تم تعيينها بشكل صحيح.

مرجع API

للحصول على تفاصيل كاملة حول واجهة برمجة تطبيقات AutoSend، بما في ذلك جميع المعلمات المتاحة وأكواد الأخطاء، قم بزيارة وثائق واجهة برمجة تطبيقات AutoSend.

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

  • تحقق من أن مفتاح API صحيح ونشط
  • تحقق من أن نطاق المرسل موثق في AutoSend
  • تأكد من أن عناوين البريد الإلكتروني للمستلمين صحيحة
  • راجع حدود وإجراءات إرسال AutoSend
  • تحقق من أن عنوان URL لنقطة نهاية API صحيح: https://api.autosend.com/v1/mails/send
  • تحقق من وجود المعلمات المطلوبة في الحمولة
  • تحقق من أن هيكل JSON يتطابق مع تنسيق API الخاص بـ AutoSend
  • تحقق من أن جميع الحقول المطلوبة موجودة (to, from, templateId أو html/text)
  • تأكد من تنسيق عناوين البريد الإلكتروني بشكل صحيح
  • تحقق من أن templateId صالح إذا كنت تستخدم القوالب
  • تحقق من أن مفاتيح dynamicData تتطابق مع متغيرات القالب الخاص بك
  • تحقق من أن معرف القالب الخاص بك صحيح ونشط في AutoSend
  • تأكد من أن مفاتيح dynamicData تتطابق مع المتغيرات المستخدمة في القالب الخاص بك
  • تحقق من أن جميع المتغيرات المطلوبة للقالب متوفرة
  • اختبر القالب الخاص بك بشكل مستقل في لوحة تحكم AutoSend