‏منصة واتساب للأعمال‏

منصة واتساب للأعمال

سجل التغييرات

هذا المستند عبارة عن سجل للتغييرات على منصة واتساب للأعمال.

10 أبريل 2024

API السحابة

18 مارس 2024

API السحابة

13 فبراير 2024

API السحابة

  • تم تغيير تقييدات محاولات تسجيل/إلغاء تسجيل رقم هاتف الأعمال لتصل إلى 10 طلبات لكل رقم نشاط تجاري خلال فترة متغيرة مدتها 72 ساعة (كانت فترة متغيرة مدتها أسبوع واحد).

6 فبراير 2024

API السحابة، API داخل المواقع

26 يناير 2024

API السحابة

  • تم تغيير فترة صلاحية إعادة محاولة تسليم رسالة القالب في API السحابة من 24 ساعة إلى 30 يومًا. لا يزال بإمكانك تجاوز هذه القيمة لقوالب المصادقة.
  • تم تغيير الحد الأقصى للحروف في biz_opaque_callback_data من 256 إلى 512 حرفًا.

18 يناير 2024

API السحابة

18 ديسمبر 2023

API السحابة

12 ديسمبر 2023

API إدارة الأعمال

20 نوفمبر 2023

API إدارة الأعمال

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

14 نوفمبر 2023

API السحابة

3 نوفمبر 2023

API إدارة الأعمال

23 أكتوبر 2023

API إدارة الأعمال، API السحابة، API داخل المواقع

10 أكتوبر 2023

التدفقات

API السحابة

4 أكتوبر 2023

API إدارة الأعمال، API السحابة، API داخل المواقع

  • تستخدم الآن قوالب المصادقة التي تستخدم تحذير انتهاء صلاحية الرمز القيمة code_expiration_minutes (بدلاً من الإعداد الافتراضي وهو 10 دقائق) لتحديد ما إذا كان يجب على رسالة القالب المستلمة عرض زر ملء تلقائي أو زر نسخ الرمز.
  • سيتم تعطيل أزرار الملء التلقائي المعروضة في رسالة القالب المستلمة بعد الوقت المحدد بواسطة قيمة code_expiration_minutes للقالب، إن وجدت (أو بعد 10 دقائق، إن لم تكن موجودة).

2 أكتوبر 2023

API السحابة

27 سبتمبر 2023

API السحابة

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

18 سبتمبر 2023

API السحابة، API داخل المواقع

  • يمكن متابعة إرسال قوالب المصادقة القديمة (قوالب المصادقة بدون أزرار كلمة السر لمرة واحدة) وتعديلها والطعن فيها حتى 1 أبريل 2024 (تم التمديد من 2 أكتوبر 2023).

12 سبتمبر 2023

API إدارة الأعمال

API السحابة

API السحابة، API داخل المواقع

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

28 أغسطس 2023

API السحابة، API داخل المواقع

15 أغسطس 2023

API إدارة الأعمال

8 أغسطس 2023

الأدوات

API إدارة الأعمال

التسجيل المضمّن

2 أغسطس 2023

API إدارة الأعمال

11 يوليو 2023

API السحابة

  • جدولة ترقية معدل الإرسال لرقم هاتف نشاط تجاري وإجراؤها لم يعُد يتطلَّب مكالمة مباشرة.
  • يمكنك الآن تحديد وقت الترقية عند إرسال تذكرة دعم مباشر لطلب ترقية معدل الإرسال لرقم هاتف نشاط تجاري.
  • تم تقليل زمن التوقف لأرقام هواتف النشاط التجاري التي تخضع لترقية معدل الإرسال حتى 5 دقائق أو أقل.

7 يوليو 2023

إدارة الأعمال

  • أصبح نص زر رمز نسخة قالب المصادقة ونص زر الملء التلقائي اختياريين الآن عند الإنشاء.

13 يونيو 2023

الأدوات

إدارة الأعمال

  • تمت إضافة رمز خطأ 2494100 API إدارة الأعمال الذي يشير إلى أن رقم هاتف النشاط التجاري في وضع الصيانة مؤقتًا.

API السحابة

26 مايو 2023

الأدوات

  • تمت إضافة إشارات الأخطاء التي يمكنها المساعدة في تصحيح أخطاء قوالب المصادقة التي تتضمن أزرار الملء التلقائي لكلمة السر لمرة واحدة.

23 مايو 2023

