تم تحديث هذا المستند.
لم تكتمل الترجمة إلى اللغة ‏العربية‏ حتى الآن.
تاريخ تحديث المصدر باللغة الإنجليزية: ‏٢٥ أبريل

الدعم

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

لم يتم تسليم الرسالة

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

  • لم يتصل العميل بالإنترنت خلال فترة الـ 30 يومًا التي نحتفظ فيها برسائل العملاء غير المتصلين بالإنترنت.
  • قام العميل بحظر رقم هاتف النشاط التجاري، أو رقم هاتف نشاط تجاري آخر مملوك للنشاط التجاري.
  • العميل متواجد في بلد مقيّد أو خاضع للعقوبات.

في بعض السيناريوهات الأخرى، ترجع API رمز خطأ مع رسالة خطأ تصف طبيعة الخطأ. مثال على السيناريوهات:

  • معلمات الطلب غير صالحة
  • أخطاء متعلقة بالنزاهة
  • لم يقبل العميل شروط الخدمة وسياسة الخصوصية الجديدة. يرجى إرسال هذا الرابط إلى المستخدم النهائي https://wa.me/tos/20210210 لقبول أحدث شروط الخدمة.
  • يستخدم العميل إصدارًا قديمًا من واتساب. يجب على العملاء استخدام الإصدار التالي أو إصدار أحدث:
    • Android: 2.21.15.15
    • SMBA: 2.21.15.15
    • iOS: 2.21.170.4
    • SMBI: 2.21.170.4
    • KaiOS: 2.2130.10
    • الويب: 2.2132.6
  • العميل جزء من مجموعة تجريبية.
  • لم يتم تسليم الرسالة لتوفير تجربة مستخدم عالية الجودة. راجع تقييدات رسائل قالب التسويق لكل مستخدم.

الحلول المحتملة

باستخدام وسيلة اتصال بخلاف واتساب، اطلب من مستخدم واتساب:

  • تأكيد أنه يمكنه بالفعل إرسال رسالة إلى رقم (أرقام) هاتف واتساب للأعمال لديك
  • تأكيد عدم وجود أي من أرقام واتساب للأعمال في قائمة الأرقام المحظورة (الإعدادات > الخصوصية > محظور أو جهات الاتصال المحظورة)
  • تأكيد قبول أحدث شروط الخدمة (الإعدادات > مساعدة، أو الإعدادات > معلومات التطبيق يجب قبول أحدث الشروط/السياسات إذا لم يحدث ذلك بالفعل)
  • التحديث إلى أحدث إصدار من عميل واتساب

تقييدات البلدان

الأنشطة التجارية في كوبا وإيران وكوريا الشمالية وسوريا وثلاث مناطق خاضعة للعقوبات في أوكرانيا (شبه جزيرة القرم ودونيتسك ولوهانسك) ليست مؤهلة لاستخدام منصة واتساب للأعمال.

مستخدمو تطبيق واتساب مسنجر (واتساب) وواتساب للأعمال في كوبا وإيران وكوريا الشمالية وسوريا وثلاث مناطق خاضعة للعقوبات في أوكرانيا (شبه جزيرة القرم ودونيتسك ولوهانسك) ليسوا مؤهلين لاستلام الرسائل المرسلة عبر منصة واتساب للأعمال.

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

Webhooks

حالة تلقي الرسائل المتضاربة

في حالات نادرة، قد تؤدي الرسالة نفسها إلى نجاح أحداث webhooks لتحديث حالة الرسالة وفشلها. على سبيل المثال، قد تؤدي الرسالة إلى بدء أحداث webhooks للرسالة بالحالة "status":"delivered" وبدء حدث webhook آخر بالحالة "status":"failed". يمكن أن يحدث هذا عندما يقوم العميل بتسجيل الدخول إلى واتساب على أجهزة متعددة ويتم تسليم الرسالة بنجاح إلى جهاز واحد من دون الآخر. أي رسالة تبدأ حدث webhook لحالة الرسالة بالحالة "delivered" يتم تسليمها إلى واحد على الأقل من أجهزة المستخدم.

رمز الخطأ 2 - خدمة API

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

كيفية تصحيح الأخطاء

