إذا لم يتمكن Chatwoot من جلب أحدث قوالب الرسائل من حساب WhatsApp Business الخاص بك، يمكنك تزويد صندوق البريد المتأثر برمز إدارة أعمال Meta.

> هذه الميزة متاحة فقط على Chatwoot Cloud لصناديق بريد WhatsApp التي تم إنشاؤها من خلال التسجيل المضمّن، بما في ذلك صناديق بريد التعايش مع تطبيق WhatsApp Business. وهي غير متاحة لصناديق بريد WhatsApp المُعدة يدوياً.

## لماذا يحتاج Chatwoot إلى هذا الرمز؟

يستخدم Chatwoot عادة بيانات الاعتماد التي تم إنشاؤها أثناء إعداد WhatsApp لمزامنة قوالب الرسائل. في بعض الحالات، قد تسمح هذه البيانات بالرسائل الواردة والصادرة بينما لم تعد تملك الإذن لقراءة أو إدارة أصول أعمال WhatsApp.

يوفر رمز إدارة الأعمال الإذن الإضافي `whatsapp_business_management` المطلوب لجلب القوالب من حساب WhatsApp Business.

يستخدم Chatwoot هذا الرمز فقط لمزامنة القوالب. ولا يُستخدم من أجل:

* إرسال أو استقبال رسائل WhatsApp

* تسليم webhook

* تسجيل رقم الهاتف

* تغيير حساب WhatsApp Business الخاص بك

* إدارة محفظة أعمال Meta الخاصة بك

## قبل أن تبدأ

تأكد من أنك:

* مسؤول في محفظة أعمال Meta التي تملك حساب WhatsApp Business.

* يمكنك الوصول إلى حساب WhatsApp Business المتأثر في إعدادات أعمال Meta.

* لدى عملك تطبيق Meta مرتبط بذلك الحساب في WhatsApp.

* أنت مسؤول في حساب Chatwoot.

* تم إنشاء صندوق البريد باستخدام التسجيل المضمّن لـ WhatsApp على Chatwoot Cloud.

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

## الخطوة 1: إنشاء أو اختيار مستخدم نظام

1. افتح [إعدادات أعمال Meta](https://business.facebook.com/settings).

2. اختر محفظة الأعمال التي تملك حساب WhatsApp Business.

3. انتقل إلى **المستخدمون → مستخدمو النظام**.

4. اختر مستخدم نظام إداري موجود.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCR0dMQXdZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--b0301cc5cae2be5aaa1bdea255fdcb98f07c0676/CleanShot%202026-07-16%20at%2012.43.38@2x.png)

إذا لم يكن لديك واحد:

1. انقر **إضافة**.

2. أدخل اسماً مميزاً، مثل `مزامنة قوالب Chatwoot`.

3. اختر **مسؤول** كدور مستخدم النظام.

4. انقر **إنشاء مستخدم نظام**.

> استخدم مستخدم نظام مخصص عندما يكون ذلك ممكنًا. هذا يسهل عملية تدوير أو إبطال الرمز دون التأثير على عمليات التكامل الأخرى.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSWVJQXdZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--78c11bcf0debca0238f754f74b589d324a1a2bbd/CleanShot%202026-07-16%20at%2012.45.15@2x.png)

## الخطوة 2: إسناد حساب WhatsApp Business

يجب أن يكون لدى مستخدم النظام حق الوصول إلى نفس حساب WhatsApp Business المستخدم في صندوق بريد Chatwoot الخاص بك.

1. اختر مستخدم النظام.

2. افتح **الأصول المسندة**.

3. انقر **إسناد الأصول**.

4. اختر **حسابات WhatsApp**.

5. اختر حساب WhatsApp Business المتصل بـ Chatwoot.

6. امنحه إذن إدارة الحساب أو فعّل التحكم الكامل.

7. احفظ التغييرات.

خصص فقط حساب WhatsApp Business المتأثر. تجنب منح حق الوصول إلى أصول أعمال غير ذات صلة.

## الخطوة 3: توليد الرمز

1. اختر مستخدم النظام.

2. انقر **توليد رمز**.

3. اختر تطبيق Meta المرتبط بحساب WhatsApp Business الخاص بك.

4. انقر **التالي**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCR09KQXdZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--95fef31ab9b7d3e2fd1d71d9354b99da0659009a/CleanShot%202026-07-16%20at%2012.45.37@2x.png)

## الخطوة 4: اختيار فترة انتهاء الصلاحية

قد تعرض Meta خيارات مثل:

