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

تغطي هذه الصفحة مشكلات الاتصال والتفويض الشائعة في Atoms. لإعدادات خاصة بخدمة معينة، أو الإجراءات المدعومة، أو التكوين داخل تطبيقك، ابدأ من Connect and Manage Integrations واختر دليل خدمتك.

ابدأ بعمليات التحقق هذه

1. تحقق من موضع حدوث الفشل. هل يتعذر على Agent استخدام خدمة في Chat، أم أن الميزة تفشل فقط داخل تطبيقك؟ إن توصيل خدمة من أجل Chat لا يؤكد بحد ذاته أن تطبيقك مُكوَّن بشكل صحيح. إذا كانت حالات الفشل داخل التطبيق فقط، فراجع Connect and Manage Integrations.
2. افتح التكامل. في Chat الخاص بمشروعك، افتح قائمة الخيارات بجانب حقل إدخال الرسائل، ثم اختر Connectors → Add connectors. ابحث عن الخدمة وحددها. تحقق مما إذا كانت متصلة أو ما تزال تعرض Connect. تفتح بعض الخدمات شاشة الإدارة الخاصة بها.
3. تحقق من الوصول داخل الخدمة نفسها. أكِّد أن الحساب الذي كنت تنوي ربطه يمكنه فتح الملف أو المستودع أو التقويم أو الخاصية أو أي مورد آخر معني بالأمر.
4. احفظ الخطأ قبل تغيير أي شيء. سجّل الرسالة الدقيقة، والوقت والمنطقة الزمنية، والمشروع أو Chat المتأثر، وآخر محاولة ناجحة. احذف المعلومات الخاصة من لقطات الشاشة.

افتح خيارات إدخال Chat، واختر Connectors (1)، ثم Add connectors (2) لاستعراض عمليات التكامل المتاحة.

يمكنك أيضًا إدارة الاتصالات المتاحة في Settings → Connectors. حدِّد التكامل الذي تريد التحقق منه.

حافظ على خصوصية بيانات الاعتماد. لا تلصق كلمات المرور أو رموز تسجيل الدخول أو مفاتيح API أو Tokens الوصول أو أي أسرار أخرى في Chat أو في طلب دعم. أدخل بيانات الاعتماد فقط ضمن تدفق تسجيل الدخول الخاص بالخدمة أو في حقل التكوين الآمن المخصص.

اعثر على مشكلتك

ما الذي تراه	من أين تبدأ
خدمة مفقودة، أو عناصر التحكم الخاصة بها غير متاحة	العثور على تكامل أو بدءه
لا يفتح تسجيل الدخول، أو يتم حظره، أو لا يكتمل أبدًا	إكمال التفويض
يستخدم الاتصال حسابًا مختلفًا	التحقق من الحساب المتصل
متصل، لكن Agent لا يمكنه العثور على مورد	التحقق من الاتصال والوصول إلى البيانات
تعمل القراءة، لكن الإنشاء أو التعديل يفشل	التحقق من أذونات الكتابة والإجراءات المدعومة
اتصال كان يعمل سابقًا أصبح يفشل	التحقق مما تغيّر
النتائج قديمة، أو تنتهي مهلة الطلبات، أو تتكرر الأخطاء	التحقق من الطلب وتوفر الخدمة

لا يمكنك العثور على تكامل أو بدءه

1. استخدم Add connectors للبحث في الكتالوج. القائمة الأقصر في قائمة Chat ليست الكتالوج الكامل.
2. إذا أخبرك Atoms أن الميزة متاحة فقط داخل مشروع، فافتح المشروع المقصود وجرّب هناك.
3. إذا كان عنصر تحكم ما معطلاً، فاقرأ تفسيره. إذا كان يتطلب دورًا أو إذنًا مختلفًا، فاطلب المساعدة من مالك المشروع أو مساحة العمل. لا تفصل خدمة أخرى فقط لتجاوز قيد ما.

تحقق من النتيجة: يمكنك فتح شاشة الاتصال أو الإدارة الخاصة بالخدمة. إذا كانت لا تزال لا تظهر، فتحقق من Connect and Manage Integrations أو تواصل مع الدعم لتأكيد التوفر. لا تفترض أن الخدمة المفقودة يمكن تفعيلها عبر محاولات تسجيل دخول متكررة.

لا يكتمل التفويض