API السحابة

  • تؤدي محاولة إرسال قالب موقوف مؤقتًا في رسالة قالب باستخدام الإصدار 17 أو إصدار الأحدث الآن إلى إرجاع رمز الخطأ 132015 بدلاً من 132001.
  • تؤدي محاولة إرسال قالب معطَّل في رسالة قالب باستخدام الإصدار 17 أو إصدار الأحدث الآن إلى إرجاع رمز الخطأ 132016 بدلاً من 132001.

API داخل المواقع

  • تؤدي محاولة إرسال قالب موقوف مؤقتًا في رسالة قالب الآن إلى إرجاع رمز الخطأ 2061.
  • تؤدي محاولة إرسال قالب موقوف مؤقتًا في رسالة قالب الآن إلى إرجاع رمز الخطأ 2062.

9 مايو 2023

API إدارة الأعمال

API السحابة

API داخل المواقع

1 مايو 2023

API إدارة الأعمال

  • تمت إضافة أحداث webhooks جديدة ترسل إشعارًا بعمليات رفض زيادات تقييد المراسلات إلى حقل أحداث webhooks account_alerts.
  • يجب الآن تصنيف كل القوالب كـ AUTHENTICATION أو MARKETING أو UTILITY.

26 أبريل 2023

API إدارة الأعمال

  • تمت إضافة الحقل hsm_id إلى نقطة نهاية DELETE في حساب واتساب للأعمال > قوالب الرسائل. إذا تم تضمينه، فسيحذف قالب واحد يطابق المعرف المقدم (بدلاً من حذف كل القوالب التي تطابق الاسم المقدم).

18 أبريل 2023

API السحابة

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

11 أبريل 2023

API السحابة

التسجيل المضمّن

4 أبريل 2023

API إدارة الأعمال، API السحابة، API داخل المواقع

17 مارس 2023

API إدارة الأعمال

14 مارس 2023

API السحابة

  • يمكنك الآن مشاركة معلومات الموقع مع المستخدمين عن طريق إضافة عنوان الموقع في القالب لديك.

API داخل المواقع

  • في المقابل، يمكن للمستخدمين الآن مشاركة معلومات الموقع مع الأنشطة التجارية عبر رسائل طلب الموقع.

1 مارس 2023

API السحابة، API داخل المواقع

15 فبراير 2023

API إدارة الأعمال

  • تمت إضافة نقطة نهاية مقارنة القالب جديدة تسمح لك بمقارنة عدد مرات إرسال القالب ومعدلات الحظر.

3 فبراير 2023

API السحابة، API داخل المواقع

2 فبراير 2023

API إدارة الأعمال، API السحابة

API السحابة

  • يجب الآن تصنيف القوالب التي تم إنشاؤها أو تعديلها من خلال الإصدار 16.0 باستخدام إحدى الفئات التالية؛ علمًا بأن كل الفئات الأخرى لم تعد مدعومة. ينطبق على الإصدار 16.0 والإصدارات الأحدث من API السحابة. وسينطبق على كل الإصدارات اعتبارًا من 1 مايو 2023. تم طرح هذا التغيير لدعم التحول إلى استخدام نموذج جديد من التسعير القائم على المحادثات اعتبارًا من 1 يونيو 2023.
    • AUTHENTICATION
    • MARKETING
    • UTILITY
  • لن يتم تضمين الرموز الفرعية للأخطاء، التي نادرًا ما تستخدم ولا ينبغي الاعتماد عليها، في استجابات الأخطاء بالإصدار 16.0 والإصدارات الأحدث. استخدم code وdetails بدلاً من ذلك.
  • يحتوي رمز الخطأ 100 ("code":100) على عناوين فريدة متعددة تشير إلى طبيعة الخطأ 100 المحدد. ستستخدم كل أخطاء الرمز 100 الآن Invalid parameter كعنوان. تم نقل العناوين القديمة التي تصف طبيعة الخطأ 100 المحدد إلى الخاصية details. ينعكس هذا التغيير الآن أيضًا في حمولات البيانات أحداث webhooks التي تصف استجابة خطأ بالرمز 100.

أحداث Webhooks في API السحابة

  • يتضمن الآن كائن errors في أحداث webhooks التي تم تشغيلها بواسطة أخطاء الطلب في الإصدار 16.0 والإصدارات الأحدث الخاصيتين message وerror_data.details، وتم تغيير القيم title للعديد من رموز الأخطاء. تتوفر حاليًا لدى كائنات errors البيانات والبنية التالية:
