التكاملات

تشخيص أعطال التكاملات وإعادة الربط

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

نُشر · آخر تحديث

حدد آخر خطوة نجحت قبل تغيير الإعدادات. ظهور المتجر متصلًا لا يثبت وصول آخر حدث، ووصول الحدث لا يثبت تشغيل سير العمل أو تسليم الرسالة.

مسار استخدام التكامل
رسم توضيحي للاستخدام؛ القدرات تعتمد على المزود والإعدادات الفعلية.

شخص العطل من نتيجته

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

خطوات الإصلاح

  1. 1

    احفظ دليلًا محدودًا

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

  2. 2

    نفذ الفحص المناسب

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

  3. 3

    اختبر أثرًا واحدًا

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

  4. 4

    راقب السلسلة كاملة

    تحقق من وصول الحدث ثم تحديث البيانات ثم تنفيذ الإجراء المطلوب. في الرسائل افحص التسليم بصورة مستقلة.

متى تلجأ للدعم؟

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

مراجعة نطاق التكاملفحص إعداد تأكيد الطلبات

اتبع رحلة التنفيذ خطوة بخطوة

  1. 1

    ثبّت الحالة التي تختبرها

    اختر مرجعًا واحدًا ووقتًا معلومًا، واكتب النتيجة المتوقعة: قراءة قيمة، أو إضافة صف، أو إرسال رسالة.

  2. 2

    تحقق من المصدر

    هل الحدث وقع في المتجر أو النظام الصحيح؟ وهل الملف أو المتجر متاح في مساحة العمل الحالية؟

  3. 3

    افحص Workflow

    راجع Trigger وشروط الدخول وتفعيل المسار والخطوة التي توقفت. لا تخلط نجاح استقبال الحدث مع نجاح الخطوة التالية.

  4. 4

    افحص AI

    راجع المهارة المفعلة والملفات المختارة والتعليمات وسجل الاستدعاء. هل جمع الوكيل المدخلات أم حاول التنفيذ دونها؟

  5. 5

    افحص الشات والأثر الخارجي

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

مثالالتشخيص التالي
مهارة Sheets معطلةراجع Add and sync وحالة تفويض Google قبل تعديل تعليمات الوكيل.
AI يقول «تم الحفظ» والصف غير موجودافحص سجل الأداة والملف، وصحح التعليمات لعدم تأكيد النجاح دون نتيجة.
Workflow لا يظهر في الشاتراجع كونه يدويًا ومنشورًا، وشروط العميل والقناة، وصلاحية الموظف.
خطوات اختبار Google Sheets