> For the complete documentation index, see [llms.txt](https://docs.taqnyat.sa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taqnyat.sa/documentation-ar/readme/alaselh-alshaeah-wastkshaf-alakhtaa-wislahha/mshklat-alwyb-hwk.md).

# مشكلات الويب هوك

تساعد هذه الصفحة المستخدمين على استكشاف المشكلات الشائعة المتعلقة بتهيئة Webhook لـ LiveChat وروبوت الدردشة وإصلاحها.

تؤثر إعدادات Webhook في كيفية توجيه رسائل WhatsApp الواردة إلى LiveChat أو Chatbot أو كليهما. إذا لم يتم تكوين Webhook بشكل صحيح، فقد لا تظهر المحادثات الواردة في LiveChat كما هو متوقع.

### ما هو Webhook؟

Webhook هو اتصال يتيح للمنصة إرسال أحداث الرسائل والتحديثات في الوقت الفعلي إلى الخدمة الصحيحة أو إلى نظام خارجي.

في حالات استخدام LiveChat وChatbot، يساعد Webhook في توجيه رسائل WhatsApp الواردة إلى الوجهة الصحيحة بناءً على إعداد الحساب.

تُدار إعدادات Webhook من **البوابة** ضمن:

```
المطورون → أدوات المطور
```

### لماذا يعد تكوين Webhook مهمًا

يعد تكوين Webhook مهمًا لأنه يؤثر في ما إذا كانت الرسائل الواردة ستُستقبل بشكل صحيح أم لا.

إذا لم يتم ضبط Webhook بشكل صحيح، فقد يواجه المستخدمون مشكلات مثل:

* عدم ظهور المحادثات الواردة في LiveChat
* عدم استقبال Chatbot لرسائل العملاء
* إظهار LiveChat لقائمة محادثات فارغة
* عدم عمل تحويل Chatbot كما هو متوقع
* عدم توجيه الرسائل إلى الخدمة الصحيحة

### خيارات Webhook

قد يتضمن قسم Webhook الخاص بـ WhatsApp خيارات مثل:

* **Chatbot + LiveChat**
* **LiveChat فقط**
* **أخرى**

يعتمد الخيار الصحيح على الخدمات المفعلة للحساب.

### LiveChat فقط

إذا كان الحساب يستخدم LiveChat فقط ولا يملك Chatbot نشطًا، فيجب ضبط Webhook على:

```
LiveChat فقط
```

يتيح ذلك توجيه رسائل WhatsApp الواردة مباشرةً إلى LiveChat.

إذا كان العملاء يرسلون رسائل لكن المحادثات لا تظهر في LiveChat، ولم يكن لدى الحساب Chatbot نشط، فتأكد من ضبط Webhook على **LiveChat فقط**.

### Chatbot + LiveChat

إذا كان الحساب مفعّلًا فيه كل من Chatbot وLiveChat، فيجب ضبط Webhook على:

```
Chatbot + LiveChat
```

يتيح ذلك لـ Chatbot وLiveChat العمل معًا.

في هذا الإعداد، قد يتولى Chatbot المحادثات الواردة أولًا، ثم تُحوَّل إلى LiveChat بناءً على مسار Chatbot أو اختيار العميل.

### ماذا يحدث عند إيقاف Chatbot؟

عند إيقاف Chatbot، يجب أن يعود Webhook تلقائيًا إلى:

```
LiveChat فقط
```

يتيح ذلك لـ LiveChat الاستمرار في استقبال الرسائل بدون طبقة Chatbot.

إذا تم تعطيل Chatbot لكن المحادثات لا تظهر في LiveChat، فتحقق من صفحة Webhook للتأكد من أن Webhook عاد إلى **LiveChat فقط**.

### عنوان URL الخارجي لـ Webhook

قد تسمح صفحة أدوات المطور أيضًا للمستخدمين المصرح لهم بإضافة عنوان URL خارجي لـ Webhook.

يمكن لـ Webhook خارجي العمل جنبًا إلى جنب مع LiveChat لإرسال التحديثات إلى نظام آخر.

قد يكون هذا مفيدًا للتكامل مع:

* أنظمة CRM
* لوحات المعلومات الداخلية
* أدوات التقارير
* أنظمة الأتمتة
* منصات الدعم الخارجية

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

### متى يجب التحقق من إعدادات Webhook

تحقق من إعدادات Webhook عندما:

* لا تظهر المحادثات الواردة في LiveChat.
* تكون قائمة محادثات LiveChat فارغة رغم أن العملاء يرسلون رسائل.
* تم مؤخرًا التبديل في الحساب بين Chatbot وLiveChat.
* تم إيقاف Chatbot لكن LiveChat لا يستقبل المحادثات.
* لا يعمل تحويل Chatbot كما هو متوقع.
* لا يستقبل نظام خارجي تحديثات Webhook المتوقعة.
* تم تغيير إعداد الحساب مؤخرًا.

### خطوات استكشاف الأخطاء الأساسية

إذا لم تظهر المحادثات في LiveChat:

1. سجّل الدخول إلى **البوابة**.
2. انتقل إلى:

   ```
   المطورون → أدوات المطور
   ```
3. افتح **Webhook** القسم.
4. تحقق من خيار Webhook المحدد.
5. إذا كان الحساب يستخدم LiveChat فقط، فتأكد من **LiveChat فقط** محدد.
6. إذا كان الحساب يستخدم كلًا من Chatbot وLiveChat، فتأكد من **Chatbot + LiveChat** محدد.
7. احفظ التكوين إذا تم إجراء تغييرات.
8. اختبر مرة أخرى بإرسال رسالة WhatsApp جديدة إلى الحساب.

إذا استمرت المشكلة بعد التحقق من تكوين Webhook، فاتصل بفريق الدعم.

### أمثلة على مشكلات Webhook

#### لا تظهر المحادثات في LiveChat

إذا كان LiveChat فارغًا ولا تظهر أي محادثات، فتحقق مما إذا كان Webhook مضبوطًا بشكل صحيح.

في الحسابات التي تستخدم LiveChat فقط، يجب ضبط Webhook على **LiveChat فقط**.

#### Chatbot لا يستقبل الرسائل

إذا كان Chatbot نشطًا لكنه لا يستقبل رسائل العملاء، فتحقق مما إذا كان Webhook مضبوطًا على **Chatbot + LiveChat**.

#### تم تعطيل Chatbot لكن LiveChat لا يستقبل المحادثات

إذا تم إيقاف Chatbot، فيجب أن يعود Webhook إلى **LiveChat فقط**.

إذا لم يتم تحديثه بشكل صحيح، فقد لا يستقبل LiveChat المحادثات الواردة كما هو متوقع.

#### Webhook الخارجي لا يستقبل الأحداث

إذا كان نظام خارجي لا يستقبل أحداث Webhook، فتحقق من:

* عنوان URL الخاص بـ Webhook صحيح.
* النظام الخارجي نشط.
* يمكن للنظام الخارجي استقبال الطلبات.
* تم تكوين أي رؤوس مطلوبة أو إعدادات نوع المحتوى بشكل صحيح.
* تم حفظ إعداد Webhook بشكل صحيح.

### ملاحظات مهمة

تؤثر إعدادات Webhook في كيفية توجيه الرسائل إلى LiveChat وChatbot.

في الحسابات التي تستخدم LiveChat فقط، يجب ضبط Webhook على **LiveChat فقط**.

في الحسابات التي تستخدم كلًا من Chatbot وLiveChat، يجب ضبط Webhook على **Chatbot + LiveChat**.

عند إيقاف Chatbot، يجب أن يعود Webhook تلقائيًا إلى **LiveChat فقط**.

إذا لم تظهر المحادثات في LiveChat ولم يكن لدى الحساب Chatbot نشط، فإن التحقق من إعداد Webhook هو أحد أولى خطوات استكشاف الأخطاء.

يجب التعامل مع إعداد Webhook الخارجي بحذر لأنه قد يؤثر في التكامل مع الأنظمة الأخرى.

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

عند إدارة إعدادات Webhook:

* استخدم **LiveChat فقط** عندما لا يكون لدى الحساب Chatbot نشط.
* استخدم **Chatbot + LiveChat** عندما تكون الخدمتان نشطتين.
* تحقق من إعدادات Webhook بعد تفعيل Chatbot أو تعطيله.
* تأكد من صحة عناوين URL الخارجية لـ Webhook قبل الحفظ.
* نسّق مع الفريق التقني قبل إضافة عناوين URL الخارجية لـ Webhook أو تغييرها.
* اختبر تسليم الرسائل بعد أي تغيير في إعدادات Webhook.
* اتصل بالدعم إذا ظلت المحادثات الواردة مفقودة بعد التحقق من Webhook.

### قائمة تحقق سريعة

إذا ظهرت مشكلات متعلقة بـ Webhook، فتحقق من:

* هل يستخدم الحساب LiveChat فقط؟
* هل يستخدم الحساب كلًا من Chatbot وLiveChat؟
* هل تم ضبط Webhook على الخيار الصحيح؟
* هل تم تفعيل Chatbot أو تعطيله مؤخرًا؟
* هل المحادثات الواردة مفقودة من LiveChat؟
* هل يعمل تحويل Chatbot كما هو متوقع؟
* هل عنوان URL الخارجي لـ Webhook صحيح؟
* هل تم حفظ التكوين بعد التغييرات؟
* هل تم إرسال رسالة اختبار جديدة بعد تحديث Webhook؟

### متى يجب الاتصال بالدعم

اتصل بفريق الدعم إذا:

* لا تظهر المحادثات في LiveChat بعد التحقق من إعدادات Webhook.
* إعداد Webhook لا يتطابق مع الخدمات النشطة.
* لا يعود Webhook إلى **LiveChat فقط** بعد تعطيل Chatbot.
* لا يعمل تحويل Chatbot حتى مع ضبط Webhook بشكل صحيح.
* Webhook خارجي لا يستقبل الأحداث.
* لست متأكدًا من خيار Webhook الذي يجب تحديده.
* يحتوي الحساب على تكامل مخصص يحتاج إلى مراجعة تقنية.