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

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.Email Notifications
Email Notifications
- إرسال رسائل بريد إلكتروني عبر Gmail أو Outlook لتأكيد عمليات الدفع.
- إنشاء سلاسل رسائل بريد إلكتروني في Mailchimp أو ConvertKit.
- إرسال إشعارات إلى Slack أو Discord عبر webhooks.
- إنشاء سجلات في Google Sheets.
- إرسال رسائل عبر Telegram أو WhatsApp.
CRM Updates
CRM Updates
- إضافة جهات اتصال إلى HubSpot أو Salesforce.
- إنشاء صفقات في Pipedrive أو Close.
- تحديث سجلات العملاء في Airtable.
- تسجيل الأنشطة في Monday.com.
- مزامنة البيانات مع قواعد بيانات PostgreSQL أو MySQL.
Task Management
Task Management
- إنشاء مهام في Asana أو Trello.
- إضافة عناصر مهام في Notion.
- إنشاء أحداث في Google Calendar.
- إرسال إشعارات SMS عبر Twilio.
- إنشاء مشكلات في GitHub للنزاعات.
Data Processing
Data Processing
- تحويل بيانات الدفع وإثراؤها.
- تخزين الأحداث في قواعد بيانات مثل PostgreSQL أو MongoDB.
- تجميع المقاييس والتحليلات.
- إنشاء التقارير وعمليات التصدير.
- تشغيل تدفقات عمل متعددة الخطوات.
نصائح
- حافظ على بساطة بنية الحمولة حتى تتمكن عقد n8n من تحليلها.
- استخدم أسماء الحقول نفسها في جميع الأحداث.
- أدرج الطوابع الزمنية لتوقيت تدفق العمل وجدولته.
- اختبر تدفق العمل باستخدام بيانات نموذجية قبل نشره.
- استخدم عقدة IF للمنطق الشرطي والتوجيه.
- استخدم عقدة Code لتحويلات البيانات المخصصة.
- استخدم عقدة Switch لتوجيه كل نوع من الأحداث إلى مساره الخاص.
- أعدّ تدفق عمل لمعالجة الأخطاء في n8n لالتقاط عمليات التنفيذ الفاشلة.
استكشاف الأخطاء وإصلاحها
Workflow Not Triggering
Workflow Not Triggering
- تحقّق من أن نقطة النهاية تستخدم عنوان URL للإنتاج الخاص بـ n8n، ومن إمكانية الوصول إلى n8n عبر الإنترنت.
- تحقّق من نشر تدفق العمل في n8n.
- تحقّق من أن HTTP Method لعقدة Webhook هو
POST. - تحقّق من وجود طلبات واردة في علامة التبويب Executions الخاصة بتدفق العمل.
- تحقّق من أن إعدادات جدار الحماية والشبكة تسمح بوصول webhooks الواردة.
- إذا كانت عقدة Webhook تتطلب المصادقة، فأضف الرأس المطابق إلى نقطة النهاية ضمن الرؤوس المخصصة.
Data Not Mapping Correctly
Data Not Mapping Correctly
- تحقّق من أسماء الحقول في إعدادات عقد n8n.
- تحقّق من تطابق أنواع البيانات مع التنسيقات التي تتوقعها العقد.
- استخدم عنوان URL للاختبار في n8n لفحص البيانات الواردة.
- تحقّق من أن رمز التحويل البرمجي يعيد JSON صالحًا.
- تحقّق من إعدادات استجابة عقدة Webhook.
- استخدم عقدة Edit Fields (Set) لإعادة تسمية الحقول أو إعادة هيكلتها.
Workflow Execution Errors
Workflow Execution Errors
- راجع سجلات التنفيذ في n8n للاطلاع على رسائل الخطأ التفصيلية.
- تحقّق من إعدادات اتصال العقد وبيانات الاعتماد.
- تحقّق من وجود جميع الحقول المطلوبة في الحمولة.
- اختبر العقد الفردية باستخدام بيانات نموذجية.
- فعّل تدفق عمل لمعالجة الأخطاء لالتقاط حالات الفشل ومعالجتها.
- تحقّق من حدود المعدل وحصص API للخدمات المتصلة.