المقدمة
اربط Dodo Payments بآلاف التطبيقات عبر Zapier. يمكن لكل حدث من Dodo Payments بدء Zap يرسل بريدًا إلكترونيًا، أو يضيف صفًا إلى جدول بيانات، أو ينشئ مهمة، أو يحدّث سجلًا في CRM.يرسل موصل Zapier كل حدث إلى عنوان webhook الخاص بـ Zap الذي يبدأ باستخدام Webhooks by Zapier. لا يتوفر Webhooks by Zapier في خطة Zapier المجانية، لذلك تحتاج إلى خطة Zapier مدفوعة. وتحتاج أيضًا إلى الوصول إلى Developer → Webhooks في لوحة تحكم Dodo Payments.
البدء
1
Open the Webhook Section
في لوحة تحكم Dodo Payments، انتقل إلى المطوّر → Webhooks وانقر على إضافة نقطة نهاية.

2
Select Zapier
ضمن Integration، اختر Zapier. تحمّل لوحة التحكم رمز التحويل الخاص بـ Zapier وتعرض خطوات الإعداد في لوحة How to connect Zapier.
3
Create Zap in Zapier
في Zapier، أنشئ Zap. بالنسبة إلى المشغّل، اختر Webhooks by Zapier، ثم اختر حدث Catch Hook وانقر على Continue. في علامة التبويب Test الخاصة بالمشغّل، انسخ عنوان webhook.
4
Paste Webhook URL
الصق عنوان webhook الخاص بـ Zapier في Endpoint URL. لا يحتوي موصل Zapier على حقل API key.
5
Select Events
تعرض Subscribed events الأحداث التي يدعمها موصل Zapier. احتفظ فقط بالأحداث التي يعالجها التحويل لديك. يقبل Zapier أي JSON، لذلك يظل الحدث الذي يتركه التحويل دون تغيير مشغّلًا لـ Zap، مع حمولة Dodo Payments الأصلية.
6
Configure Transformation
ضمن Transformation code، عدّل المعالج لإرسال الحقول التي يستخدمها Zap لديك. ابدأ من الأمثلة.
7
Test & Create
ضمن Test this code، اختر نوع حدث وانقر على Simulate لمعاينة الحمولة. ثم انقر على Create endpoint.
8
Done
تصل الأحداث المشترَك فيها الآن إلى Zap. لتحميل حقول نموذجية إلى Zapier، افتح علامة التبويب Testing الخاصة بنقطة النهاية، واختر نوع حدث، وانقر على Send example. في Zapier، انقر على Test trigger، وعيّن الحقول في خطوات الإجراء، ثم انشر Zap.
أمثلة على Transformation Code
يستبدل كل معالجwebhook.payload بكائن مسطّح ويحافظ على webhook.url، وهو عنوان webhook الخاص بـ Zapier. تكون مبالغ Dodo Payments بوحدة العملة الأصغر، لذلك تقسم الأمثلة المبلغ على 100 وترسل النتيجة كسلسلة نصية، مثل "25.00". بالنسبة إلى العملات ذات المنازل العشرية الصفرية مثل JPY وKRW، استخدم المبلغ كما هو.
حمولة Webhook أساسية
أرسل تفاصيل دفعة ناجحة:basic_webhook.js
معالج أحداث الاشتراك
أرسل حدثsubscription_started أو subscription_cancelled عندما يصبح الاشتراك نشطًا أو يُلغى:
subscription_webhook.js
معالج تنبيهات النزاعات
أرسل كل حدث من أحداث النزاع، مع تعيينurgent إلى true عند فتح نزاع:
dispute_webhook.js
حالات استخدام Zapier الشائعة
Email Notifications
Email Notifications
- أرسل رسائل بريد إلكتروني عبر Gmail أو Outlook لتأكيد المدفوعات
- أضف العملاء إلى سلاسل رسائل البريد الإلكتروني في Mailchimp أو ConvertKit
- أرسل إشعارات Slack أو Discord
- أضف صفوفًا إلى Google Sheets
CRM Updates
CRM Updates
- أضف جهات اتصال إلى HubSpot أو Salesforce
- أنشئ صفقات في Pipedrive أو Close
- حدّث سجلات العملاء في Airtable
- سجّل الأنشطة في Monday.com
Task Management
Task Management
- أنشئ مهامًا في Asana أو Trello
- أضف عناصر مهام في Notion
- أنشئ أحداثًا في التقويم
- أرسل رسائل SMS عبر Twilio
نصائح
- حافظ على تسطيح الحمولة، بحيث يسهل العثور على كل حقل عند تعيينه في Zapier.
- استخدم أسماء الحقول نفسها عبر الأحداث، حتى يتمكن Zap واحد من معالجة عدة أنواع من الأحداث.
- أدرج
timestamp، حتى يتمكن Zap من تسجيل وقت وقوع كل حدث. - بعد تغيير التحويل، أرسل مثالًا جديدًا واختبر المشغّل مرة أخرى في Zapier، حتى يحمّل الحقول الجديدة.
- لتشغيل الخطوات اللاحقة لبعض الأحداث فقط، أضف خطوة Filter by Zapier تتحقق من
event_type. - لتخطي حدث في الرمز، عيّن
webhook.cancel = trueقبل إرجاع webhook. تسجّل السجلات عملية التسليم المتخطاة على أنها ناجحة.
استكشاف الأخطاء وإصلاحها
Zap Not Triggering
Zap Not Triggering
- تحقّق من أن Endpoint URL يطابق عنوان webhook الموجود في علامة التبويب Test الخاصة بالمشغّل. يتغير العنوان عند نقل Zap إلى مستخدم آخر في Zapier.
- تحقّق من نشر Zap وتشغيله. يعرض Zapier
404عندما يكون Zap متوقفًا أو محذوفًا، لكن قد يستمر العنوان في إرجاع200لمدة تصل إلى عدة ساعات بعد التغيير. - افتح علامة التبويب Logs ضمن Developer → Webhooks لرؤية استجابة Zapier لكل عملية تسليم.
- تحقّق من تحديد الحدث في Subscribed events. لتغيير التحديد، افتح نقطة النهاية وانقر على Edit.
Data Not Mapping Correctly
Data Not Mapping Correctly
- تحقّق من أن أسماء الحقول في خطوات الإجراء تطابق المفاتيح التي يرسلها التحويل لديك.
- تحقّق من أن نوع كل قيمة يطابق النوع الذي يتوقعه الإجراء. ترسل الأمثلة المبالغ كسلاسل نصية.
- تحقّق من أن المعالج يعيد
webhookوأنwebhook.payloadكائن JSON. إذا كانت الحمولة مصفوفة، يشغّل Zapier الـ Zap مرة لكل عنصر. - استخدم Test trigger في Zapier لرؤية حقول أحدث حدث.