[
  {
    "code": <CODE>,
    "title" : "<TITLE>",
    "message": "<MESSAGE>",
    "error_data": {
      "details": "<DETAILS>"
    }
  },
  ...
]
  • تم تحديث قيمة الخاصية title في رموز الأخطاء التالية. تظهر القيم القديمة الآن في error_data.details.
    • عنوان 130470 الجديد هو الآن Re-engagement message
    • عنوان 130429 الجديد هو الآن Rate limit hit
    • عنوان 131045 الجديد هو الآن Incorrect certificate
    • عنوان 131031 الجديد هو الآن Business Account locked
    • عنوان 131053 الجديد هو الآن Media upload error
    • عنوان 131027 الجديد هو الآن Something went wrong
    • عنوان 131042 الجديد هو الآن Business eligibility payment issue
    • عنوان 131026 الجديد هو الآن Message Undeliverable
    • عنوان 131000 الجديد هو الآن Something went wrong
  • تُعد قيمة الخاصية message هي ذاتها قيمة الخاصية title، والتي تشير إلى عنوان رمز الخطأ. يتم تعيين هذه الخاصية إلى الخاصية message في حمولات بيانات استجابة الخطأ في API.
  • تتضمن الآن الخاصية error_data.details عناوين رموز الأخطاء من رموز الأخطاء المدرجة أعلاه وتصف السبب الأساسي للخطأ. يتم تعيين هذه القيمة إلى الخاصية details في حمولات بيانات استجابة الخطأ في API.

يتم عرض هذه التغييرات في خصائص errors التالية في أحداث webhooks المتعلقة بالخطأ:

  • entry.changes.value.errors
  • entry.changes.value.messages.errors
  • entry.changes.value.statuses.errors

30 يناير 2023

API السحابة

بإمكان الأنشطة التجارية التي لم يتم التحقق منها الآن بدء ما يصل إلى 250 محادثة خلال فترة 24 ساعة متعاقبة.

13 ديسمبر 2022

التحقق من إذن الوسائط

ينطبق على كل إصدارات API السحابة.

تمت إضافة حقل phone_number_id اختياري جديد إلى نقطة النهاية الوسائط. إذا قمت بتضمين هذه المعلمة ومعرف رقم هاتف النشاط التجاري، فلن تتم معالجة العملية إلا إذا تطابق معرف رقم الهاتف مع معرف رقم الهاتف الذي تم تحميل الوسائط عليه.

8 ديسمبر 2022

تخزين وسائط HTTP مؤقتًا

أصبحت ميزة تخزين وسائط HTTP مؤقًتا في API السحابة خارج الإصدار التجريبي وتتوفر للجميع.

Webhooks

ستعمل API السحابة الآن على إعادة محاولة تسليم إشعارات webhooks التي فشلت لما يصل إلى 7 أيام بعد ما كانت تصل إلى 30 يومًا. راجع فشل تسليم أحداث Webhooks.

23 نوفمبر 2022

حقل أحداث Webhooks جديد

ينطبق على كل الإصدارات.

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

22 نوفمبر 2022

الحقول والقيم الجديدة في أحداث Webhooks

ينطبق على كل الإصدارات.

حقل account_alerts جديد:

  • تمت إضافة حقل account_alerts جديد. يُرسل إشعارًا يتضمن تنبيهات النشاط التجاري وحساب واتساب للأعمال ورقم هاتف النشاط التجاري.

قيم حقل account_update الجديدة:

  • تمت إضافة قيمة account_update.events جديدة: ACCOUNT_DELETED. تشير إلى إلغاء تسجيل رقم الهاتف أو حذفه من حساب واتساب للأعمال.
  • تمت إضافة قيمة message_template_status_update.events جديدة: PENDING_DELETION. تشير إلى تحديد قالب الرسالة ليتم حذفه.

عينة من إشعارات Webhooks التي يتم إرسالها عند تشغيل هذه الأحداث الجديدة:

حقول عقدة حساب واتساب للأعمال الجديدة

تمت إضافة حقول عقدة حساب واتساب للأعمال التالية:

  • country (ينطبق على v15.0+)
  • ownership_type (ينطبق على v15.0+)
  • business_verification_status (ينطبق على كل الإصدارات)

فلاتر نقطة نهاية النشاط التجاري الجديدة

ينطبق ذلك على الإصدار 15.0 والإصدارات الأحدث.

