المقدمة
أرسل رسائل بريد إلكتروني معاملات احترافية تلقائيًا عند حدوث أحداث الدفع والاشتراك. قم بتوصيل تأكيدات الدفع، تحديثات الاشتراك، وإشعارات الفشل من خلال Keplars دون الحاجة إلى خادم وسيط. يقوم Dodo Payments باستدعاء API الخاص بـ Keplars مباشرةً باستخدام معالج تحويل JavaScript.هذه التكامل يتطلب مفتاح API الخاص بـ Keplars للمصادقة. يمكنك العثور عليه في لوحة تحكم Keplars تحت الإعدادات → مفاتيح API، والتحقق من نطاق أو عنوان المرسل تحت النطاقات.
كيفية البدء
1
Open the Webhook Section
في لوحة تحكم Dodo Payments، انتقل إلى Webhook → + إضافة نقطة نهاية وقم بتوسيع قائمة التكاملات.
2
Select Keplars
اختر بطاقة تكامل Keplars.

3
Enter API Key
قدم مفتاح API الخاص بك لـ Keplars. يتم إرساله كرمز Bearer في كل طلب.

4
Configure Transformation
قم بتحرير كود التحويل لتنسيق الرسائل الإلكترونية لـ Keplars. استبدل عنوان المرسل المؤقت ومعرفات القوالب الخاصة بك.
5
Test & Create
اختبر مع نماذج بيانات وانقر على إنشاء لتفعيل إرسال البريد الإلكتروني.
6
Done!
🎉 ستقوم أحداث الدفع الآن تلقائيًا بتشغيل رسائل البريد الإلكتروني المعاملات عبر Keplars.
أمثلة كود التحويل
كل معالج يضبطwebhook.url إلى نقطة الإرسال ذات الأولوية العالية في Keplars ويعيد كتابة webhook.payload إلى طلب Keplars (يتم إرسال مفتاح API تلقائيًا كرمز Bearer). استبدل payments@mail.yourdomain.com بمرسل مؤكد و your-keplars-*-template-id بمعرفات القوالب الخاصة بك.
بريد تأكيد الدفع
payment_succeeded.js
إشعار فشل الدفع
payment_failed.js
بريد الترحيب بالاشتراك
subscription_active.js
بريد إلغاء الاشتراك
subscription_cancelled.js
نصائح
- استخدم نطاق أو عنوان مرسل مؤكد لتحسين قابلية التسليم.
- أنشئ قالب Keplars مخصص لكل نوع حدث بحيث يبقى كل بريد إلكتروني متسقًا مع العلامة التجارية والرسالة.
- اجعل كل بريد إلكتروني شخصيًا بإرسال بيانات العملاء مثل الاسم والمبلغ ومعرف الدفع عبر
params. - جرب في وضع التجارب أولاً. الإرسال في وضع التجارب يتم احتجازه في صندوق الاختبارات لـ Keplars بدلاً من التسليم.
استكشاف الأخطاء وإصلاحها
Emails not being sent
Emails not being sent
- تحقق من أن مفتاح API الخاص بك صحيح ونشط في Keplars تحت الإعدادات → مفاتيح API.
- تحقق من أن نطاق أو عنوان المرسل الخاص بك مؤكد.
- تعرض Dodo Payments استجابة خطأ Keplars الخام في سجل تسليم الويب هوك. تحقق منه للحصول على التفاصيل.
Template not found
Template not found
- يجب أن تتطابق
template_idفي معالجك مع قالب نشط في حساب Keplars الخاص بك. تحقق من المعرف (وأنه نشط) في لوحة التحكم.
Wrong event triggered
Wrong event triggered
- كل معالج يتحقق من
webhook.eventTypeويعود مبكرًا إذا لم يتطابق. تأكد من أن الأحداث الصحيحة مشترك فيها على نقطة نهاية ويب هوك Dodo Payments.