الاتصال بواجهة برمجة تطبيقات واتساب السحابية (إعداد يدوي)

Sojan

Sojan

آخر تحديث في Oct 21, 2026

استخدم الإعداد اليدوي إذا كان رقمك مسجلًا بالفعل على منصة واتساب للأعمال (API)، أو كنت مزودًا تقنيًا تقوم بإعداد رقمك الخاص، أو كنت مستضيفًا ذاتيًا بدون إعداد سريع مهيأ، أو إذا كان الإعداد السريع غير متاح. ستقوم بربط Chatwoot بـ تطبيق Meta الخاص بك.

الخطة والوصول

  • كل خطة تتضمن واتساب (الشركات الناشئة وما فوقها، والتجربة المجانية) على Chatwoot Cloud، والمستضيف ذاتيًا. انظر الأسعار والخطط.

  • للمسؤولين فقط.

  • التواجد المشترك (الاحتفاظ بتطبيق واتساب للأعمال) غير مدعوم مع الإعداد اليدوي. إذا كان رقمك نشطًا في تطبيق واتساب للأعمال، لا تقم بتسجيله عبر هذه العملية. استخدم الإعداد السريع مع Meta أو تواصل مع الدعم.

قبل أن تبدأ

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

  • تطبيق Meta بحالة استخدام واتساب

  • معرّف رقم الهاتف و معرّف حساب واتساب للأعمال لرقمك

  • رمز وصول دائم من مستخدم نظام في Meta

ربط رقمك

  1. انتقل إلى الإعدادات › صناديق البريد › إضافة صندوق بريد › واتساب واختر واتساب كلاود. في شاشة الإعداد السريع، انقر على مسار الإعداد اليدوي في الأسفل. (إذا كان الإعداد السريع غير متاح، ستنتقل مباشرة إلى الإعداد اليدوي.)

  2. أنشئ أو اختر تطبيق Meta. في منصة مطوري Meta، أنشئ تطبيقًا (أو اختر التطبيق الذي تستعمله بالفعل لهذا الرقم)، واختر الاتصال مع العملاء عبر واتساب، وانقُل ملكية الرقم لمحفظة الأعمال التي تملك الرقم. انقر على تطبيقي على Meta جاهز.

  3. أضف رقم هاتفك واحصل على المعرفات. في تطبيق Meta الخاص بك، افتح حالة استخدام واتساب واختر إعداد API (حالات الاستخدام › الاتصال مع العملاء عبر واتساب › تعديل › إعداد API). في التطبيقات الأحدث، انتقل إلى الإعداد الأساسي › الإعداد للإنتاج ثم افتح تسجيل رقم واتساب الخاص بك بدلًا من ذلك. في إرسال واستقبال الرسائل (أو تسجيل رقم واتساب الخاص بك)، افتح مُحدد من واختر رقمك، أو اختر إضافة رقم هاتف، وأكمل ملف تعريف العمل وفعّل الرقم عبر الرمز الذي ترسله Meta عبر رسالة نصية أو مكالمة هاتفية. تغير Meta هذه الشاشة بشكل متكرر. عادة ما يظهر معرّف رقم الهاتف و معرّف حساب واتساب للأعمال بجوار رقم من المختار. انسخ معرّف رقم الهاتف و معرّف حساب واتساب للأعمال، أدخلهما في Chatwoot، ثم انقر التالي.

  4. أنشئ رمز وصول دائم. في إعدادات أعمال Meta، اختر محفظة الأعمال التي تملك حساب واتساب للأعمال الخاص بك، ثم انتقل إلى المستخدمون › مستخدمو النظام. أنشئ مستخدم نظام إداري (أو اختر واحدًا)، وعين له تطبيق Meta الخاص بك وحساب واتساب للأعمال مع كامل الصلاحيات، ثم انقر إنشاء رمز. اختر تطبيق Meta الذي أنشأته، واضبط تاريخ الانتهاء على أبدًا، وحدد whatsapp_business_management و whatsapp_business_messaging، وانسخ الرمز. تعرض Meta هذا الرمز مرة واحدة فقط. عد إلى Chatwoot، والصقه كـ رمز وصول دائم وانقر تحقق من التفاصيل.

  5. راجع اسم الشركة والرقم والمعرفات، وغيّر اسم صندوق البريد إذا رغبت، ثم انقر إنشاء صندوق بريد.

  6. يتحقق Chatwoot من وصول الرقم، ووصول القوالب، واستدعاء Webhook واشتراك Webhook، ويضبط Webhook تلقائيًا في Meta. عند تحقق جميع الأربع كما هو مطلوب (تم التحقق)، انقر متابعة لإضافة الوكلاء.

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

احتفظ برمزك سريًا. أي شخص يمتلكه يمكنه استخدام اتصال واتساب الخاص بك. إذا استبدلته أو ألغيت صلاحيته في Meta، حدّثه في علامة تبويب الإعدادات لصندوق البريد.

إذا فشلت خطوة التحقق

الرسالة ما يجب فعله
رمز الوصول هذا غير صالح أو منتهي الصلاحية أنشئ رمز وصول دائم جديد (تاريخ الانتهاء أبدًا) وحاول مرة أخرى
وصول القوالب لم يتم التحقق منه الرمز يفتقد whatsapp_business_management. الرسائل ستعمل، لكن القوالب لن تتزامن. أنشئ رمزًا بصلاحيات كلا التصريحين.
استدعاء Webhook أو اشتراك Webhook لم يتم التحقق منهما انقر إعادة محاولة إعداد Webhook. إذا استمر الفشل، تأكد أن مستخدم النظام لديه كامل الصلاحيات على حساب واتساب للأعمال. إذا استمرت الإعادة بالفشل، قم بتعيين Webhook يدويًا: انسخ رابط Webhook ورمز تحقق Webhook المعروضين في شاشة النهاية (الرمز أيضًا في علامة تبويب الإعدادات في صندوق البريد). في تطبيق Meta، انتقل إلى واتساب › الإعدادات، والصق القيمتين، وانقر تحقق وحفظ، ثم اشترك في حقل الرسائل.
أدخل معرف رقم الهاتف ومعرف حساب واتساب للأعمال انسخ كليهما من إعداد API في تطبيق Meta الخاص بك. إنهما رقمان مختلفان.

لأي أمر آخر، راجع استكشاف مشاكل واتساب.

ماذا يحدث بعد ذلك

ربط أكثر من رقم

نعم، يمكنك ذلك. أنشئ صندوق بريد منفصل في Chatwoot لكل رقم. الإعداد التوجيهي سيضبط توجيه Webhook لكل واحد، لذا لا حاجة لأي إعداد يدوي.