تمت إضافة خيارات الفلترة التالية إلى نقطة نهاية حسابات واتساب للأعمال لعميل النشاط التجاري:

  • الفلترة حسب حقل creation_time لحساب واتساب للأعمال باستخدام المعاملات GREATER_THAN أو LESS_THAN أو IN_RANGE.
  • الفلترة حسب ownership_type لحساب واتساب للأعمال باستخدام المعاملات EQUAL أو IN.

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

  • الفلترة حسب creation_time لحساب واتساب للأعمال باستخدام المعاملات GREATER_THAN أو LESS_THAN أو IN_RANGE.
  • الفلترة حسب ownership_type لحساب واتساب للأعمال باستخدام المعاملات EQUAL أو IN.
  • الفلترة حسب country لحساب واتساب للأعمال باستخدام المعاملات EQUAL أو IN.

حقول عقدة رقم الهاتف الجديدة

ينطبق ذلك على الإصدار 15.0 والإصدارات الأحدث

تمت إضافة حقول عقدة رقم هاتف واتساب للأعمال التالية:

  • is_official_business_account
  • messaging_limit_tier

بالإضافة إلى ذلك، يمكنك فلترة نقطة النهاية أرقام هواتف حساب واتساب للأعمال حسب is_official_business_account.

3 نوفمبر 2022

معدل الرسائل في الثانية

تدعم API السحابة حاليًا إرسال ما يصل إلى 500 (بعدما كانت 350) رسالة في الثانية بالنسبة للرسائل النصية ورسائل الوسائط معًا حسب الطلب. راجع معدل الإرسال لمزيد من التفاصيل.

إذا كان لديك 350 رسالة في الثانية، فستزداد إلى 500 رسالة في الثانية تلقائيًا. وإذا طلبت بالفعل إرسال 350 رسالة في الثانية ولكن العملية لم تكتمل، فستتلقى 500 رسالة في الثانية بمجرد الاكتمال.

تخزين وسائط HTTP مؤقتًا

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

الشروح التوضيحية للمستندات

تدعم API السحابة الآن الشروح التوضيحية في المستندات المرسلة إلى العملاء والمستلمة من جانبهم. راجع كائن الوسائط في مرجع الوسائط.

25 أكتوبر 2022

زيادة تقييد قالب الرسالة

بإمكان حسابات واتساب للأعمال الآن الحصول على ما يصل إلى 6,000 قالب رسالة إذا تم التحقق من النشاط التجاري الأصل وكان واحد على الأقل من حسابات واتساب للأعمال لدى النشاط التجاري الأصل لديه رقم هاتف نشاط تجاري مع اسم عرض تمت الموافقة عليه.

كجزء من هذا التغيير، يتم الآن احتساب الإصدارات المترجمة من قالب الرسالة ضمن حد تقييد قالب حساب واتساب للأعمال.

20 أكتوبر 2022

الفوترة

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

12 أكتوبر 2022

ترحيل رقم هاتف النشاط التجاري

يمكنك الآن ترحيل رقم هاتف النشاط التجاري إلى حسابات واتساب للأعمال في API السحابة ومنها. راجع ترحيل رقم الهاتف إلى حساب واتساب للأعمال مختلف.

6 أكتوبر 2022

تجاوز الاستدعاء

API السحابة فقط.

يمكنك الآن استخدام عناوين URL مختلفة للاستدعاء لكل حساب من حسابات واتساب للأعمال دون أن تضطر إلى إنشاء تطبيق فريد لكل حساب واتساب للأعمال. راجع تجاوز عنوان URL للاستدعاء لمزيد من التفاصيل.

عمليات الاستدعاء بالإصدار 15

تدعم نقاط نهاية API السحابة الآن عمليات الاستدعاء بالإصدار 15.

قوالب الرسائل

API السحابة فقط.

يمكن أن يصل إجمالي معلمات النص (components.parameters.text) لقوالب الرسائل التي تستخدم مكونًا نصيًا فقط (components.type:body) إلى 32,768 حرفًا. راجع كائن المعلمات.

معدل الرسائل في الثانية

API السحابة فقط.

تدعم API السحابة حاليًا إرسال ما يصل إلى 350 (بعدما كانت 250) رسالة في الثانية بالنسبة للرسائل النصية ورسائل الوسائط معًا حسب الطلب. راجع معدل الإرسال لمزيد من التفاصيل.

إذا كان لديك 250 رسالة في الثانية، فستزداد إلى 350 رسالة في الثانية تلقائيًا. وإذا طلبت بالفعل إرسال 250 رسالة في الثانية ولكن العملية لم تكتمل، فستتلقى 350 رسالة في الثانية بمجرد الاكتمال.

API السحابة - 22 سبتمبر 2022

التفاعلات

