المقدمة
يعمل تكامل Microsoft Teams على نشر أحداث Dodo Payments في قناة Teams كبطاقات Adaptive Cards، ليتمكن فريقك من رؤية المدفوعات وتغييرات الاشتراكات والنزاعات فور حدوثها. استخدمه عندما تكون Teams هي المنصة التي يعمل عليها فريق عملك.يفترض هذا الدليل أن لديك صلاحية المسؤول لإنشاء ويب هوكس في مساحة عمل Microsoft Teams الخاصة بك.
البدء
1
Open the Webhook Section
في لوحة تحكم Dodo Payments، انتقل إلى المطوّر → Webhooks وانقر على إضافة نقطة نهاية.

2
Select Microsoft Teams
في قائمة Integration، اختر Teams.
3
Create Teams Webhook
أوقفت Microsoft موصلات Incoming Webhook في Office 365، لذا أنشئ webhook باستخدام تطبيق Workflows:
- في Teams، افتح القناة التي ينبغي أن تتلقى الإشعارات.
- انقر على ⋯ بجوار اسم القناة واختر Workflows.
- اختر القالب Post to a channel when a webhook request is received.
- أكّد الفريق والقناة، ثم انقر على Add workflow.
- انسخ عنوان URL الخاص بـ webhook الذي تعرضه Teams.
4
Paste Webhook URL
الصق عنوان URL الخاص بـ webhook في Teams في حقل Endpoint URL.
5
Customize Transformation
حرّر التعليمات البرمجية ضمن Transformation code لتنسيق كل حدث كبطاقة Adaptive Card. ابدأ من الأمثلة أدناه.
6
Test & Create
ضمن Test this code، شغّل التحويل باستخدام حمولة نموذجية، ثم انقر على Create endpoint.
7
Done
ستتلقى قناة Teams الآن أحداث Dodo Payments كبطاقات Adaptive Cards.
أمثلة على Transformation Code
يستبدل كل مثال حمولة الحدث برسالة Teams تحتوي على مرفق واحد من نوع Adaptive Card.بطاقة دفع أساسية
ينشر هذا المثال المبلغ والبريد الإلكتروني للعميل ومعرّف الدفع عند نجاح عملية الدفع.payment_card.js
إدارة الاشتراكات
ينشر هذا المثال بطاقة عند تفعيل الاشتراك، وبطاقة أخرى عند إلغائه.subscription_card.js
تنبيهات النزاعات
ينشر هذا المثال بطاقة لكل حدثdispute.*. ويتغير العنوان واللون عندما تتم تسوية النزاع لصالحك أو خسارته.
dispute_card.js
نصائح
- استخدم Adaptive Cards للتنسيق الغني والتفاعلي.
- اختر الألوان وفقًا للمعنى:
Good(أخضر)، وWarning(أصفر)، وAttention(أحمر). - اجعل مجموعات الحقائق قصيرة وسهلة القراءة.
- قبل الاعتماد على نقطة النهاية، افتح علامة التبويب Testing وانقر على Send example لنشر بطاقة نموذجية في قناتك.
استكشاف الأخطاء وإصلاحها
No Messages in Teams
No Messages in Teams
- تحقّق من صحة عنوان URL الخاص بـ webhook ومن أن سير العمل مفعّل.
- تحقّق من أن التحويل يعيد JSON صالحًا لـ Adaptive Card.
- تحقّق من أن سير العمل لديه الإذن بالنشر في القناة.
Card Formatting Issues
Card Formatting Issues
- شغّل التحويل ضمن Test this code وتحقّق من النتيجة مقابل مخطط Adaptive Card.
- تحقّق من وجود جميع الحقول المطلوبة.
- تحقّق من أن قيم الألوان صالحة، مثل
Default، أوGood، أوWarning، أوAttention.