كيفية إعداد قناة واتساب (الإجراء اليدوي)؟

قم بتوصيل رقم WhatsApp Business الخاص بك مع Chatwoot باستخدام WhatsApp Cloud API من Meta. يشرح هذا الدليل كيفية تجهيز حساب Meta الخاص بك، وتوليد رمز الوصول المطلوب، وإنشاء صندوق بريد WhatsApp الخاص بك في Chatwoot.

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

WhatsApp Cloud API مستضاف من قبل Meta ومتاحة للشركات والمطورين الأفراد. تتيح لك الاتصال مباشرة بمنصة WhatsApp Business دون الاعتماد على مزود خارجي لاستضافة الـ API.

لإنشاء صندوق بريد WhatsApp، ستحتاج إلى ثلاث تفاصيل من Meta:

• معرّف حساب WhatsApp Business

• معرّف رقم الهاتف

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

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

أنشئ أو اختر تطبيق Meta

اذهب إلى Meta for Developers واختر تطبيقًا موجودًا أو انقر على Create App.

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

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

في شاشة تحديد حالة الاستخدام، اختر التواصل مع العملاء عبر WhatsApp، ثم انقر على Next.

اختر الحافظة التجارية

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

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

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

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

مراجعة وإنشاء التطبيق

راجع تفاصيل التطبيق، حالة استخدام WhatsApp المختارة، والحافظة التجارية المتصلة. انقر على Create app للانتهاء.

فتح إعداد WhatsApp API

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

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

2. ابحث عن التواصل مع العملاء عبر WhatsApp.

3. انقر على Customize.

4. انقر على إعداد الـ API.

في واجهة تطبيق Meta الجديدة، انتقل إلى Basic setup → Step 2. Production setup وافتح تسجيل رقم هاتف WhatsApp الخاص بك.

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

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

إذا كان هذا الرقم نشطًا حاليًا في تطبيق WhatsApp Business، لا تقم بحذفه أو تسجيله يدويًا من خلال هذه العملية. استخدم تدفق Chatwoot’s Embedded Signup/Coexistence أو اتصل بدعم Chatwoot.

في قسم إرسال واستقبال الرسائل أو تسجيل رقم هاتف WhatsApp الخاص بك، اختر رقم موجود من محدد From، أو انقر على Add phone number.

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

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

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

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

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

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

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

• معرّف رقم الهاتف

• معرّف حساب WhatsApp Business

ستحتاج إلى لصق هذه القيم في عملية الإعداد اليدوي.

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

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

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

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

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

1. افتح إعدادات أعمال Meta.

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

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

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

5. إذا لم يكن لديك، انقر على Add.

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

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

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

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

توليد رمز

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

2. انقر على Assign assets.

3. عين تطبيق Meta وحساب WhatsApp Business.

4. منح التحكم المطلوب.

5. انقر على Generate token.

اختر تطبيق Meta

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

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

اختر Never لانتهاء صلاحية الرمز، ثم انقر على Next.

تعيين الأذونات

اختر الأذونات المطلوبة لـ WhatsApp:

• whatsapp_business_messaging

• whatsapp_business_management

ثم تابع لتوليد الرمز.

نسخ الرمز

بعد أن تقوم Meta بتوليد الرمز، انقر على Copy واحفظه بشكل آمن.

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

ربط حسابك في Chatwoot

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

ادخل رقم هاتفك، معرّف رقم الهاتف، معرّف الحساب التجاري، ورمز الوصول الذي حصلت عليه في الخطوة السابقة.

أضف أعضاء فريقك إلى صندوق بريد WhatsApp الخاص بك

انسخ رابط webhook و رمز التحقق المقدمين هنا

إعداد الـ Webhook الخاص بك

نحن بحاجة إلى إعداد Webhook الخاص بـ WhatsApp لاستقبال رسائل العملاء الواردة المرسلة إلى رقم عملك.

يجب أن يكون رابط الاستدعاء (callback URL) الخاص بك على الشكل التالي: https://app.chatwoot.com/webhooks/whatsapp/{phone_number}.

سجّل الدخول إلى حسابك في Facebook Developer واذهب إلى WhatsApp > Configuration

الصق رابط الـ webhook ورمز التحقق من Chatwoot، ثم اضغط على "Verify and Save"

قم بضبط أذونات الـ webhook بالاشتراك في الرسائل

لقد انتهيت! يمكنك الآن بدء إرسال رسائل WhatsApp عبر Chatwoot.

الأسئلة الشائعة

كيف يمكن إعداد عدة أرقام تحت تطبيق Meta واحد؟

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

ما نوع قوالب WhatsApp المدعومة في Chatwoot؟

يرجى مراجعة الوثائق لمزيد من التفاصيل حول القوالب.

ما أنواع الوسائط المدعومة؟