Inngest

المقدمة

شغّل دوال Inngest والمهام في الخلفية عند حدوث أحداث الدفع. يرسل Dodo Payments كل حدث إلى Inngest، حيث يمكن لدوالك إرسال الإشعارات وتحديث قواعد البيانات وتشغيل سير العمل متعدد الخطوات باستخدام عمليات إعادة المحاولة ومعالجة الأخطاء في Inngest.

تحتاج إلى عنوان URL لـ Inngest webhook. يمكنك إنشاؤه في لوحة معلومات Inngest ضمن Manage → Webhooks.

البدء

Open the Webhook Section

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

Add endpoint dialog with Inngest selected in the Integration dropdown

Select Inngest

في Integration، حدّد Inngest. ضمن Subscribed events، حدّد الأحداث التي يجب أن تؤدي إلى تشغيل دوالك.

Create an Inngest Webhook

في لوحة معلومات Inngest، افتح علامة التبويب Manage وحدّد Webhooks. أنشئ webhook وانسخ عنوان URL الخاص به. يشغّل Inngest دالة التحويل الخاصة بالـ webhook مع كل request، لذا تحقّق من أنها تُبقي حقلي name و data اللذين تتوقعهما دوالك.

Paste Webhook URL

ألصق عنوان URL الخاص بـ Inngest webhook في Endpoint URL.

Configure Transformation

في Transformation code، عدّل الكود لتنسيق الأحداث الخاصة بدوال Inngest. راجع الأمثلة أدناه.

Test & Create

ضمن Test this code، حدّد نوع حدث وانقر على Simulate لتشغيل التحويل مقابل عينة payload. ثم انقر على Create endpoint لتفعيل التكامل.

Done

تؤدي أحداث Dodo Payments الآن إلى تشغيل دوال Inngest الخاصة بك.

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

يعيد كل مثال كتابة webhook.payload في صورة حدث Inngest. يحدد name الحدث الذي تُشغّل عليه دالتك، ويحتوي data على تفاصيل الحدث، ويحتوي user على بيانات العميل، بينما يمثل ts وقت الحدث بالمللي ثانية، وهو ما يتطلبه تنسيق أحداث Inngest.

حمولة الحدث الأساسية

basic_event.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      name: "payment.succeeded",
      data: {
        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"
      },
      user: {
        email: p.customer.email
      },
      ts: new Date(webhook.payload.timestamp).getTime()
    };
  }
  return webhook;
}

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

subscription_event.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        name: "subscription.started",
        data: {
          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
        },
        user: {
          email: s.customer.email
        },
        ts: new Date(webhook.payload.timestamp).getTime()
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        name: "subscription.cancelled",
        data: {
          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
        },
        user: {
          email: s.customer.email
        },
        ts: new Date(webhook.payload.timestamp).getTime()
      };
      break;
  }
  return webhook;
}

معالج أحداث النزاع

يعيد هذا المعالج توجيه كل حدث dispute.* ويضع علامة على dispute.opened باعتباره عاجلًا. لا تتضمن payloads الخاصة بالنزاعات تفاصيل العميل، لذلك لا يرسل كائن user.

dispute_event.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    webhook.payload = {
      name: webhook.eventType,
      data: {
        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"
      },
      ts: new Date(webhook.payload.timestamp).getTime()
    };
  }
  return webhook;
}

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

Payment Processing

إرسال رسائل تأكيد بالبريد الإلكتروني
تحديث سجلات العملاء
معالجة عمليات رد الأموال
إنشاء الفواتير
تحديث المخزون

Subscription Management

الترحيب بالمشتركين الجدد
معالجة عمليات الإلغاء
إرسال تذكيرات التجديد
تحديث دورات الفوترة
معالجة المدفوعات الفاشلة

Analytics & Reporting

تحديث مقاييس الإيرادات
تتبّع سلوك العملاء
إنشاء التقارير
مزامنة البيانات مع منصات التحليلات
احتساب معدلات التسرّب

نصائح

استخدم أسماء أحداث وصفية. يوصي Inngest بوضع بادئة تشير إلى المصدر، مثل dodo/payment.succeeded.
ضع تفاصيل العميل في user، حيث يقوم Inngest بتشفيرها أثناء التخزين.
عيّن ts من timestamp الخاص بـ webhook، بالمللي ثانية، حتى تحافظ الأحداث على ترتيبها ووقتها الأصليين.
استخدم بنية البيانات نفسها عبر الأحداث.
استخدم ميزات إعادة المحاولة ومعالجة الأخطاء في Inngest.

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

Functions not triggering

تحقّق من أن عنوان URL لنقطة النهاية يطابق عنوان URL الخاص بـ Inngest webhook وأن الـ webhook نشط.
تحقّق من أن دالة Inngest منشورة ونشطة.
تحقّق من تطابق أسماء الأحداث مع مشغلات دالتك.
راجع سجلات دالة Inngest بحثًا عن الأخطاء.

Data not received correctly

تحقّق من أن بنية payload تطابق تنسيق أحداث Inngest.
تحقّق من تنسيق أسماء الأحداث بشكل صحيح.
تحقّق من أن دالة التحويل الخاصة بـ Inngest webhook تُبقي الحقول التي يعيّنها تحويل Dodo Payments.
تحقّق من تضمين جميع الحقول المطلوبة.
اختبر باستخدام أداة اختبار webhook في Inngest.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

المقدمة

البدء

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

حمولة الحدث الأساسية

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

معالج أحداث النزاع

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

نصائح

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

​المقدمة

​البدء

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

​حمولة الحدث الأساسية

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

​معالج أحداث النزاع

​حالات الاستخدام الشائعة لـ Inngest

​نصائح

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

المقدمة

البدء

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

حمولة الحدث الأساسية

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

معالج أحداث النزاع

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

نصائح

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