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

المقدمة

قم بربط مدفوعات Dodo مع الآلاف من التطبيقات والخدمات من خلال Zapier. قم بأتمتة سير العمل عن طريق تشغيل Zaps عند حدوث أحداث الدفع، من إرسال رسائل البريد الإلكتروني إلى تحديث جداول البيانات، وإنشاء المهام، والمزيد.
تتطلب هذه التكامل عنوان URL لواجهة برمجة التطبيقات من إعداد Zap الخاص بك.

البدء

1

افتح قسم واجهة برمجة التطبيقات

في لوحة معلومات مدفوعات Dodo، انتقل إلى Webhooks → + إضافة نقطة نهاية وقم بتوسيع قائمة التكاملات.
إضافة نقطة نهاية وقائمة التكاملات
2

اختر Zapier

اختر بطاقة تكامل Zapier.
3

إنشاء Zap في Zapier

في Zapier، قم بإنشاء Zap جديد مع “Webhooks by Zapier” كالمشغل. انسخ عنوان URL لواجهة برمجة التطبيقات.
4

ألصق عنوان URL لواجهة برمجة التطبيقات

ألصق عنوان URL لواجهة برمجة التطبيقات الخاصة بـ Zapier في إعداد نقطة النهاية.
5

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

قم بتحرير كود التحويل لتنسيق البيانات لسير عمل Zapier الخاص بك.
6

اختبر وأنشئ

اختبر باستخدام بيانات عينة وانقر على إنشاء لتفعيل التكامل.
7

تم!

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

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

حمولة واجهة برمجة التطبيقات الأساسية

basic_webhook.js
function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      event_type: webhook.eventType,
      payment_id: p.payment_id,
      amount: (p.total_amount / 100).toFixed(2),
      currency: p.currency || "USD",
      customer_email: p.customer.email,
      customer_name: p.customer.name,
      payment_method: p.payment_method || "unknown",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

معالج أحداث الاشتراك

subscription_webhook.js
function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        event_type: "subscription_started",
        subscription_id: s.subscription_id,
        customer_email: s.customer.email,
        customer_name: s.customer.name,
        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,
        timestamp: webhook.payload.timestamp
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        event_type: "subscription_cancelled",
        subscription_id: s.subscription_id,
        customer_email: s.customer.email,
        cancelled_at: s.cancelled_at,
        cancel_at_next_billing: s.cancel_at_next_billing_date,
        timestamp: webhook.payload.timestamp
      };
      break;
  }
  return webhook;
}

معالج تنبيه النزاع

dispute_webhook.js
function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    webhook.payload = {
      event_type: webhook.eventType,
      dispute_id: d.dispute_id,
      payment_id: d.payment_id,
      amount: (d.amount / 100).toFixed(2),
      status: d.dispute_status,
      stage: d.dispute_stage,
      remarks: d.remarks || "",
      urgent: webhook.eventType === "dispute.opened",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

حالات استخدام Zapier الشائعة

  • إرسال رسائل بريد إلكتروني عبر Gmail/Outlook لتأكيدات الدفع
  • إنشاء تسلسلات بريد إلكتروني في Mailchimp/ConvertKit
  • إرسال إشعارات عبر Slack/Discord
  • إنشاء سجلات في Google Sheets
  • إضافة جهات الاتصال إلى HubSpot/Salesforce
  • إنشاء صفقات في Pipedrive/Close
  • تحديث سجلات العملاء في Airtable
  • تسجيل الأنشطة في Monday.com
  • إنشاء مهام في Asana/Trello
  • إضافة عناصر قائمة المهام في Notion
  • إنشاء أحداث تقويمية
  • إرسال إشعارات SMS عبر Twilio

نصائح

  • احتفظ بهيكل الحمولة بسيطًا لسهولة تحليل Zapier
  • استخدم أسماء حقول متسقة عبر جميع الأحداث
  • تضمين الطوابع الزمنية لتوقيت سير العمل
  • اختبر Zap الخاص بك باستخدام بيانات عينة قبل الذهاب للعرض
  • استخدم الفلاتر المدمجة في Zapier للمنطق الشرطي

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

  • تحقق من أن عنوان URL لواجهة برمجة التطبيقات صحيح ونشط
  • تحقق من أن Zap مفعل في Zapier
  • تأكد من أن هيكل الحمولة يتطابق مع توقعات Zapier
  • اختبر تسليم واجهة برمجة التطبيقات في لوحة معلومات Zapier
  • تحقق من أسماء الحقول في خطوات إجراء Zapier
  • تحقق من أن أنواع البيانات تتطابق مع التنسيقات المتوقعة
  • استخدم ميزة الاختبار في Zapier لاستكشاف الأخطاء في المطابقة
  • تأكد من أن كود التحويل يعيد JSON صالح