كائن التسعير في webhook حالة WhatsApp: type وcategory وbillable (2026)
يُرفق كائن التسعير بخطاف الويب (webhook) الخاص بحالات الرسائل، ويوضح كيف صنّفت Meta الرسالة: billable (وهي قيد الإيقاف)، وpricing_model بقيمة PMP، وtype (regular أو free_customer_service أو free_entry_point أو free_group_customer_service)، وcategory مثل marketing أو utility أو authentication أو service، وsubtype اختيارياً بقيمة paid_exempt. ومنذ 1 أكتوبر 2026، تُعلَّم القيمة regular كل رسالة مُحتسبة، بما فيها رسائل الخدمة.
يربط easyCoexistence رقم تطبيق WhatsApp Business بواجهة Cloud API الخاصة بـ Meta عبر Coexistence، ويمرّر webhooks الحالة التي تحمل هذا الكائن إلى خادمك، ليتمكن نظامك من حساب الاستخدام.
pricing_model في webhooks الحالية هو التسعير لكل رسالة، ولا تظهر CBP إلا في webhooks أُرسلت قبل 1 يوليو 2025.
رسائل الخدمة المُسلَّمة شهرياً لكل رقم هاتف تجاري ضمن الطبقة المجانية لدى Meta، ابتداءً من 1 أكتوبر 2026.
type الخاص بالرسالة المُحتسبة، بما فيها رسائل الخدمة المُسلَّمة بعد استهلاك الطبقة المجانية للرقم.
subtype في رسائل الخدمة المجانية لأن الجهة مؤهلة كمنظمة حكومية أو غير ربحية.
تفاصيل الطبقات في webhooks؛ وتُشير Meta إلى الحقل pricing_analytics للحصول على معلومات طبقات الحجم.
أين يظهر كائن التسعير؟
فقط في الحالات، وفي بعضها دون غيرها: تُدرجه Meta مع حالة sent ومع إحدى حالتي delivered أو read، وهناك مثال بالإصدار v24.0 في مرجع Meta يُظهر غيابه عن sent لأنه ورد مع webhook الخاص بـ delivered. لا تحمل الحالات failed هذا الكائن أبداً. لذا تعامل مع التسعير بوصفه خاصية للرسالة، فسجّله بمعرّفها wamid مرة واحدة، أياً كانت الحالة التي جاء معها. وفيما يلي أمثلة Meta الرسمية للكائن لرسالة خدمة، قبل نفاد الطبقة المجانية الشهرية للرقم وبعدها:
// Service message delivered while the number is within its free tier
"pricing": {
"billable": false,
"pricing_model": "PMP",
"type": "free_customer_service",
"category": "service"
}
// Service message delivered after the number's free tier has been used
"pricing": {
"billable": true,
"pricing_model": "PMP",
"type": "regular",
"category": "service"
}ماذا تعني قيم type منذ 1 أكتوبر 2026؟
type هو الحقل الذي يحدد ما إذا كانت Meta تفرض رسوماً. وقد تغيّر معناه في 1 أكتوبر 2026، حين بدأت Meta تحتسب كل رسالة على حدة لرسائل الخدمة ولقوالب utility المُرسلة رداً على عميل. فالشيفرة المكتوبة قبل ذلك التاريخ قد تقرأ free_customer_service بوصفه رداً ضمن نافذة مفتوحة؛ أما الآن فيعني رسالة خدمة فردية ضمن الطبقة المجانية الشهرية للرقم. ما زال billable يظهر، لكن Meta تقول إنه سيُوقف، وتطلب قراءة type وcategory معاً.
| Through 30 Sep 2026 | From 1 Oct 2026 | |
|---|---|---|
| regular | A billable message | Billable, now including utility replies to customers and service messages past the number's monthly tier |
| free_customer_service | A utility template or non-template message sent in an open window | A one-to-one service message within the number's monthly tier |
| free_group_customer_service | Group utility or non-template message in an open group window | A group service message within the number's monthly tier |
| free_entry_point | Sent in an open free entry point window | Unchanged |
ما الفئات التي يمكن أن تحملها الرسالة؟
تُسمّي category التعرفة التي طبّقتها Meta عند الاحتساب، وهو الحقل الذي تجمّع عليه عند مطابقة الفواتير مع فاتورة Meta، مع بلد رقم العميل، لأن التعرفات تختلف من سوق إلى آخر. لكل رسالة فئة واحدة ورسوم واحدة فقط: فالرسالة غير القالبية التي تحتوي على محتوى ترويجي تبقى رسالة خدمة، ولا تُحتسب كرسالة تسويق إضافية. وهذه هي القيم التي تذكرها Meta:
كيف تحسب الرسوم من webhooks؟
تخبرك webhooks بالرسائل القابلة للفوترة وفئتها، لكنها لا تخبرك بتكلفتها. لبناء عرض للاستخدام يطابق فوترة Meta، عدّ حسب الرسالة وحسب الفئة، ثم طبّق تعرفات Meta المنشورة لكل سوق، أو اقرأ حقل pricing_analytics الخاص بـ Meta، الذي يعطي تفصيلاً لكل رسالة والطبقات.
- أزِل التكرار بالاعتماد على wamid، لأن التسعير قد يرد مع أكثر من حالة، وتكرّر إعادة المحاولة webhooks نفسها.
- احتسب الرسالة كمُحتسبة عندما تكون type هي regular؛ ثم جمّع حسب category وبلد المستلم.
- تجاهل الرسائل الفاشلة، لأن Meta تحتسب على الرسائل المُسلَّمة فقط.
- من v24.0، لا تتوقع كائن conversation إلا داخل نافذة نقطة الدخول المجانية، حيث يكون معرّفه فريداً لكل نافذة.
ماذا يعني ذلك لردود الذكاء الاصطناعي على رقم Coexistence؟
كل رد يرسله الذكاء الاصطناعي لديك أو أي أتمتة عبر API هو رسالة غير قالبية، لذا فئتها service: ضمن الطبقة المجانية الشهرية للرقم تظهر free_customer_service، وبعد ذلك تظهر regular. أما القوالب التي يرسلها الذكاء الاصطناعي عبر send_template فتحمل فئتها الخاصة. وتضيف دليل Meta لـ Coexistence فارقاً واحداً مهماً للتكلفة: الرسائل التي يكتبها المالك في تطبيق WhatsApp Business لا تخضع لنافذة خدمة العملاء ولا تؤثر على تسعير Cloud API.
تحتسب Meta الرسائل على حساب WhatsApp Business الخاص بالنشاط التجاري، لكل رسالة، بحسب الفئة والبلد، ولا يُضيف easyCoexistence عليها هامشاً أبداً، ويُفوتر استخدام الذكاء الاصطناعي من مزوّد الذكاء الاصطناعي لديك باستخدام مفتاحك الخاص.
الأخطاء الشائعة
- عدّ كائن التسعير في كل مرة يظهر فيها. قد يأتي مع أكثر من حالة للرسالة نفسها، فاعدّه مرة واحدة لكل wamid.
- قراءة billable وحده. Meta تعمل على إيقافه، وتطلب استخدام type وcategory معاً.
- الإبقاء على القراءة القديمة لـ free_customer_service قبل أكتوبر. منذ 1 أكتوبر 2026 يُعلّم رسالة خدمة ضمن الطبقة المجانية الشهرية للرقم.
- توقّع مبالغ في الحمولة. الكائن يسمّي الفئة، أما التعرفات فتأتي من بطاقات أسعار Meta أو من pricing_analytics.
تبقى رسوم Meta على حساب WhatsApp Business الخاص بك دون أي هامش. من US$ 9 إلى US$ 0.75 لكل رقم شهرياً، وتنخفض كلما أضفت أرقاماً، مع أول 3 أيام مجانية.
الأسئلة الشائعة
أي حساب يدفع ثمن الرسالة؟
حساب WhatsApp Business الذي أرسلها. وعندما ترسل عدة حسابات من رقم واحد، تنسب Meta كل رسوم إلى الحساب الذي أرسل تلك الرسالة، بطريقة دفعه وحدود إنفاقه الخاصة.
ما هو marketing_lite؟
الفئة والنوع من التسعير للرسائل المُرسلة عبر Marketing Messages API الخاصة بـ WhatsApp، وهو مسار إرسال منفصل لقوالب التسويق بخيارات تسعير خاصة به، مثل أقصى سعر لكل تسليم.
متى حلّ التسعير لكل رسالة محل المحادثات؟
في 1 يوليو 2025. قد تُظهر webhooks المُرسلة قبل ذلك التاريخ القيمة CBP في pricing_model، أي التسعير القائم على المحادثات، أما الأحدث فتُظهر PMP. والشيفرة التي ما زالت تجمّع الرسوم بمعرّف المحادثة تحتاج إلى تحديث.
هل تُعاد الطبقة المجانية كل شهر؟
نعم. تمنح Meta كل رقم هاتف تجاري 1,000 رسالة خدمة مُسلَّمة شهرياً، دون ترحيل للرصيد، وتُعاد تعيينها عند منتصف الليل بتوقيت حساب WhatsApp Business.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في