تكوين قناة WhatsApp للأعمال (API)

تكوين اسم قناة WhatsApp

يمكن تكوين قناة WhatsApp Business Platform (API) باستخدام اسم قناة فريد.

الخطوة 1: انتقل إلى إعدادات مساحة العمل > انقر على القنوات.

الخطوة 2: حدد قناة منصة واتساب للأعمال (API) > انقر على إدارة.

الخطوة 3: قم بتكوين اسم القناة الذي يُستخدم داخليًا لتحديد الحساب.

الخطوة 4: انقر على حفظ التغييرات لتحديث إعدادات القناة.

إدارة الملف الشخصي لمنصة WhatsApp Business (API)

إذا كانت هناك حاجة لإجراء تغيير أو التحقق من ملف تعريف منصة واتساب للأعمال (API) الخاص بك، فيمكن القيام بذلك على منصة respond.io.

الخطوة 1: انتقل إلى إعدادات مساحة العمل > انقر على القنوات.

الخطوة 2: حدد قناة منصة واتساب للأعمال (API) > إدارة > الملف الشخصي

الخطوة 3: إذا لم تتم مزامنة الملف الشخصي، فانقر على مزامنة الملف الشخصي للحصول على أحدث معلومات ملف تعريف منصة واتساب للأعمال من WhatsApp.

الخطوة 4: يمكنك تعديل المعلومات التالية حسب الحاجة:

الخطوة 5: راجع المعلومات وانقر على حفظ الملف الشخصي.

البيانات الوصفية التي تلقتها القناة

توفر القنوات المختلفة مجموعات مختلفة من بيانات التعريف الخاصة بجهة الاتصال لمنصة response.io. يمكنك الحصول على بيانات جهة الاتصال التالية'من هذه القناة:

• رقم التليفون

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

• اسم الملف الشخصي

• معرف واتساب

أنواع الملفات المدعومة

أنواع الملفات التي يدعمها واتساب والحد الأقصى لحجم الملف لهذا النوع هو كما يلي:

• الصوت & الفيديو (16 ميجابايت)

• مستند (100 ميجابايت)

• الصورة (5 ميجا بايت)

• ملصق (100 كيلوبايت)

سيتم عرض الرسائل غير المدعومة على شكل عرض احتياطي مع نص الرسالة غير المدعومة أو الحمولة المخصصة والنوع (إذا كان متاحًا). بالنسبة لأي نوع ملف غير مدعوم أو ملف يتجاوز الحد الأقصى لحجم الملف المرسل عبر WhatsApp Business Platform (API)، سيتم تحويل الملف تلقائيًا إلى رابط URL على منصة response.io. بالنسبة للحمولة المخصصة (Custom Payload)، يمكنك النقر على عرض المزيد لعرض حمولة JSON لهذه الرسالة. أمثلة على الرسائل غير المدعومة لمنصة WhatsApp Business (API) هي:
- بطاقة جهة الاتصال
- ردود الفعل
- الرسالة المحذوفة
- الاستطلاعات
- الرسالة المؤقتة

تأكد من دعم تنسيق الملف الخاص بملفك؛ وإلا فقد يفشل إرسال الملف على الرغم من كونه ضمن حد الحجم. يحدث هذا عندما لا يتم تحويل الملف بشكل صحيح. تعرف على أنواع الوسائط المدعومة هنا.

تنسيق النص

يمكنك استخدام تنسيق النص أو التنسيق المختصر في رسائلك. تعرف على المزيد حول كيفية تنسيق نصك هنا.

حدود المعدل

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

القيود

مجموعات واتساب

لا يدعم WhatsApp Business Platform (API) الرسائل الجماعية. لقد أوقفت شركة ميتا تطوير هذه الميزة.

أنواع الأرقام غير المدعومة

لا تسمح WhatsApp بأرقام VoIP أو الأرقام المجانية أو الخطوط الأرضية. يشمل ذلك:

• أرقام Telnyx (لم تعد مدعومة منذ يناير 2023)

• أرقام Google Voice (VoIP)

ممارسات أفضل لتجنب تعطيل WABA

لضمان استقرار إعداد منصة واتساب للأعمال (API) على المدى الطويل وتجنُّب الحظر أو الانقطاعات غير المتوقعة، اتبع أفضل الممارسات التالية:

استخدم Meta Business Manager (MBM) موثقًا وفريدًا

• استخدم فقط MBM واحدًا لكل نشاط تجاري. قد يتم تمييز إنشاء عدة MBM بنفس اسم النشاط التجاري أو العنوان أو الموقع الإلكتروني بواسطة Meta.

• إذا تم حظر MBM سابقًا، فتجنب استخدام نفس بيانات النشاط التجاري لإنشاء واحد جديد—قد تقوم Meta بحظره فورًا.

