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

المقدمة

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

البدء

1

Open the Webhook Section

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

Select Zapier

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

Create Zap in Zapier

في Zapier، أنشئ Zap جديدًا مع “Webhooks by Zapier” كحدث تشغيل. انسخ عنوان ويب هوك.
4

Paste Webhook URL

الصق عنوان ويب هوك من Zapier في تكوين نقطة النهاية.
5

Configure Transformation

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

Test & Create

اختبر باستخدام بيانات حملات تجريبية وانقر على Create لتنشيط التكامل.
7

Done!

🎉 ستقوم أحداث الدفع الآن بتشغيل سير عمل 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 للمنطق الشرطي

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

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