هذا الدليل يساعدك في نقل صندوق وارد WhatsApp Cloud الحالي إلى الإعداد اليدوي في Chatwoot. تضمن عملية الترحيل بقاء صندوق الوارد الحالي كما هو. يتم الحفاظ على المحادثات وجهات الاتصال والمتعاونين وقواعد التوجيه وساعات العمل وإعدادات CSAT وإعدادات الروبوت والإعدادات الأخرى للصندوق.

> **أرقام WhatsApp التي تدعم التعايش قيد المراجعة حالياً. إذا كان رقم WhatsApp الخاص بك مستخدماً أيضاً في تطبيق WhatsApp Business، يرجى التواصل مع دعم Chatwoot قبل بدء هذه الترحيل.**

قبل بدء عملية الترحيل، اجمع تفاصيل واجهة WhatsApp Cloud API المطلوبة من Meta: معرف WABA، معرف رقم الهاتف، ورمز وصول دائم لمستخدم النظام. استخدم الخطوات أدناه لإنشاء أو اختيار تطبيق Meta، إضافة أو اختيار رقم WhatsApp، وإنشاء الرمز.

## احصل على تفاصيل WhatsApp Cloud API من Meta

لإكمال الترحيل، تحتاج إلى ثلاثة تفاصيل من Meta:

* **معرف حساب WhatsApp التجاري**

* **معرف رقم الهاتف**

* **رمز وصول دائم أو رمز مستخدم النظام**

يمكنك الحصول على معرف حساب WhatsApp التجاري ومعرف رقم الهاتف من تطبيق Meta الخاص بك.

### إنشاء أو اختيار تطبيق Meta

اذهب إلى [Meta for Developers](https://developers.facebook.com/apps/) إما لاختيار تطبيق موجود أو انقر على **Create App**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFZCNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--1f606325708a807b616377c294d8f6ab773405c4/choose-or-create-app.png)

\
إذا كنت تنشئ تطبيقاً جديداً، أدخل اسم التطبيق وبريد التواصل، ثم انقر على **Next**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRFJDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a289d00dec522df84ce9008ea0fdb583f32bdd77/create-app.png)

### اختر حالة استخدام WhatsApp

في شاشة اختيار حالة الاستخدام، اختر **Connect with customers through WhatsApp**، ثم انقر على **Next**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRkZDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a530ad1de8ee93a4cb598179012b8bd3e7fecfca/choose-whatsapp-use-case.png)

### اختر محفظة الأعمال

حدد محفظة الأعمال المالكة أو التي ستملك حساب WhatsApp التجاري الخاص بك.

إذا لم يكن لديك محفظة أعمال بالفعل، يمكنك إنشاؤها في هذه الخطوة أو المتابعة وإنشاؤها لاحقاً إذا سمحت Meta بذلك.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSUJDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--84077f3925813b62827752465f321f3f7850b7cc/choose-portfolio.png)

### راجع متطلبات النشر

قد تعرض Meta متطلبات النشر للتطبيق وحالة الاستخدام المختارين. راجع المتطلبات ثم اضغط **Next**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCS0pDNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8a8ee0aa597971b88d6b962b88b3590f73f8aae8/publishing-requirments.png)

### راجع وأنشئ التطبيق

راجع تفاصيل التطبيق، حالة استخدام WhatsApp المحددة، ومحفظة الأعمال المتصلة. اضغط **Create app** لإكمال الإنشاء.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTnRONHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--cb19f0f9ed989a0fa8a59f8aeed546ba7daa5b05/review.png)

### افتح إعداد WhatsApp API

بعد إنشاء التطبيق أو اختياره:

1. انقر على **Use cases** في الشريط الجانبي.

2. ابحث عن **Connect with customers through WhatsApp**.

3. انقر على **Customize**.

4. انقر على API Setup.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFpENHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--6d166ce9f67c24dd28dc4584f38ad4cd42eba7d2/use-case.png)

في واجهة تطبيق Meta الجديدة، اذهب إلى **Basic setup → Step 2. Production setup** وافتح **Register your WhatsApp phone number**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCR1JPNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ea20129b52437bce02873cb8b19e369f3dc1f8d9/new-ui-add-or-use-number.png)

في تطبيقات Meta الأقدم، افتح **WhatsApp → API setup** من الشريط الجانبي الأيسر.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTDVENHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--52d9b1ad6ec3ab149aea026c3422be5b5ec92963/old-ui-api.png)

### أضف أو اختر رقم WhatsApp الخاص بك

في قسم **Send and receive messages** أو **Register your WhatsApp phone number**، اختر رقماً موجوداً من محدد **From**، أو اضغط **Add phone number**.

\
إذا كنت تضيف رقماً جديداً:

1. أدخل اسم العرض التجاري في WhatsApp وتفاصيل العمل.

2. أدخل رقم الهاتف.

3. اختر التحقق برسالة SMS أو مكالمة هاتفية.

4. أدخل رمز OTP من Meta للتحقق من الرقم.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSXhGNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--06635673d9dca75d676567697983cc9c3b1dd7bc/create-business-portfolio.png)

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRXhGNHdVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--2d87c35170f160b0d364c77df3e0813651d013fb/add-number.png)

### انسخ المعرفات المطلوبة

بعد إضافة أو اختيار الرقم، انسخ القيم التالية من صفحة إعداد API:

* **معرف رقم الهاتف**

* **معرف حساب WhatsApp التجاري**

ستحتاج إلى لصق هذه القيم في تدفق الترحيل في Chatwoot.

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

في واجهة Meta القديمة، تظهر هذه القيم مباشرة أسفل محدد **From** في **WhatsApp → API setup**.

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