1. حدِّد Connect مرة واحدة وابحث عن نافذة تسجيل الدخول الخاصة بالخدمة. إذا أبلغ المتصفح عن نافذة منبثقة محظورة، فاسمح بالنوافذ المنبثقة لموقع Atoms ثم حاول مرة أخرى. في Chrome، اتبع تعليمات السماح بالنوافذ المنبثقة من موقع محدد؛ ولا تحتاج إلى تمكينها لكل موقع.
2. اختر الحساب المقصود وراجع الوصول المطلوب. أكمل تدفق التفويض الخاص بالخدمة قبل إغلاق نافذتها.
3. إذا ذكرت الخدمة صراحةً أن مؤسستك حظرت التطبيق أو الوصول المطلوب، فاحفظ الرسالة وتواصل مع المسؤول. لا تتحايل على سياسة مؤسستك.
4. ارجع إلى Atoms وأعد فتح التكامل للتحقق من حالته. إن إغلاق نافذة تسجيل الدخول لا يؤكد نجاح التفويض.

راجع الوصول المطلوب قبل إكمال التفويض. إن تفويض حساب لا يؤكد بحد ذاته أن المورد المقصود متصل.

إذا كان التفويض يتضمن محددًا للمؤسسة أو مساحة العمل، فأكِّد التحديد المقصود وراجع الأذونات المطلوبة.

تحقق من النتيجة: يظهر التكامل على أنه متصل. في شاشات تفاصيل الموصل التي تستخدم التخطيط القياسي، يتم استبدال Connect بـ Disconnect و Try it out. لدى الخدمات الأخرى تخطيطات خاصة بها. إذا كان لا يزال يعرض Connect أو يُظهر خطأ، فالتقط هذه النتيجة وتواصل مع الدعم بعد محاولة جديدة واحدة.

تم توصيل الحساب الخطأ

إذا كانت شاشة إدارة التكامل تعرض حسابًا، فقارنه بالحساب الذي يملك المورد أو يمكنه الوصول إليه. لا تعرض كل الموصلات الحساب المتصل، لذلك لا تستخدم حالة تسجيل الدخول الحالية في المتصفح وحدها كدليل على الحساب الذي يستخدمه Atoms.

افتح المورد مباشرةً في الخدمة باستخدام الحساب المقصود. إذا كان هذا الحساب لا يستطيع الوصول إليه، فاطلب الوصول أولاً من مالك المورد. إذا كان الاتصال يستخدم الحساب الخطأ، فاتبع تعليمات تبديل الحساب الخاصة بالخدمة أو أعد الاتصال بأمان واختر الحساب الصحيح صراحةً أثناء التفويض.

تحقق من النتيجة: يعرض طلب قراءة صغير ومدعوم المورد المقصود. إذا كنت لا تزال غير قادر على تحديد الحساب المتصل، فتواصل مع الدعم بدلًا من قطع الاتصال بشكل متكرر.

التكامل متصل، لكن Agent لا يمكنه العثور على بياناتك

1. تحقق من الاتصال. افتح تفاصيل التكامل في Connectors وأكِّد أنه متصل. تحقق من الحساب أو المورد المحدد حيثما يظهر ذلك.
2. تحقق من المورد الدقيق. افتحه مباشرةً في الخدمة باستخدام الحساب المقصود. أكِّد موقعه وأذونات الوصول إليه، بما في ذلك المؤسسة أو مساحة العمل أو المجلد أو الخاصية الصحيحة عند الاقتضاء.
3. اجعل الطلب محددًا. اذكر اسم الخدمة وقدّم اسم المورد الدقيق أو رابطه عندما يدعم الموصل ذلك. اطلب إجراء قراءة واحدًا ومدعومًا أولاً، بدلًا من البحث وتغيير عدة موارد دفعة واحدة.

على سبيل المثال، إذا كان الموصل يدعم قراءة المستندات: “استخدم [service] لقراءة [document name or link] وأخبرني بعنوانه. لا تغيّره.”

تحقق من النتيجة: يعرض Agent المورد المقصود. إذا كان الوصول المباشر يعمل لكن Agent لا يزال لا يستطيع قراءته، فتحقق من القدرات المدعومة للموصل ومن الوصول الممنوح. لا تُعد الاتصال إلا إذا كان هناك دليل على وجود مشكلة في التفويض.

يستطيع Agent قراءة البيانات، لكنه لا يستطيع تغييرها

