المهارات observe-whatsapp
📦

observe-whatsapp

آمن

تصحيح أخطاء توصيل رسائل WhatsApp والويب هوك

استكشاف مشاكل WhatsApp في بيئة الإنتاج بكفاءة. توفر هذه المهارة أوامر لفحص توصيل الرسائل وتصحيح أخطاء فشل الويب هوك وإجراء فحوصات الحالة على منصة Kapso.

يدعم: Claude Codex Code(CC)
🥉 74 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "observe-whatsapp". التحقق من توصيل الرسالة لرقم الهاتف +1234567890

النتيجة المتوقعة:

تم العثور على 3 رسائل لـ +1234567890. معرف الرسالة msg_abc123: تم التوصيل في 2024-01-15 10:30:00. معرف الرسالة msg_def456: قيد الانتظار (الويب هوك لم يتم الاعتراف به). معرف الرسالة msg_ghi789: فشل - المستلم اختار الإلغاء.

استخدام "observe-whatsapp". عرض حالة توصيل الويب هوك للساعة الأخيرة

النتيجة المتوقعة:

ملخص توصيلات الويب هوك: 45 ناجح، 3 فشل. التوصيلات الفاشلة: 503 Service Unavailable من نقطة نهاية الويب هوك في 10:15، 10:22، 10:45. عدد إعادة المحاولات: 3/3. يوصى بالتحقق من صحة خادم الويب هوك.

التدقيق الأمني

آمن
v1 • 2/24/2026

This skill is documentation-only (SKILL.md). Static analyzer flagged markdown code blocks as shell commands, but all 28 external_commands findings are false positives from code formatting. Network and env_access findings reference YAML frontmatter URLs and documented environment variable requirements, not actual code execution. No executable code exists in this skill.

1
الملفات التي تم فحصها
110
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

الاستجابة لحوادث الإنتاج

التحقيق السريع في سبب عدم توصيل رسائل WhatsApp إلى العملاء أثناء الحادث النشط.

تصحيح أخطاء الويب هوك

فحص محاولات توصيل الويب هوك لفهم سبب عدم استلام الرسائل الواردة أو تحديثات الحالة.

مراقبة الحالة

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

جرّب هذه الموجهات

البحث الأساسي عن الرسائل
أحتاج للتحقق من توصيل رسالة WhatsApp. رقم الهاتف هو +1234567890. ساعدني في العثور على المحادثة والتحقق من حالة التوصيل.
التحقيق في توصيل الويب هوك
توقف نقطة نهاية الويب هوك الخاصة بنا عن استلام الأحداث من WhatsApp. استخدم سكريبت webhook-deliveries للتحقق من محاولات التوصيل الأخيرة وتحديد أي أنماط خطأ.
سير عمل تصنيف الأخطاء
نشاهد زيادة في أخطاء الرسائل في الإنتاج. نفّذ التصنيف الكامل للأخطاء: تحقق من أخطاء الرسائل، راجع سجلات API، وحدد أي إخفاقات في توصيل الويب هوك. لخص السبب الجذري.
أتمتة فحص الحالة
شغّل فحص الحالة على معرف رقم الهاتف <id> وأنشئ تقرير حالة. ضمّن أي مؤشرات حالة فاشلة وخطوات الإصلاح الموصى بها.

أفضل الممارسات

  • تحقق دائمًا من أخطاء الرسائل وسجلات API معًا لربط الإخفاقات بالأسباب الجذرية
  • شغّل فحوصات الحالة بشكل استباقي قبل نشر التغييرات على تكاملات WhatsApp
  • استخدم سكريبت lookup-conversation للحصول على السياق الكامل عند التحقيق في مشاكل الرسائل الفردية

تجنب

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

الأسئلة المتكررة

ما بيانات الاعتماد التي أحتاجها لاستخدام هذه المهارة؟
تحتاج إلى تكوين متغيرات البيئة KAPSO_API_BASE_URL (عنوان URL المضيف بدون المسار /platform/v1) و KAPSO_API_KEY.
هل يمكن لهذه المهارة إنشاء أو تعديل ويب هوك WhatsApp؟
لا. هذه المهارة للملاحظة والتصحيح فقط. استخدم مهارة integrate-whatsapp لإعداد الويب هوك أو تحديثه أو حذفه.
لماذا تظهر بعض الأوامر متطلبات تثبيت npm؟
السكريبتات تعتمد على حزم Node.js. شغّل npm install مرة واحدة قبل استخدام نصوص التشخيص لتثبيت التبعيات المطلوبة.
ماذا يفعل سكريبت openapi-explore.mjs؟
يسمح لك بالبحث واستكشاف مواصفات OpenAPI لمنصة Kapso، مما يساعدك في العثور على نقاط النهاية والعمليات والمخططات المتاحة.
كيف أتحقق من حالة رقم هاتف معين؟
استخدم سكريبت whatsapp-health.js مع العلم --phone-number-id متبوعًا بمعرف رقم الهاتف الذي تريد التحقق منه.
ماذا يجب أن أفعل إذا فشلت توصيلات الويب هوك؟
أولاً تحقق من استجابة خادم الويب هوك برموز حالة 2xx. ثم راجع مخرجات webhook-deliveries.js لأنماط إعادة المحاولة ورموز الخطأ. تحقق من صحة التحقق من توقيع الويب هوك الخاص بك.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md