* **60 يومًا:** أكثر أمانًا، ولكن يجب عليك استبدال الرمز عند انتهاء صلاحيته.

* **أبدًا:** يقلل من الصيانة التشغيلية، لكنه يتطلب تخزينًا آمنًا وتدويرًا يدويًا.

اختر الخيار الذي يتبع سياسة الأمان في منظمتك.

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

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSm1KQXdZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--5f7a74cebe6ed7e9cb1aa6f57f17e4e7a7f9ca38/CleanShot%202026-07-16%20at%2012.45.48@2x.png)

## الخطوة 5: اختيار الإذن المطلوب

اختر:

* `whatsapp_business_management`

هذا هو الإذن الذي يتحقق منه Chatwoot ويستخدمه لمزامنة قوالب الرسائل.

لا تحتاج إلى اختيار `whatsapp_business_messaging` أو `whatsapp_business_manage_events` لهذا الرمز الخاص بمزامنة القوالب.

إذا كان `whatsapp_business_management` غير متوفر، تحقق من أن:

* التطبيق المختار لديه WhatsApp مُكوّن.

* لدى مستخدم النظام حق الوصول إلى التطبيق.

* تم إسناد حساب WhatsApp Business لمستخدم النظام.

* عملك وتطبيقك يحققان متطلبات وصول Meta.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSEtLQXdZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a4f05fee7400e43f152861009d0c5530253ad224/CleanShot%202026-07-16%20at%2012.46.27@2x.png)

## الخطوة 6: نسخ الرمز

1. أكمل عملية توليد الرمز.

2. انقر **نسخ**.

3. خزّن الرمز مؤقتًا في مدير كلمات مرور آمن أو خزينة الأسرار.

قد تعرض Meta الرمز الكامل مرة واحدة فقط.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSTJLQXdZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0fbc15e336b812fe225653fa0366033f47aaaf96/CleanShot%202026-07-16%20at%2012.47.35@2x.png)

## الخطوة 7: إضافة الرمز إلى Chatwoot

1. في Chatwoot، انتقل إلى **الإعدادات → صناديق البريد**.

2. اختر صندوق بريد WhatsApp المتأثر.

3. افتح علامة تبويب **الإعدادات**.

4. ابحث عن **تحديث رمز إدارة الأعمال**.

5. الصق الرمز.

6. انقر **تحديث**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRW5IQkFZPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a51b61228dfb14305fd16478989664a41542ac43/CleanShot%202026-07-29%20at%2011.27.09@2x.png)

يتحقق Chatwoot من أن الرمز يحتوي على إذن `whatsapp_business_management` الممنوح قبل حفظه.

بعد حفظ الرمز، انقر **مزامنة القوالب**. يجب أن تظهر قوالب WhatsApp المعتمدة لديك بعد اكتمال المزامنة. لاستبدال الرمز، أنشئ رمزًا جديدًا في إعدادات أعمال Meta وادخله في نفس حقل إعدادات Chatwoot. سيستخدم Chatwoot الرمز الجديد لمزامنة القوالب المستقبلية.

> سيؤدي إبطال الرمز المحفوظ في Meta دون استبداله في Chatwoot إلى فشل مزامنة القوالب.

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

### الرمز لا يحتوي على الإذن المطلوب

تأكد من أنه تم اختيار ومنح إذن `whatsapp_business_management` عند توليد الرمز.

### لا تملك حق الوصول إلى هذا الحقل

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

### الرمز غير صالح أو لا يمكن التحقق منه

قد يكون الرمز قد انتهت صلاحيته أو تم إبطاله أو تم توليده لتطبيق أو عمل مختلف. أنشئ رمزًا جديدًا وحاول مرة أخرى.

### تم قبول الرمز، ولكن لا يمكن مزامنة القوالب

تحقق من أن:

* لدى مستخدم النظام حق الوصول إلى نفس حساب WhatsApp Business المستخدم في صندوق البريد.

* معرف حساب الأعمال المُكوّن في Chatwoot صحيح.

* القوالب موجودة في حساب WhatsApp Business ذاك.

* لم يتم حذف القوالب أو نقلها إلى حساب آخر.

قد يكون الإذن صالحًا ولكن لا يزال الوصول إلى أصول WhatsApp المحددة مفقودًا.

### الرسائل تعمل، لكن مزامنة القوالب تفشل

تستخدم عمليات الرسائل وإدارة الأعمال أذونات مختلفة. يمكن أن تظل بيانات الاعتماد ترسل وتستقبل الرسائل بينما تفتقر إلى القدرة على جلب القوالب.