• قم بالتحقق من MBM عن طريق تقديم مستندات رسمية للنشاط التجاري (مثل رخصة العمل، الموقع الإلكتروني المطابق).

• تحكم في الوصول بعناية: امنح حقوق المسؤول فقط لملفات Facebook حقيقية ذات نشاط مستمر (منشورات، أصدقاء، إلخ).

• فعّل المصادقة الثنائية (2FA) لجميع المسؤولين.

أدِر حسابات WhatsApp Business (WABA) بمسؤولية

• إذا تم حظر WABA، قدّم استئنافًا عبر دعم Meta. لا تنشئ حسابًا جديدًا أثناء انتظار نتيجة الاستئناف—قد يُنظر إلى ذلك على أنه التحايل على السياسات.

• استخدم أسماء العرض الواضحة والدقيقة. على سبيل المثال، «Acme Co – California» أفضل من مجرد «Acme».

• لا تحذف وتُعيد إنشاء أرقام الهاتف بشكل متكرر (ما يُسمى "حرق" الأرقام). بدلاً من ذلك، قم بحل المشكلة المبلغ عنها عبر Meta.

تعامل مع مستخدمي Facebook بالطريقة الصحيحة

• يجب على المسؤولين استخدام حسابات Facebook أصلية ذات تاريخ حقيقي.

• تجنّب استخدام حسابات جديدة المنشأ أو مكررة فقط لأغراض الوصول.

• قَيِّد الوصول لأعضاء الفريق الضروريين وقُم بمراجعة مستخدمي MBM بانتظام.

• فرض 2FA لتقليل خطر الوصول غير المصرح به.

حافظ على توافق بيانات نشاطك التجاري عبر المنصات

• تأكد من أن اسم النشاط التجاري، العنوان، الموقع الإلكتروني، وغيرها من التفاصيل متطابقة عبر MBM وWABA وحساب الإعلانات.

• هذا التوافق يزيد الثقة لدى Meta ويحسّن فرصك في التحقق.

إذا تم تعطيل WABA

• لا داعي للذعر ولا تنشئ WABA جديدًا.

• قدّم استئنافًا عبر دعم أعمال Meta.

• اجمع وقدم المستندات اللازمة (مثل رخصة العمل، إثبات ملكية النطاق).

• راجع وصحّح أي انتهاكات لسياسة الرسائل التجارية لدى Meta Business Messaging Policy.

اتباع هذه الممارسات يساعد في ضمان بقاء إعداد WhatsApp الخاص بك آمنًا ومستقرًا ومتوافقًا مع سياسات Meta.

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

ما المتطلبات لرقم الهاتف المستخدم للتسجيل في منصة WhatsApp Business (API)؟

• لا يمكن استخدام رقم الهاتف المُستخدم في منصة واتساب للأعمال (API) في تطبيق واتساب الشخصي أو تطبيق واتساب للأعمال. سيتعين عليك حذف الحساب من تطبيق واتساب الشخصي أو من تطبيق واتساب للأعمال قبل أن تتمكن من استخدام الرقم للتسجيل في منصة واتساب للأعمال (API).

• يمكنك الاستمرار في استخدام رقم الهاتف لأغراض أخرى، مثل إجراء المكالمات واستقبال الرسائل النصية بعد تسجيله في منصة WhatsApp Business.

هل يمكنني عرض تحليلات المحادثات لحساب WhatsApp Business الخاص بي؟

نعم، يمكنك مراقبة تحليلات الرسائل والإنفاق في الوقت الفعلي لحساب WhatsApp Business الخاص بك في علامة التبويب الرؤى في مدير WhatsApp على Meta. اقرأ المزيد هنا.

لماذا أرى جهات اتصال مكررة من نفس قناة WhatsApp؟

تمرّر WhatsApp رقم هاتف جهة الاتصال في صيغة تختلف عن صيغة E.164 التي يستخدمها respond.io. هذا الاختلاف يسبب تكرار جهات الاتصال من بعض البلدان. إذا حدث ذلك، تواصل معنا هنا.

كيف أجعل اسم نشاطي التجاري يظهر لجهات الاتصال على WhatsApp بدلًا من رقم النشاط التجاري؟

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

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

ما هو كتالوج منتجات Meta وكيف أستطيع استخدامه؟

كتالوج منتجات Meta هو ميزة تتيح لك إنشاء كتالوج لمنتجاتك ومشاركته مع عملائك. تعرف على كيفية استخدام كتالوج منتجات Meta في respond.io هنا.

هل يمكن لشركة فرعية أو وكالة تسجيل حساب WhatsApp Business نيابةً عن شركة أخرى؟

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