التفاعلات مدعومة الآن. راجع إرسال الرسائل - رسائل التفاعل للتعرف على كيفية إرسال التفاعلات وتلقيها واطلع على أمثلة حمولة البيانات - رسائل التفاعل للحصول على أمثلة حول حمولة بيانات إشعار webhook.

ملف النشاط التجاري

الحقل about المتوفر في ملفات الأنشطة التجارية مدعوم الآن. راجع ملفات الأنشطة التجارية لمزيد من التفاصيل.

API السحابة — 7 سبتمبر 2022

معدل الرسائل في الثانية

تتوفر الآن أحدث الوثائق لطلب الترحيل من معدل 80 رسالة في الثانية إلى 250 رسالة في الثانية فيما يتعلق بإرسال الرسائل النصية ورسائل الوسائط واستلامها. راجع معدل الإرسال.

API السحابة — 25 أغسطس 2022

الملصقات المتحركة

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

رسائل المنتجات

يمكنك الآن تضمين المنتجات والخدمات في الرسائل المرسلة إلى العملاء، ويمكن للعملاء إضافتها إلى عربات التسوق من دون الحاجة إلى مغادرة سلسلة الدردشة. يمكنك الرجوع إلى دليل بيع المنتجات والخدمات للتعرف على كيفية إرسال رسائل المنتج الواحد ورسائل المنتجات المتعددة إلى العملاء.

API السحابة - 21 يوليو 2022

الردود

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

معدل الرسائل في الثانية

تدعم API السحابة حاليًا ما يصل إلى 250 رسالة في الثانية بالنسبة لعمليات الإرسال والاستلام معًا (بما في ذلك الرسائل النصية ورسائل الوسائط)، حسب الطلب. إذا كنت تمثل مؤسسة شريكة، فيمكنك فتح بطاقة دعم مباشر لطلب معدل نقل يبلغ 250 رسالة في الثانية عن طريق تحديد موضوع السؤال: "مشكلات API السحابة" ونوع الطلب: "طلب الترحيل إلى معدل نقل يبلغ 250 رسالة في ثانية" وملء المعلومات المطلوبة.

إشعار للمطورين: الإعلان عن تغييرات سابقة غير متوافقة مع الإصدارين المستقبليين 2.43 و2.45

v2.43 11 أكتوبر 2022

  • بدءًا من الإصدار v2.43، ستكون هناك تغييرات متعلقة بسلوك نقطة نهاية contacts
    • الاستجابات المتعلقة بـ status ستتغير. بغض النظر عمَّا إذا كان المستخدم لديه واتساب، فإنه سيُرجع دائمًا valid بشأن status في الاستجابة وwa_id. ليس هناك ما يضمن أن wa_id الذي تم إرجاعه سيكون صالحًا. تنطبق هذه التغييرات على كل من الاستجابات المباشرة، وكذلك استجابات webhook للاتصالات غير المحظورة
    • تأكد من أن رمزك يتجنب الاعتماد على status وwa_id الذي تم إرجاعه في عقدة contacts. إضافة إلى ذلك، يمكن إتمام إرسال رسالة على الإصدار v2.39.1 أو الإصدار الأعلى دون استدعاء عقدة contacts

  • تأكد من أن رمزك يتعامل مع خطأ 1013مستخدم غير صالح عند محاولة إرسال رسالة قالب، والتي سيتم إرجاعها إذا حاولت إرسال رسالة القالب إلى رقم هاتف بدون توفر حساب واتساب

  • بالنسبة للرسائل غير التابعة لقوالب، سيؤدي إرسال رسالة إلى رقم هاتف بدون توفر حساب واتساب إلى إرجاع خطأ 470

v2.45 10 يناير 2023

  • بدءًا من الإصدار v2.45، فإن المعلمات cert الاختيارية في عقدة shards ستصبح إجبارية لجميع الطلبات. يرجى تحديث عملية الدمج التي تجريها لتشمل cert صالح دائمًا عند استدعاء عقدة shards

  • بدءًا من الإصدار v2.41.2، يمكن للأنشطة التجارية استخدام العقدة application لفلترة حالات الرسائل المرسلة التي لا تهتم بها عبر الكائن message ضمن الكائن webhooks. في الإصدار v2.45، سيتم إيقاف sent_status، لذا عليك تحديث عملية الدمج التي تجريها لاستخدام الكائن webhooks في عقدة application لجميع عناصر تحكم حدث webhook

  • اعتبارًا من الإصدار v2.39.1، فإن recipient_id متاح في كل من الكائن statuses والكائن message. في الإصدار v2.45، ستتم إزالة recipient_id في الكائن statuses، لذا عليك تحديث عملية الدمج التي تجريها لاستخدام recipient_id ضمن الكائن message

