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

المقدمة

تتيح لك تكامل 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: "[email protected]",
        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: "[email protected]",
        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: "[email protected]",
        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: "[email protected]",
        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: "[email protected]",
        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: "[email protected]",
        name: "Billing Support",
      },
    };
  }
  return webhook;
}

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

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

مرجع API

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

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

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