كم عدد أرقام الهاتف التي يمكن لأي نشاط تجاري تسجيلها عند الاشتراك في منصة WhatsApp Business (API) وكيف يمكنني زيادة هذا الحد؟

عند تسجيل نشاط تجاري في منصة واتساب للأعمال (API) وكان غير موثق، يمكنه تسجيل ما يصل إلى رقمين فقط. يمكن للأعمال الموثقة تسجيل المزيد من أرقام الهاتف. قد يسجلون ما يصل إلى 20 رقم هاتفًا لمدير أعمال واحد.

إذا توقفت عند حد أدنى مثل 5 أرقام ولم تتمكن من تسجيل أرقام إضافية، يمكنك تقديم تذكرة مباشرةً إلى Meta لطلب زيادة حد أرقام الهاتف.

الخطوات:

1. انقر هنا هذا الرابط للدعم المباشر.

2. اذهب إلى Ask a Question > WABiz: Account & WABA > Request type > Increase Phone Number Limits

3. قدّم شرحًا لسبب رغبتك في زيادة حد أرقام الهاتف.

4. قدّم طلبك.

كيف يمكنني التحقق من استهلاك محادثات WhatsApp الخاصة بي؟

للتحقق من استهلاك محادثات WhatsApp، اتبع الخطوات التالية:

1. انتقل إلى Meta Business Manager.

2. انقر على Settings > Business Settings > WhatsApp Accounts

3. اختر WABA الخاص بك وانقر على Settings > WhatsApp Manager.

4. ضمن أدوات الحساب، انقر على الرؤى.

لماذا تظهر الرسالة كرسالة غير مدعومة مع رمز الخطأ: 131051؟

أحد الأسباب المحتملة هو أن حسابات WhatsApp API غير مصممة للدردشة مع حسابات WhatsApp API الأخرى. هذا قيد من Meta. لاحظ أن رمز الخطأ: 131051 يُستخدم لأكثر من نوع من الأخطاء المتعلقة بأنواع الرسائل غير المدعومة. إذا كنت غير متأكد من هذا الخطأ، يمكنك التواصل مع دعمنا.

لماذا أتلقى رسالة خطأ تفيد "Undefined: Receiver is incapable of receiving this message" عند محاولة إرسال رسائل؟

تصل رسالة الخطأ هذه من Meta. فيما يلي بعض الخطوات المقترحة من Meta لاستكشاف المشكلة وإصلاحها:

تأكد من أن جهة الاتصال التي تستلم الرسالة:

• لديها حساب WhatsApp نشط.

• تستخدم أحدث إصدار من WhatsApp.

• قبلت شروط الخدمة وسياسة الخصوصية الجديدة.

• ألا تكون محظورة على WhatsApp أو من بلد تُحظر فيه خدمة WhatsApp.

فقدت بيانات اعتماد حساب Meta Business Manager الخاص بي. ماذا عليّ أن أفعل؟

لاستعادة الوصول إلى حساب Meta Business Manager، يمكنك معرفة كيفية إعادة تعيين كلمة المرور واستعادة عنوان البريد الإلكتروني أو رقم الهاتف هنا.

لماذا تم تعطيل حساب WhatsApp Business الخاص بي؟

قد يتم تعطيل حساب WhatsApp Business API (WABA) لعدة أسباب. تشمل المشكلات الشائعة عدم الامتثال لسياسات التجارة لدى Meta وإدراج موقع إلكتروني غير صالح. لاستئناف هذا القرار، يجب عليك اتخاذ الخطوات التالية:

ضمان الامتثال لسياسات التجارة لدى Meta: راجع ومواءم ممارسات عملك مع إرشادات Meta. هذا أمر أساسي لنجاح الاستئناف.

تأكد من أن لديك موقعًا إلكترونيًا صالحًا: حدّث معلومات نشاطك التجاري في Meta Business Manager (MBM) لتتضمن موقعًا واضحًا وصالحًا يعرض طبيعة وتفاصيل نشاطك.

حضّر استئنافًا: في مربع الاستئناف، اشرح كيف يستخدم نشاطك WhatsApp للتواصل. أبرز ما يلي:

• يتم إرسال الرسائل فقط للعملاء الذين وافقوا على الاستلام.

• جميع الاتصالات ذات صلة بنشاطك التجاري وتتوافق مع سياسات WhatsApp.

تعرف على كيفية طلب مراجعة مع Meta هنا.

ماذا يجب أن أفعل للتحضير لاستئناف إذا تم تعطيل WABA؟

اتبع هذه الخطوات وراجع المعلومات الأساسية لضمان أن استئنافك مُعد بشكل جيد. إذا كنت تستأنف عبر فريق دعم العملاء لدينا، فتأكد من مشاركة لقطات الشاشة هذه معهم أيضًا.