نجاح القراءة لا يؤكد أن الموصل يدعم التغيير المطلوب أو لديه إذن لإجرائه.

1. راجع Connect and Manage Integrations أو قائمة What you can do الخاصة بالموصل، إذا كانت معروضة. أكِّد أن الإجراء المطلوب مدعوم.
2. تحقق مما إذا كان الحساب المتصل مسموحًا له بإجراء هذا التغيير على المورد المحدد. اطلب من مالك المورد أو المسؤول منح الوصول اللازم فقط.
3. اقرأ أي خطأ أو طلب تأكيد. إذا كان التفويض الإضافي مطلوبًا، فاتبع التدفق الموثق للخدمة. لا يمكن لإعادة الاتصال إضافة إجراء لا يدعمه الموصل.

قبل إعادة محاولة الكتابة: افحص الوجهة لمعرفة ما إذا كانت المحاولة الأولى قد أنشأت شيئًا أو غيّرته بالفعل. لا تكفي الاستجابة الفاشلة لإثبات عدم حدوث أي تغيير. لا تكرر دفعة أو رسالة أو دعوة أو إنشاء سجل حتى تعرف نتيجة المحاولة السابقة.

تحقق من النتيجة: ينجح تغيير مدعوم على مورد اختبار مناسب، وتؤكد ذلك مباشرةً في الخدمة. بالنسبة إلى المدفوعات أو مسارات العمل الحية الأخرى، استخدم تعليمات الاختبار الخاصة بالخدمة بدلًا من معاملة حقيقية.

اتصال كان يعمل من قبل قد توقف

تحقق مما تغيّر منذ آخر طلب ناجح: الحساب، أو وصوله إلى المورد، أو سياسة تطبيقات المؤسسة، أو تفويض الاتصال.

1. أعد فتح التكامل في Atoms وتحقق مما إذا كان لا يزال متصلًا.
2. حاول فتح المورد مباشرةً في الخدمة. إذا تمت إزالة الوصول، فحلّ ذلك مع مالك المورد أو المسؤول.
3. إذا ذكر الخطأ أن التفويض انتهت صلاحيته، أو تم سحبه، أو أنه غير صالح، فاتبع أعد الاتصال بأمان. إذا كان الخطأ يتعلق بانقطاع الخدمة أو حدٍّ ما أو إجراء غير مدعوم، فتعامل مع هذا السبب أولًا.

تحقق من النتيجة: يعمل طلب قراءة صغير مرة أخرى. إذا استمر الخطأ نفسه، فاحفظه مع وقت آخر نجاح وتواصل مع الدعم.

النتائج غير محدثة أو أن الطلب يستمر في الفشل

1. قارن النتيجة بالخدمة نفسها. أكِّد الحساب والمورد والنطاق الزمني وعوامل التصفية والمنطقة الزمنية عند الاقتضاء. اطلب من Agent جلب القيمة الحالية بدلًا من الاعتماد على إجابة سابقة في المحادثة.
2. إذا كان هناك خطأ صريح بانتهاء المهلة أو بعدم توفر الخدمة، فتحقق من صفحة الحالة أو المساعدة الرسمية الخاصة بالخدمة. إذا أعطى الخطأ وقتًا لإعادة المحاولة، فانتظر حتى ذلك الوقت؛ ولا ترسل طلبات متكررة ما دام الحد أو الانقطاع مستمرًا.
3. احفظ أي نص غير مُرسل، ثم حدّث Atoms، وأعد التحقق من حالة الموصل. تحديث الصفحة ليس هو نفسه إعادة تفويض الحساب.
4. أعد محاولة طلب قراءة صغير واحد. قبل إعادة محاولة أي شيء يغيّر بيانات خارجية، افحص الوجهة لمعرفة النتيجة السابقة.

تحقق من النتيجة: تطابق النتيجة الجديدة المورد المقصود في الخدمة. إذا بقيت غير صحيحة، فأرسل إلى الدعم القيم المتوقعة والفعلية مع الطوابع الزمنية. لا تفترض أن كل عمليات التكامل تتحدث وفق الجدول نفسه.

أعد الاتصال بأمان

أعد الاتصال عندما يكون التفويض غير صالح أو عندما يكون الحساب الخطأ مرتبطًا، وليس كخطوة أولى لكل طلب فاشل.

