سجلات WhatsApp
يوفر قسم سجلات WhatsApp سجلاً شاملاً لجميع التفاعلات الآلية التي تعالجها وحدة WhatsApp Cloud API Chat & Marketing. يشمل ذلك تسليمات الحملات واستجابات الروبوتات والرسائل القائمة على القوالب. استخدم هذا القسم لمراقبة النشاط واستكشاف مشاكل التسليم والحفاظ على مسار تدقيق كامل لاتصالات WhatsApp الخاصة بك.
الوصو ل إلى سجلات WhatsApp
انتقل إلى WhatsApp Module > WhatsApp Logs من الشريط الجانبي لـ Perfex CRM. تُعرض السجلات في جدول قابل للفرز والبحث يوضح جميع أنشطة الرسائل الآلية.
أعمدة جدول السجلات
يحتوي كل إدخال سجل على المعلومات التالية:
| العمود | الوصف |
|---|---|
| # | معرّف فريد تلقائي الزيادة لكل إدخال سجل |
| Category | نوع التفاعل الآلي — مثل Marketing Campaign أو Template Bot |
| Name | اسم الحملة أو الروبوت أو الأتمتة التي أنشأت إدخال السجل |
| Template Name | قالب رسالة WhatsApp المُستخدم في التفاعل |
| Response Code | كود استجابة HTTP المُرجع من WhatsApp Cloud API (مثل 200 للنجاح، 400 لطلب غير صالح) |
| Type | نوع المستلم — مثل Leads أو Customers أو Contacts |
| Recorded On | التاريخ والوقت الذي تم فيه تسجيل التفاعل |
| Actions | الإجراءات المتاحة لكل إدخال: View التفاصيل أو Delete سجل السجل |
فهم أكواد الاستجابة
يساعدك عمود كود الاستجابة في تحديد ما إذا كانت الرسائل تم تسليمها بنجاح أو واجهت أخطاء بسرعة.
| كود الاستجابة | المعنى | الإجراء المطلوب |
|---|---|---|
| 200 | نجاح — تم قبول الرسالة من WhatsApp API | لا يلزم إجراء |
| 400 | طلب غير صالح — معلمات أو مشكلة في القالب غير صحيحة | راجع القالب والمعلمات |
| 401 | غير مصرح — رمز وصول غير صالح أو منتهي | أعد إنشاء رمز الوصول في إعدادات Meta Business |
| 403 | محظور — صلاحيات غير كافية | تحقق من صلاحيات مستخدم النظام |
| 404 | غير موجود — معرّف رقم هاتف أو نقطة نهاية غير صالحة | تحقق من Phone Number ID في إعدادات الوحدة |
| 429 | تجاوز حد المعدل — تم إرسال طلبات كث يرة جداً | قلّل تكرار الإرسال؛ أعد المحاولة بعد فترة التهدئة |
| 500 | خطأ خادم داخلي — مشكلة في WhatsApp API | أعد المحاولة لاحقاً؛ تحقق من صفحة حالة Meta إذا استمرت المشكلة |
كود الاستجابة الناجح (200) يؤكد أن WhatsApp Cloud API قبلت الرسالة للتسليم. لا يضمن التسليم النهائي إلى جهاز المستلم — يأتي تأكيد التسليم من خلال تحديثات حالة webhook المرئية في واجهة المحادثة.
تصفية السجلات
استخدم الفلاتر المدمجة لتضييق إدخالات السجل والعثور على سجلات محددة بسرعة:
- Category — تصفية حسب نوع التفاعل (Marketing Campaign أو Template Bot وغيرها)
- Response Code — تصفية حسب النجاح (
200) أو أكواد خطأ محددة - Type — تصفية حسب نوع المستلم (Leads أو Customers أو Contacts)
- Date Range — اختر تاريخ بداية ونهاية لعرض السجلات ضمن فترة زمنية محددة
- Search — بحث نصي حر عبر أسماء الحملات وأسماء القوالب وحقول أخرى
عرض تفاصيل السجل
انقر على إجراء View في أي إدخال سجل لرؤية التفاصيل الكاملة للتفاعل، بما في ذلك:
- حمولة الطلب الكاملة المُرسلة إلى WhatsApp API
- نص استجابة API الكامل
- رقم هاتف المستلم ومرجع جهة الاتصال
- معلمات القالب وقيم المتغيرات المُستخدمة
- الطابع الزمني مع معلومات المنطقة الزمنية
هذا العرض المفصّل لا يُقدّر بثمن لاستكشاف أخطاء التسليم الفاشلة أو تدقيق محتوى رسائل محددة.
حذف سجلات السجل
لإزالة إدخالات سجل فردية:
- انقر على إجراء Delete في صف السجل المستهدف.
- أكد الحذف عند المطالبة.
للحذف الجماعي للسجلات، استخدم اختيار مربع الاختيار لتحديد إدخالات متعددة وانقر Delete Selected.
لا يمكن استرداد سجلات السجل المحذوفة. إذا كنت بحاجة للاحتفاظ بالسجلات لأغراض الامتثال أو التدقيق، فكر في تصدير البيانات قبل الحذف.
أفضل الممارسات
- راجع السجلات بانتظام — تحقق من التسليمات الفاشلة (أكواد استجابة غير 200) وعالج المشاكل فوراً للحفاظ على فعالية الحملة
- راقب حدود المعدل — إذا رأيت استجابات
429متكررة، قلّ ل معدل إرسال حملتك أو وزّع التسليمات على فترات زمنية أطول - حافظ على تحديث الرموز — أخطاء
401تشير إلى انتهاء صلاحية رمز الوصول أو إلغائه؛ حدّثه فوراً لاستعادة الوظائف - أرشف قبل التنظيف — قبل حذف السجلات القديمة، صدّر أو وثّق أي سجلات مطلوبة للامتثال أو التقارير أو حل النزاعات
- استخدم الفلاتر للتدقيق — عند التحقيق في حملة أو روبوت محدد، استخدم فلاتر Category وName لعزل إدخالات السجل ذات الصلة بسرعة
تلتقط سجلات WhatsApp التفاعلات الآلية فقط (الحملات والروبوتات وإرسال القوالب). رسائل المحادثة اليدوية بين الموظفين والعملاء تُخزّن في سجل المحادثات ولا تتكرر في قسم السجل هذا.