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

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

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

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

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

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

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

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

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

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

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

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

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

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. راجع توصيل التكاملات وإدارتها أو قائمة What you can do الخاصة بالموصل، إذا كانت معروضة. أكد أن الإجراء المطلوب مدعوم.
2. تحقق مما إذا كان الحساب المتصل مسموحًا له بإجراء هذا التغيير على المورد المحدد. اطلب من مالك المورد أو المسؤول منح الوصول المطلوب فقط.
3. اقرأ أي رسالة خطأ أو طلب تأكيد. إذا كان التفويض الإضافي مطلوبًا، فاتبع التدفق الموثق للخدمة. لا يمكن لإعادة الاتصال إضافة إجراء لا يدعمه الموصل.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تحقق من حل المشكلة

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

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

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

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

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

إذا استمرت المشكلة، فاستخدم الحصول على الدعم وضمّن ما يلي:

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

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