قبل قطع الاتصال: أنهِ المهام التي تعتمد على الاتصال أو أوقفها مؤقتًا، وتحقق من نتيجة أي عملية كتابة خارجية معلقة، وتأكد من أنه يمكنك تسجيل الدخول مرة أخرى باستخدام الوصول المطلوب. يؤدي قطع الاتصال إلى جعل الاتصال غير متاح حتى تتم إعادة توصيله. تحقق من Connect and Manage Integrations لمعرفة أي آثار إضافية؛ ولا تفترض أن قطع الاتصال يعكس التغييرات السابقة أو يلغي العمل الذي تم إرساله بالفعل.

1. افتح تفاصيل اتصال الخدمة. إذا كانت لديها شاشة إدارة حساب خاصة بها، فاتبع تعليمات ذلك التكامل.
2. في شاشة تفاصيل الموصل القياسية، حدِّد Disconnect عندما تكون جاهزًا، ثم حدِّد Connect. لا تفترض أنه ستكون هناك رسالة تأكيد إضافية قبل قطع الاتصال.
3. اختر الحساب المقصود وأكمل التفويض. راجع الأذونات المطلوبة.
4. ارجع إلى Atoms وأكِّد حالة الاتصال.
5. شغّل فحص الاستعادة أدناه قبل استئناف المهمة الأصلية.

إذا عاد الخطأ نفسه، فتوقف عن إعادة الاتصال وتواصل مع الدعم مع الخطأ وعمليات التحقق التي أُنجزت بالفعل.

تحقّق من أن المشكلة قد تم حلها

1. اطلب إجراءً واحدًا مدعومًا للقراءة فقط على مورد يمكنك التحقق منه مباشرةً. إذا كنت تستخدم Try it out، فراجع Prompt المقترح قبل إرساله.
2. قارن الاستجابة بالخدمة نفسها. أكِّد المورد الصحيح، وسياق الحساب الصحيح، والنتيجة المطلوبة، وليس مجرد مؤشر الاتصال.
3. إذا كانت مهمتك تتطلب تغييرات، فاستخدم مورد اختبار مناسبًا أو مسار اختبار موثقًا من الخدمة، وتحقق من النتيجة في الوجهة.

تحقق من حالة الاتصال والمورد المحدد. لا يؤكد مؤشر الاتصال وحده أن البيانات المتوقعة متاحة أو محدثة.

أكِّد المؤسسة والمشروع، ثم افتح Dashboard لفحص المورد دون إجراء تغييرات. لا يُعد قطع الاتصال جزءًا من هذا الفحص.

إذا نجح الفحص، فاستأنف مهمتك. إذا كان Chat يعمل لكن الميزة لا تزال تفشل داخل تطبيقك، فراجع Connect and Manage Integrations أو استكشاف أخطاء الإنشاء والمعاينة وإصلاحها. تحقق من البيئة التي يحدث فيها الفشل؛ فنجاح طلب في Chat ليس دليلًا على أن التطبيق مُكوَّن بشكل صحيح.

احصل على المساعدة

إذا استمرت المشكلة، فاستخدم Get support وضمّن ما يلي:

• اسم التكامل وعنوان البريد الإلكتروني لحسابك في Atoms.
• رابط المشروع أو Chat المتأثر، وما إذا كان الفشل يحدث في Chat أو في تطبيقك. بالنسبة إلى التطبيق، حدِّد البيئة المتأثرة.
• حساب الخدمة المقصود والمورد، باستخدام معرّفات غير سرية فقط لازمة للتحقيق.
• الخطأ الدقيق، والتاريخ، والوقت، والمنطقة الزمنية؛ وضمّن وقت آخر نجاح إذا كان معروفًا.
• خطوات إعادة الإنتاج، والنتيجة المتوقعة، والنتيجة الفعلية، وعمليات التحقق التي تمت تجربتها بالفعل.
• المتصفح والجهاز، بالإضافة إلى لقطات شاشة منقحة أو تسجيل قصير إذا كان ذلك مفيدًا.

بالنسبة إلى عملية كتابة فاشلة، اذكر ما إذا كانت الوجهة تُظهر تغييرًا مكتملًا، أو عدم وجود تغيير، أو نتيجة غير معروفة. أزل كلمات المرور، ورموز تسجيل الدخول، ومفاتيح API، وTokens، والبيانات الخاصة غير ذات الصلة من جميع المرفقات.