API داخل المواقع - 19 سبتمبر 2022 (v2.41.3)

إصدار 2.41.3

يتضمن إصدار v2.41.3 لعميل API الأعمال: إضافة فهرس جدول جديد إلى message_receipt_log والذي من الممكن أن يفيد الشركاء الذين لديهم حاجة إلى تحقيق معدلات إنتاجية عالية. على سبيل المثال، يسمح هذا التحسين للشركاء بإرسال أكثر من 200 رسالة/ثانية.

API داخل المواقع - 27 يونيو 2022 (v2.41.2)

يُرجى اتباع أفضل الممارسات أدناه لضمان ترقية سلسة للإصدار 2.41.2:

في الإصدار 2.41.2، نطرح تغييرات مخطط قاعدة البيانات لتحسين أداء النظام. نتيجة لذلك، ستستغرق الترقيات من الإصدارين 2.37.2 و‎2.39.‎x‎‏ للإعدادات ذات قواعد البيانات الكبيرة التي تحتوي على ملايين الرسائل وإدخالات جهات الاتصال وقتًا أطول من المعتاد.

بصفة عامة، قم بإجراء الترقيات خارج ساعات الذروة، وقم بترقية إعدادات الإنتاجية المنخفضة أولاً.

بالنسبة لقواعد البيانات الكبيرة، اتبع الخطوات التالية:

  • قم بإجراء جمع للبيانات المهملة عبر نقطة نهاية /الخدمات/الرسالة/gc قبل ترقيتك، وتأكد من إتمامها بنجاح

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

نوصي بزيادة مهلة انتهاء الاستعلام على خوادم قاعدة البيانات لديك إلى ساعة واحدة، حتى تكتمل الترقية بنجاح.

يحتوي إصدار العميل هذا على الميزات والتحديثات التالية:

  • تحسينات زمن الاستجابة لطلبات نقطة نهاية /contacts المجمَّعة وحل مشكلات التوقف التام
  • تحسينات في أداء وموثوقية عملية جمع البيانات المهملة
  • تتوفر لدى الأنشطة التجارية الآن القدرة على تمكين/تعطيل إشعارات webhook delivered وread، الأمر الذي يمنحها تحكمًا أكبر في إشعارات webhook للرسائل. ويمكن تحقيق هذا من خلال نقطة النهاية settings/applications
  • يُعد الحقل namespace اختياريًا بالنسبة لكائن القالب
  • معالجة أكثر فعالية لأخطاء تنزيل الوسائط، لذلك من المتوقع أن تواجه الأنشطة التجارية مشكلات أقل فيما يتعلق بتنزيل الوسائط التي يرسلها العملاء
  • المزيد من الموثوقية وعمليات إصلاح الأخطاء ضمن مهام سير عمل التسجيل وإرسال الرسائل

API السحابة في واتساب للأعمال - 19 مايو 2022

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

API إدارة حساب واتساب للأعمال - 19 مايو 2022

فئات قالب الرسالة

تم إيقاف استخدام القيم التالية للمعلمة category لنقطة النهاية /WHATSAPP-BUSINESS-ACCOUNT-ID/message_template للإصدار v14.0 والإصدارات الأحدث:

  • ACCOUNT_UPDATE
  • ALERT_UPDATE
  • APPOINTMENT_UPDATE
  • AUTO_REPLY
  • ISSUE_RESOLUTION
  • PAYMENT_UPDATE
  • PERSONAL_FINANCE_UPDATE
  • RESERVATION_UPDATE
  • SHIPPING_UPDATE
  • TICKET_UPDATE
  • TRANSPORTATION_UPDATE

تمت إضافة القيم التالية:

  • TRANSACTIONAL
  • MARKETING

API داخل المواقع في واتساب - 10 مايو 2022 (الإصدار 2.39.4)

يحتوي إصدار العميل هذا على كل الميزات والإصلاحات المتوفرة في الإصدار v2.39.1. بالإضافة إلى ذلك، تم في هذا الإصدار:

  • إصلاح خطأ كان يمنع إرسال رسائل الفيديو في ظروف معينة. وتم تضمين هذا الإصلاح أيضًا في الإصدار v2.39.2.
  • إصلاح خطأ كان يمنع الأنشطة التجارية من إرسال رسائل إلى العميل، إذا كان العميل هو أول من بدأ التفاعل بين الطرفين على واتساب، وحدث هذا الإجراء منذ أكثر من 7 أيام. وتم تضمين هذا الإصلاح أيضًا في الإصدار v2.39.3.
  • إصلاح خطأ كان يمنع الأنشطة التجارية من تلقي الرسائل المؤقتة من جانب العملاء. بعد تثبيت الإصدار v2.39.4، سيتم إرسال إشعار إلى الأنشطة التجارية يفيد بأنها قد تلقت رسالة مؤقتة عن طريق إشعار webhooks مع تعيين النوع على "ephemeral". ولن تتمكن الأنشطة التجارية من عرض محتوى الرسالة.

