كيف يمكننا مساعدتك؟

عند الإبلاغ عن مشكلة تكامل، فإن تقديم معلومات واضحة وذات صلة يساعد فريق الدعم على فهم الخدمة المتأثرة، وإعادة إنتاج المشكلة عند الإمكان، وتحديد السبب المحتمل. يجب أن تصف طلب الدعم المفيد ما حاولت القيام به، وما كنت تتوقعه، وما حدث بالفعل. المعلومات التي يجب تضمينها 1. اسم التكامل حدد التطبيق أو الخدمة الخارجية المعنية. 2. وصف المشكلة اشرح العملية التي فشلت أو التي أنتجت نتيجة غير متوقعة. 3. السلوك المتوقع صف ما كان يجب أن يحدث. 4. السلوك الفعلي صف ما حدث بدلاً من ذلك. 5. رسالة الخطأ قم بتضمين نص الخطأ الدقيق أو رمز الحالة إذا كان متاحًا. 6. الطابع الزمني التقريبي قدم التاريخ والوقت والمنطقة الزمنية عندما حدثت المشكلة. 7. العملية المتأثرة حدد الإجراء المتعلق بالتكامل، أو سير العمل، أو الأتمتة، أو العملية التجارية ذات الصلة. 8. التكرار اشرح ما إذا كانت المشكلة تحدث باستمرار أو بشكل متقطع. 9. التغييرات الأخيرة اذكر التغييرات الأخيرة في الحساب، أو الأذونات، أو التكوين، أو التفويض. 10. استكشاف الأخطاء الذي تم القيام به مسبقًا صف الخطوات التي تم اتخاذها قبل الاتصال بالدعم. 11. تأثير العمل اشرح ما إذا كانت المشكلة تمنع عملية حاسمة، أو تؤثر على العملاء، أو تسبب تأخيرات. 12. الأدلة الداعمة قم بتضمين لقطات شاشة ذات صلة أو تفاصيل تشخيص غير حساسة عند توفرها. مثال على طلب الدعم الموضوع: مشكلة اتصال التكامل التكامل: [اسم الخدمة الخارجية] العملية المتأثرة: [وصف العملية] بدأت المشكلة: [التاريخ والوقت مع المنطقة الزمنية] النتيجة المتوقعة: [ما يجب أن يحدث] النتيجة الفعلية: [ما حدث] رسالة الخطأ: [نص رسالة الخطأ الدقيق] التغييرات الأخيرة: [التغييرات ذات الصلة، إن وجدت] استكشاف الأخطاء المكتملة: [الخطوات التي تم اتخاذها مسبقًا] تأثير العمل: [وصف العمليات المتأثرة] ما المعلومات التي يجب ألا يتم مشاركتها أبدًا؟ لا تتضمن: 1. كلمات المرور. 2. مفاتيح API. 3. رموز الوصول OAuth. 4. رموز تحديث OAuth. 5. أسرار العميل. 6. أسرار توقيع Webhook. 7. بيانات اعتماد المصادقة الخاصة. 8. معلومات شخصية غير ضرورية عن العملاء. 9. سجلات تجارية حساسة غير مرتبطة بالمشكلة. إذا كانت لقطة الشاشة تحتوي على معلومات سرية، قم بتعتيمها قبل المشاركة. هل يجب أن أفصل التكامل قبل الاتصال بالدعم؟ ليس تلقائيًا. فصل أو إعادة تفويض التكامل قد يغير حالته ويجعل التحقيق في المشكلة الأصلية أكثر صعوبة. إذا كان التكامل مشبوهًا بنشاط غير مصرح به، فقم بإعطاء الأولوية للاحتواء الأمني المناسب. ماذا لو كانت المشكلة تؤثر على عملية تجارية مهمة؟ صف بوضوح تأثير العمل وما إذا كانت العملية محجوبة تمامًا أو متأثرة جزئيًا فقط. ماذا لو كان المزود الخارجي يعاني من انقطاع؟ قم بتضمين أي معلومات ذات صلة عن حالة المزود ووقت بدء المشكلة التقريبي. هل يمكن للدعم ضمان استعادة العمليات الخارجية الفاشلة؟ تعتمد الاستعادة على العملية، وسلوك المزود الخارجي، وآليات إعادة المحاولة أو الاستعادة المتاحة. لا تفترض أن كل عملية فاشلة يمكن إعادة تشغيلها تلقائيًا. النهج الموصى به قدّم تقريرًا موجزًا ولكن كاملًا مع الخطأ الدقيق، والتكامل المتأثر، والطوابع الزمنية ذات الصلة، وتأثير العمل. يساعد ذلك في تقليل الذهاب والإياب غير الضروري ويدعم تحقيقًا أكثر فعالية.