> تقوم Meta بتغيير هذه الواجهة بشكل متكرر. إذا كانت شاشتك مختلفة، ابحث عن صفحة إعداد WhatsApp API ورقم المرسل المحدد. غالباً ما يظهر معرف رقم الهاتف ومعرف حساب WhatsApp التجاري بالقرب من رقم **From** المحدد.

## إعداد رمز وصول دائم لـ WhatsApp Cloud API

ستحتاج أيضاً إلى رمز وصول دائم لمستخدم النظام مع صلاحيات WhatsApp. يتيح هذا الرمز لـ Chatwoot الاتصال برقم WhatsApp Cloud API الخاص بك وإرسال واستلام الرسائل ومزامنة قوالب الرسائل.

### افتح مستخدمي النظام في إعدادات Meta للأعمال

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

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

3. انتقل إلى **Users → System users**.

4. إذا كان لديك بالفعل مستخدم نظام لـ Chatwoot، قم باختياره.

5. إذا لم يكن لديك واحد، اضغط **Add**.

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

### أنشئ مستخدم نظام

1. أدخل اسماً لمستخدم النظام، مثل `Chatwoot WhatsApp`.

2. اختر **Admin** كدور لمستخدم النظام.

3. انقر على **Create system user**.

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

### أنشئ رمزاً

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

2. انقر على **Generate token**.

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

### اختر تطبيق Meta

اختر تطبيق Meta الذي أنشأته أو اخترته مسبقاً لإعداد WhatsApp Cloud API، ثم انقر على **Next**.

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

### تعيين صلاحية انتهاء الرمز

اختر **Never** كخيار لانتهاء الرمز، ثم اضغط **Next**.

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

### تعيين الصلاحيات

اختر صلاحيات WhatsApp المطلوبة:

* `whatsapp_business_messaging`

* `whatsapp_business_management`

ثم تابع لإنشاء الرمز.

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

### انسخ الرمز

بعد أن تقوم Meta بإنشاء الرمز، اضغط **Copy** واحتفظ به بشكل آمن. ستقوم بلصق هذا الرمز في خطوة **Access token** في تدفق الترحيل في Chatwoot.

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

> احتفظ بهذا الرمز بشكل خاص. أي شخص لديه حق الوصول إليه قد يتمكن من استخدام اتصال WhatsApp Cloud API الخاص بك.

## ابدأ الترحيل

1. اذهب إلى **Settings → Inboxes**.

2. افتح صندوق وارد WhatsApp المتصل عبر التسجيل المضمن.

3. اضغط **Start manual migration**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRllnMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--0fed8e7f92b6a0dacb1a1ca68422eeec6a431a47/CleanShot%202026-07-13%20at%2014.28.42@2x.png)

سيقوم Chatwoot بفتح تدفق ترحيل موجه.

## الخطوة 1: راجع ما سيتغير

الخطوة الأولى تشرح ما سيتم الحفاظ عليه وما سيتم تحديثه.

محفوظ:

* المحادثات

* جهات الاتصال

* المتعاونون

* التوجيه

* ساعات العمل

* إعدادات الصندوق

مُحدّث:

* معرف WABA

* معرف رقم الهاتف

* رمز الوصول

* إعداد الويب هوك

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCT01nMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--9e1d089787f62140ca6ee62fb27f44417f083d5c/CleanShot%202026-07-13%20at%2014.30.08@2x.png)

اضغط **Continue**.

## الخطوة 2: أدخل تفاصيل العمل

أدخل تفاصيل أصل WhatsApp من Meta.

الحقول:

* **WABA ID**: حساب WhatsApp التجاري الذي يملك هذا الرقم.

* **Phone Number ID**: معرف Meta الفريد لرقم WhatsApp المتصل بهذا الصندوق.

* **Display phone number**: رقم WhatsApp الظاهر للعملاء. لا يمكن تغييره أثناء الترحيل.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRkFrMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3554a80c878cdecba4de08b8c42ed6cb1a5a98fd/CleanShot%202026-07-13%20at%2014.35.38@2x.png)

اضغط **Continue**.

## الخطوة 3: أضف رمز الوصول

الصق رمز وصول دائم أو رمز مستخدم نظام مع صلاحيات WhatsApp. يجب أن يتضمن الرمز **whatsapp_business_messaging، whatsapp_business_management، و whatsapp_business_manage_events**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCSTBrMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--365e188d56d91c2b5adf3f3030e484f0e71d9614/CleanShot%202026-07-13%20at%2014.36.18@2x.png)

## الخطوة 4: راجع وأعد الاتصال

راجع الصندوق، رقم الهاتف، معرف WABA، ومعرف رقم الهاتف قبل تطبيق التغييرات.

سيتحقق Chatwoot من بيانات الاعتماد مع Meta قبل تطبيق التغييرات. إذا فشلت عملية التحقق، تظل التهيئة الحالية دون تغيير.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCRThsMndVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--57a16743b6aad7c8870c8e50e96c37ef93e271a7/CleanShot%202026-07-13%20at%2014.37.18@2x.png)

اضغط **Reconnect WhatsApp inbox** لإكمال الترحيل.

## بعد الترحيل

بعد نجاح الترحيل، يبقى الصندوق كما هو في Chatwoot، ولكن اتصال WhatsApp يستخدم إعداد WhatsApp Cloud API اليدوي.

يجب عليك التحقق من:

* الرسائل الواردة

* الردود الصادرة

* إرسال الرسائل النموذجية

* مزامنة القوالب

* تسليم الويب هوك

## هل تحتاج مساعدة؟

إذا لم تكن متأكداً من أي خطوة، يرجى التواصل مع دعم Chatwoot. يمكننا مساعدتك في التحقق من تفاصيل Meta المطلوبة والمساعدة في عملية الترحيل.