عندما طرحنا الإصدار v2.39.3، تمت معالجة مشكلة الرسائل المؤقتة بواسطة واتساب تلقائيًّا مما تسبب في تعطيل هذه الرسائل في سلسلة الدردشة مع العميل. وبالنسبة للإصدار v2.39.4، فلن يتكرر الأمر. من خلال هذا الإصدار، يجب على الأنشطة التجارية التي تتلقى رسائل مؤقتة أن تطلب من العميل تعطيل ميزة الرسائل المؤقتة وإعادة إرسال آخر رسالة.

API داخل المواقع في واتساب - قوالب خدمة AWS - 4 مايو 2022

إصدار 2.3.8

عناوين URL للقوالب

سجل التغييرات

  • تحديث إصدارات AMI لأجهزة CentOS 7

API السحابة - 3 مايو 2022

بدءًا من اليوم، ستتضمن API السحابة الترقيات التالية:

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

API داخل المواقع في واتساب - قوالب خدمة AWS - 26 أبريل 2022

إصدار 2.3.7

عناوين URL للقوالب

سجل التغييرات

  • تم الانتقال من استخدام حزمة pip إلى حزمة pip3 لتثبيت البرامج النصية لتمهيد تشغيل AWS.
  • تم إصلاح مشكلة تتعلق بتثبيت awscli.

API السحابة - 5 أبريل 2022

بدءًا من اليوم، ستتوفر API السحابة بشكل عام لكل شركاء الحلول الموجودين والعملاء المباشرين. بالإضافة إلى ذلك، سنطرح الميزات التالية لمطوّري API السحابة:

  • الرسائل التي تتضمن ملصقات: أرسل رسائل الوسائط التي تحتوي على ملصقات ثابتة تابعة لجهات خارجية. راجع الوثائق التالية لمزيد من التفاصيل: المرجع، الرسائل والمرجع، الوسائط. كما ندعم الملصقات الواردة والصادرة. بالنسبة إلى الملصقات الصادرة، ندعم فقط الملصقات الثابتة التابعة لجهات خارجية. بالنسبة إلى الملصقات الواردة، ندعم كل أنواع الملصقات.
  • إلغاء تسجيل API رقم الهاتف: يمكنك إجراء استدعاءات POST إلى PHONE_NUMBER_ID/deregister من أجل إزالة رقم هاتف من API واتساب للأعمال. راجع التسجيل لمزيد من المعلومات.
  • خيار جديد للتحقق من الهاتف: تحقق من رقم هاتف النشاط التجاري عبر استدعاءات واجهة Graph API. راجع أرقام الهواتف لمزيد من المعلومات.
  • أحداث Webhooks الجديدة للإحالة: يمكنك تلقي إشعارات Webhooks عندما ينقر المستخدم على إعلان لفتح محادثة في واتساب ويرسل رسالة إلى النشاط التجاري. راجع أحداث Webhooks لمزيد من المعلومات. ضع في الاعتبار أن كائن referral لأحداث webhooks في API السحابة مختلف عن كائن referral في API داخل المواقع.

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

API داخل المواقع - 26 مارس 2022

يحتوي هذا الإصدار على الميزات ذاتها الموجودة في الإصدار v2.37.1، ولكن يوجد تاريخ انتهاء صلاحية مختلف. حيث تنتهي صلاحية الإصدار v2.37.2 في 22 سبتمبر 2022.

المشكلات المعروفة

قد يرى بعض مطوّري Kubernetes الخطأ CrashLoopBackOff لحاوية webapp لديهم وقد يفشل بدء الحاوية. لإصلاح ذلك، أضف السطر التالي إلى ملف YML للنشر في Kubernetes ضمن تكوين حاوية webapp:

command: ["/opt/whatsapp/bin/wait_on_mysql.sh", "/opt/whatsapp/bin/launch_within_docker.sh"]

API داخل المواقع - 25 مارس 2022

