Skip to main content

المقدمة

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

البدء

1

Open the Webhook Section

في لوحة تحكم Dodo Payments، انتقل إلى المطوّر → Webhooks وانقر على إضافة نقطة نهاية.
مربع حوار إضافة نقطة نهاية مع تحديد Teams في القائمة المنسدلة للتكامل
2

Select Microsoft Teams

في قائمة Integration، اختر Teams.
3

Create Teams Webhook

أوقفت Microsoft موصلات Incoming Webhook في Office 365، لذا أنشئ webhook باستخدام تطبيق Workflows:
  1. في Teams، افتح القناة التي ينبغي أن تتلقى الإشعارات.
  2. انقر على ⋯ بجوار اسم القناة واختر Workflows.
  3. اختر القالب Post to a channel when a webhook request is received.
  4. أكّد الفريق والقناة، ثم انقر على Add workflow.
  5. انسخ عنوان 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 لنشر بطاقة نموذجية في قناتك.

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

  • تحقّق من صحة عنوان URL الخاص بـ webhook ومن أن سير العمل مفعّل.
  • تحقّق من أن التحويل يعيد JSON صالحًا لـ Adaptive Card.
  • تحقّق من أن سير العمل لديه الإذن بالنشر في القناة.
  • شغّل التحويل ضمن Test this code وتحقّق من النتيجة مقابل مخطط Adaptive Card.
  • تحقّق من وجود جميع الحقول المطلوبة.
  • تحقّق من أن قيم الألوان صالحة، مثل Default، أو Good، أو Warning، أو Attention.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