Skip to main content

المقدمة

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

البدء

1

Open the Webhook Section

في لوحة تحكم Dodo Payments، انتقل إلى Developer → Webhooks وانقر على Add endpoint.
Add endpoint dialog with n8n selected in the Integration dropdown
2

Select n8n

في قائمة Integration، حدّد n8n.
3

Create Webhook in n8n

في n8n، أنشئ تدفق عمل وأضف عقدة Webhook كمشغّل. اضبط HTTP Method على POST، ثم انسخ Production URL. لا يستقبل عنوان URL للاختبار الأحداث إلا عندما يكون n8n في وضع الاستماع لحدث اختباري.
4

Paste Webhook URL

الصق عنوان URL للإنتاج الخاص بـ n8n في حقل Endpoint URL.
5

Configure Transformation

عدّل الرمز البرمجي ضمن Transformation code لتشكيل البيانات وفقًا لتدفق عمل n8n. ابدأ من الأمثلة أدناه.
6

Test & Create

ضمن Test this code، شغّل التحويل باستخدام حمولة نموذجية، ثم انقر على Create endpoint.
7

Publish the Workflow

في n8n، انشر تدفق العمل. يسجّل n8n عنوان URL للإنتاج الخاص بـ webhook فقط عند نشر تدفق العمل.
8

Done

تؤدي أحداث الدفع الآن إلى تشغيل تدفقات عمل n8n.

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

يحوّل كل مثال حدثًا من Dodo Payments إلى كائن JSON صغير يمكن لعقد n8n قراءته مباشرةً.

حمولة Webhook الأساسية

يرسل هذا المثال مبلغ الدفع والعملة والعميل وطريقة الدفع عند نجاح عملية الدفع.
basic_webhook.js

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

يرسل هذا المثال حدث subscription_started أو subscription_cancelled، بحيث يمكن لتدفق عمل واحد التفرّع استنادًا إلى event_type.
subscription_webhook.js

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

يرسل هذا المثال كل حدث dispute.*، ويضبط urgent على true عند فتح نزاع.
dispute_webhook.js

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

فيما يلي بعض تدفقات العمل الشائعة التي ينشئها التجار استنادًا إلى أحداث Dodo Payments.
  • إرسال رسائل بريد إلكتروني عبر Gmail أو Outlook لتأكيد عمليات الدفع.
  • إنشاء سلاسل رسائل بريد إلكتروني في Mailchimp أو ConvertKit.
  • إرسال إشعارات إلى Slack أو Discord عبر webhooks.
  • إنشاء سجلات في Google Sheets.
  • إرسال رسائل عبر Telegram أو WhatsApp.
  • إضافة جهات اتصال إلى HubSpot أو Salesforce.
  • إنشاء صفقات في Pipedrive أو Close.
  • تحديث سجلات العملاء في Airtable.
  • تسجيل الأنشطة في Monday.com.
  • مزامنة البيانات مع قواعد بيانات PostgreSQL أو MySQL.
  • إنشاء مهام في Asana أو Trello.
  • إضافة عناصر مهام في Notion.
  • إنشاء أحداث في Google Calendar.
  • إرسال إشعارات SMS عبر Twilio.
  • إنشاء مشكلات في GitHub للنزاعات.
  • تحويل بيانات الدفع وإثراؤها.
  • تخزين الأحداث في قواعد بيانات مثل PostgreSQL أو MongoDB.
  • تجميع المقاييس والتحليلات.
  • إنشاء التقارير وعمليات التصدير.
  • تشغيل تدفقات عمل متعددة الخطوات.

نصائح

  • حافظ على بساطة بنية الحمولة حتى تتمكن عقد n8n من تحليلها.
  • استخدم أسماء الحقول نفسها في جميع الأحداث.
  • أدرج الطوابع الزمنية لتوقيت تدفق العمل وجدولته.
  • اختبر تدفق العمل باستخدام بيانات نموذجية قبل نشره.
  • استخدم عقدة IF للمنطق الشرطي والتوجيه.
  • استخدم عقدة Code لتحويلات البيانات المخصصة.
  • استخدم عقدة Switch لتوجيه كل نوع من الأحداث إلى مساره الخاص.
  • أعدّ تدفق عمل لمعالجة الأخطاء في n8n لالتقاط عمليات التنفيذ الفاشلة.

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

  • تحقّق من أن نقطة النهاية تستخدم عنوان URL للإنتاج الخاص بـ n8n، ومن إمكانية الوصول إلى n8n عبر الإنترنت.
  • تحقّق من نشر تدفق العمل في n8n.
  • تحقّق من أن HTTP Method لعقدة Webhook هو POST.
  • تحقّق من وجود طلبات واردة في علامة التبويب Executions الخاصة بتدفق العمل.
  • تحقّق من أن إعدادات جدار الحماية والشبكة تسمح بوصول webhooks الواردة.
  • إذا كانت عقدة Webhook تتطلب المصادقة، فأضف الرأس المطابق إلى نقطة النهاية ضمن الرؤوس المخصصة.
  • تحقّق من أسماء الحقول في إعدادات عقد n8n.
  • تحقّق من تطابق أنواع البيانات مع التنسيقات التي تتوقعها العقد.
  • استخدم عنوان URL للاختبار في n8n لفحص البيانات الواردة.
  • تحقّق من أن رمز التحويل البرمجي يعيد JSON صالحًا.
  • تحقّق من إعدادات استجابة عقدة Webhook.
  • استخدم عقدة Edit Fields (Set) لإعادة تسمية الحقول أو إعادة هيكلتها.
  • راجع سجلات التنفيذ في n8n للاطلاع على رسائل الخطأ التفصيلية.
  • تحقّق من إعدادات اتصال العقد وبيانات الاعتماد.
  • تحقّق من وجود جميع الحقول المطلوبة في الحمولة.
  • اختبر العقد الفردية باستخدام بيانات نموذجية.
  • فعّل تدفق عمل لمعالجة الأخطاء لالتقاط حالات الفشل ومعالجتها.
  • تحقّق من حدود المعدل وحصص API للخدمات المتصلة.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