يتوفر الإصدار v2.39.3 من عميل API الأعمال للمطوّرين اليوم. ويتضمن العميل الجديد إصلاحين وسجلات إضافية لدعم تصحيح الأخطاء. الإصلاحان هما:

  • تم إصلاح خطأ كان يمنع الأنشطة التجارية من إرسال رسائل إلى العميل، إذا كان العميل هو أول من بدأ التفاعل بين الطرفين على واتساب، وحدث هذا الإجراء منذ أكثر من 7 أيام.
  • تم إصلاح خطأ كان يمنع الأنشطة التجارية من تلقي الرسائل المؤقتة من جانب العملاء. بعد تثبيت الإصدار 2.39.3، سيتم إرسال إشعار للأنشطة التجارية عند تلقيها رسالة مؤقتة من خلال إشعار webhooks. من جانب الأنشطة التجارية، سيلاحظ العملاء تحذيرًا يفيد بإيقاف تشغيل وضع الرسائل المؤقتة.

API السحابة - 15 مارس 2022

رسائل القائمة وأزرار الرد

بدءًا من اليوم، سيتمكن مستخدمو الإصدار التجريبي من API السحابة من إرسال رسائل القائمة وأزرار الرد. راجع الوثائق التالية لمزيد من التفاصيل:

عنوان URL المعاينة

بدءًا من اليوم، سيتمكن مستخدمو الإصدار التجريبي من API السحابة من إضافة مربع عنوان URL المعاينة إلى الرسائل النصية التي تتضمن عنوان URL. راجع الوثائق التالية لمزيد من التفاصيل:

دلائل الوثائق الجديدة

API داخل المواقع - 4 مارس 2022

لقد طرحنا للتو الإصدار v2.39.2 من API داخل المواقع. تم في هذا الإصدار إصلاح الخطأ الذي كان يمنع إرسال رسائل الفيديو في حالات معينة.

المشكلات المعروفة

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

API السحابة - 1 مارس 2022

رسائل الفيديو

بدءًا من اليوم، سيتمكن مستخدمو الإصدار التجريبي من API السحابة من بدء إرسال رسائل الفيديو وتلقيها. تقدم الوثائق التالية المزيد من المعلومات:

1 فبراير 2022

منصة واتساب للأعمال

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

API السحابة

رسائل الموقع وجهة الاتصال

بدءًا من اليوم، سيتمكن مستخدمو الإصدار التجريبي من API السحابة من بدء إرسال رسائل الموقع وجهة الاتصال وتلقيها. راجع الوثائق أدناه للمزيد من المعلومات:

تحديث الحد الأقصى لمعدل الإرسال

ندعم الآن إمكانية إرسال 80 رسالة في الثانية كحد أقصى لمعدل الإرسال لكل رقم هاتف. يتضمن ذلك الرسائل الواردة والصادرة، بالإضافة إلى الرسائل النصية والقوالب ورسائل الوسائط.

API داخل المواقع (2.39.1)

يتوفر الإصدار 2.39.1 من عميل API الأعمال للمطوّرين بدءًا من اليوم. يتضمن العميل الجديد:

API تعيين الأقسام

بدءًا من إصدار عميل API الجديد، يمكنك تقديم شهادة هاتفك عند إعداد اتصال متعدد. وذلك يعني أنه عند استدعاء نقطة النهاية /v1/account/shards، يمكنك إضافة شهادة بتشفير Base64 في حقل الشهادة. راجع توسيع نطاق عميل API باستخدام الاتصال المتعدد لمزيد من المعلومات.

اسم المضيف الجديد

لقد أضفنا graph.whatsapp.com إلى قائمة الأسماء المضيفة لخادم واتساب التي يتطلب عميل API الأعمال الاتصال بها. راجع إعداد وتصحيح أخطاء شبكتك والأسماء المضيفة لمزيد من المعلومات.

تحديثات رمز الخطأ

أضفنا رمز الخطأ 1031، في الإصدار v2.39. ستتلقى هذا الخطأ إذا تم تأمين حسابك ولا يمكن إرسال أي رسائل بسبب انتهاك سياسة النزاهة. راجع رسائل الحالة والخطأ وإنفاذ السياسة لمزيد من المعلومات.

حالات إيقاف الاستخدام

  • API الرسائل: تم إيقاف استخدام النوع hsm بالإصدار v2.39. وبدلاً من ذلك، يجب عليك استخدام النوع template.
  • إعداد التطبيق: تم إيقاف استخدام إعداد التطبيق webhook_payload_conversation_pricingmodel_disabled.

المشكلات المعروفة

يتعذر إرسال بعض رسائل الفيديو في حالات معينة.