نقترح عليك الانتظار لمدة 5 دقائق ومحاولة إجراء استدعاء API مرة أخرى.

أخطاء المصادقة والتصريح

يتم إرجاع هذه الأخطاء عند وجود مشكلة في رمز الوصول الذي تستخدمه لاستدعاء API.

كيفية تصحيح الأخطاء

يمكنك لصق رمز الوصول الذي تستخدمه مباشرةً في أداة تصحيح أخطاء رمز الوصول. بعد ذلك، يمكنك التحقق مما إذا كنت قد حددت الأذونات whatsapp_business_management وwhatsapp_business_messaging.

إذا لم يكن الرمز لديه صلاحية الوصول إلى الأذونات، فستحتاج إلى إنشاء رمز جديد. أثناء إنشاء الرمز، تأكد من تحديد:

  • تطبيق Meta الذي تستخدمه لإجراء استدعاءات API
  • الأذونات التالية: whatsapp_business_management وwhatsapp_business_messaging

الأسئلة المتكررة

الأسئلة المتكررة العامة

We expect Cloud API to provide the same key features as the On-Premises API soon, including user change notifications and sticker pack management. Our goal is for the Cloud API to become the preferred platform for new features.

We will release updates monthly with new features and improvements. There is no work required to access these features - the Cloud API updates automatically.

WhatsApp develops and operates the WhatsApp Business API, which enables businesses to communicate with WhatsApp consumer users on the WhatsApp network. When using the Cloud API, Meta will host the WhatsApp Business API for you and provide an endpoint for the WhatsApp service for your incoming and outgoing WhatsApp communications.

No, there is no difference in messaging prices between the Cloud API and the On-Premises API. Access to Cloud API is free, and we expect it to generate additional cost savings for developers. The two types of cost savings for the Cloud API are 1) set up cost (including server or external cloud provider cost), 2) ongoing cost of maintenance (including engineering time for API upgrades).

A Solution Partner can select which setup a given client should use. We recommend that the majority of clients use the Cloud API for ease of implementation and maintenance. Solution Partners can also continue to maintain integration with the On-Premises API.

We want to make it clear what it means to message with a business on WhatsApp. Some businesses may choose to use Meta or another company to help them manage and store their messages. When a business chooses to manage their messages with another company, we will let consumers know by showing a different system message. Learn more.

الأسئلة المتكررة حول التنفيذ التقني

The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.

Solution Partners and direct clients do not need the WebApp and CoreApp containers that are used in the On-Premises API. Meta will manage all database data and media data on behalf of the Solution Partner or direct client.

As your on-premises performance depends heavily on your hardware, software, and connectivity to WhatsApp servers, if you wish to understand these differences, you can perform your own load tests on Cloud API as you might have done for your own on-premises installation. You can also refer to our performance comparison to understand more details around how the on-premise and Cloud APIs compare.

Migrating between the on-premises and Cloud APIs is seamless, and can be done bidirectionally. See migration details for more information.

الأسئلة المتكررة حول الموثوقية

يتم تحديث التوّفر مرة واحدة يوميًا.

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

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

توجد حالات لا يتم فيها تتبع زمن التوقف تلقائيًا فيما يتعلق بالتوّفر:

  • مشكلات الشبكة التي تتسبب في فشل الطلبات قبل أن تصل إلى طبقة Graph API (الطبقة الأولى).
  • مشكلات الشبكة التي تتسبب في عدم وصول أحداث webhooks الصادرة إلى نقطة نهاية webhook للنشاط التجاري.

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

الحالات الأخرى التي تظهر في لوحة معلومات التوّفر لدينا بعد أن يتم اكتشافها يدويًا هي (ليس خطأ في النظام):

  • يتم تحديد مشكلات مصادقة Meta مثل رمز المصادقة (مكتبات رموز الأمان) إما كطلبات مشروعة قد فشلت في المصادقة أو الحصول على التصريح.
  • عملية التحقق التي ترفض الطلبات المشروعة.

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

لا نوفر حاليًا اتفاقيات متوفرة على مستوى خدمة المنتج لزمن العمل و/أو زمن الاستجابة.

We will have disaster recovery and data replication across multiple regions. The expected downtime would be within our SLA and usually in the order of less than a minute to less than five minutes.