1. راجع جودة حساب عملك: انتقل إلى نظرة عامة على الحساب -> انقر على عرض حساباتي

2. تحقق من تفاصيل النشاط التجاري: انتقل إلى Business portfolio info

3. استخرج معرف MBM، ومعرف WABA وتقييم جودة رقم الهاتف لتقديم استئناف:
- استخرج معرف MBM من معلومات نشاطك التجاري.

- اذهب إلى WhatsApp accounts واستخرج معرف WABA الخاص بك. اختر حساب WhatsApp الصحيح وانقر لنسخ معرف WABA.

- مرّر لأسفل وانتقل إلى WhatsApp Manager لعرض تقييم جودة رقم هاتفك.

لماذا تلقيت هذا الخطأ "Business eligibility payment issue" عند إرسال رسالة؟

قد يحدث هذا الخطأ عندما تقوم مؤخرًا بحذف قناة وحاولت إرسال قالب رسالة WhatsApp أو بدء محادثة جديدة باستخدام رقم WhatsApp Business مختلف. يعود ذلك إلى تحرير خط الائتمان من رقم هاتف القناة المحذوفة وإعادة توزيعه على أرقام هاتفك المتبقية. قد تستغرق هذه العملية حتى 5 دقائق. نوصي بالانتظار لمدة 5 دقائق قبل إعادة إرسال الرسالة.

سيحدث هذا الخطأ فقط إذا كان لديك أكثر من رقم تحت نفس Business Manager وكانت تلك الأرقام متصلة بالمنصة.

هل يمكن لرقم WhatsApp API المتصل بحساب WhatsApp Business (WABA) المسجل في Business Suite أن يتصل مباشرةً بـ respond.io؟

لا، لا يمكن لرقم WhatsApp API المتصل بحساب WhatsApp Business (WABA) المسجل في Business Suite أن يتصل مباشرةً بـ respond.io.

لماذا لا تظهر صورة ملف جهة الاتصال الخاصة بي؟

بسبب قيود قناة WhatsApp، لا يمكننا عرض صورة ملف جهة الاتصال الخاصة بك. لا توفر WhatsApp واجهة برمجة تطبيقات (API) تتيح لنا جلب هذه المعلومات.

ماذا يحدث عندما أحذف قناة WhatsApp الخاصة بي؟

حذف قناة WhatsApp لن يزيل جهات الاتصال المرتبطة أو سجل الدردشة.

سجل الدردشة مرتبط بجهات الاتصال الخاصة بك؛ ما لم تقم بحذف جهة اتصال يدويًا من وحدة جهات الاتصال، ستبقى جهة الاتصال وسجل محادثاتها في مساحه عمل.

عند إعادة توصيل نفس قناة WhatsApp واستلام رسالة من نفس الرقم، سيتم دمج جهة الاتصال مع الموجودة.

لماذا أرى "Meta Error (#131057): Account in maintenance mode" على WhatsApp؟

يحدث هذا عندما يكون حساب WhatsApp Business الخاص بك في وضع الصيانة مؤقتًا، عادةً أثناء ترقية السعة. تستغرق حوالي دقيقة، وسيعود عمل رقمك تلقائيًا بمجرد اكتمال الترقية.

لماذا أرى "Media Upload Error" أو "Media Download Error" عند إرسال قالب؟

تحدث هذه الأخطاء عندما لا يلبي ملف الوسائط المرفق بقالبك متطلبات Meta. الأسباب الشائعة تشمل:

• تنسيق الملف غير مدعوم.

• نوع الملف غير صحيح.

• تتجاوز الوسائط حدود الحجم التي تحددها Meta.

تنشأ هذه المشكلات من جهة Meta وهي خارج سيطرة respond.io. يمكنك أيضًا الرجوع إلى توثيق رموز الأخطاء لدى Meta لمزيد من التفاصيل حول استجابات الأخطاء المحددة.

لماذا لا يمكن لجهة الاتصال الخاصة بي رؤية الرسالة التي أجيب عليها على WhatsApp؟

يحدث ذلك لأن رسائل WhatsApp الأقدم من 30 يومًا تُنقل إلى التخزين طويل الأمد بواسطة Meta، ولم يعد سياق الرسالة المردود متاحًا. نتيجة لذلك، لا تظهر فقاعة "الرد على" على الرسائل المرسلة كردود على تلك الرسائل القديمة.

هل تدعم منصة WhatsApp Business (API) الدردشات الجماعية؟

لا، لا تدعم إدارة أو إرسال رسائل إلى الدردشات الجماعية. قامت Meta بإيقاف تطوير هذه الميزة.