واتساب Cloud API: وش لازم تعرف قبل ما تبني منصة أو تشتريها؟ وكيف بنينا K-Message عليه

سؤال يجينا كثير: «نبني منصة واتساب حقتنا على واتساب Cloud API، ولا نشترك في منصة جاهزة؟» وقبل ما تجاوب، لازم تعرف وش يعطيك الـ API فعلًا، ووش الي لازم ينبني فوقه عشان فريقك يشتغل.

واتساب Cloud API هو الواجهة الرسمية من ميتا لإرسال واستقبال رسائل واتساب للأعمال من نظامك. ميتا تستضيفه، وأي منشأة عندها مطوّر تقدر تبني عليه. بس هو أنابيب: يرسل ويستقبل ويبلّغ. ما فيه صندوق وارد، ولا موظفين، ولا جهات اتصال، ولا شاشة وحدة.

في كيرنلتكس بنينا منصتنا K-Message على هذي الواجهة الرسمية. وهنا نمشي على الأجزاء الي تحتاجها أي منصة واتساب جادة: وش تقول ميتا عن كل جزء، ووش يعني لك، وكيف هو في K-Message. لو بتبني، هذي قائمة الشغل. ولو بتشتري، هذي أسئلتك.

وش يعطيك واتساب Cloud API، ووش ما يعطيك

حسب صفحة ميتا عن المنصة، الـ Cloud API يرسل الرسائل عن طريق Graph API، ويوصلك كل شي ثاني عن طريق الويبهوك (Webhooks)، والاثنين على HTTPS مشفّر. وأول ما تبدأ، ميتا تعطيك حساب ورقم تجريبي بحدود مخففة تجرب عليهم قبل رقمك الحقيقي.

الي يجيك من ميتا:

• إرسال نصوص وصور وملفات وأزرار وقوالب.
• إشعار بكل رسالة توصلك، وبحالة كل رسالة ترسلها.
• إدارة القوالب والرقم وحساب واتساب للأعمال.

والي ما يجيك، ولازم أحد يبنيه:

• شاشة يرد منها الفريق، ومين ماسك أي محادثة.
• سجل العملاء وموافقاتهم ومجموعاتهم.
• حفظ الصور والفويسات قبل ما تنتهي صلاحيتها عند ميتا.
• البوت، وقواعد تحويله لموظف.
• التقارير.

هذا كله هو «المنصة». والأجزاء تحت مرتبة بالترتيب الي بتصطدم فيه.

1. الويبهوك: كل شي يجيك من ميتا يوصل كطلب على سيرفرك

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

وهنا أول ثلاث أشياء تفرق المنصة الجادة عن التجربة:

• «انقبلت» مو «وصلت». لما ترسل رسالة، رد الـ API معناه بس إن ميتا استلمت طلبك. هل وصلت للعميل؟ هذا يجيك بعدين في الويبهوك. فالنظام الي يكتب «تم الإرسال» من أول رد، يكذب عليك أحيانًا.
• نفس الإشعار ممكن يجيك مرتين. لو سيرفرك ما رد بـ 200، ميتا تعيد المحاولة لمدة تصل إلى 7 أيام، وتقول صراحة إن هذا ممكن يطلّع إشعارات مكررة. فالمنصة لازم تعرف كل رسالة برقمها (wamid) وما تسجلها مرتين، وإلا الموظف يشوف رسالة العميل مكررة، أو البوت يرد عليها مرتين.
• الترتيب مو مضمون. ميتا تقول إن الرسائل ممكن توصل بغير ترتيب إرسالها. لو ترسل ثلاث رسائل ورا بعض والترتيب يهم، انتظر حالة «وصلت» للأولى قبل ما ترسل الثانية.

وفي صفحة السعة (Throughput) تطلب ميتا إن سيرفر الويبهوك يتحمل ثلاث أضعاف رسائلك الصادرة، لأن كل رسالة ترسلها يرجع لها أكثر من إشعار حالة. وتحدد معيار سرعة: الوسيط ما يتعدى 250 جزء من الثانية، وأقل من 1% من الطلبات يتعدى الثانية. يعني السيرفر يستلم ويرد على طول، والشغل الثقيل (البوت والحفظ والتقارير) يصير بعدين في طابور. السيرفر الي يسوي كل شي وهو ماسك الطلب، يطيح أول ما ترسل حملة.

في K-Message: لما ترسل قالب، المنصة توريك وصل ولا لا، وانقرأ ولا لا، ووش رد العميل. وهذا كله جاي من إشعارات الحالة نفسها.

2. نافذة خدمة العملاء: متى تكتب براحتك ومتى تحتاج قالب

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

وش يعني هذا للمنصة؟

• الموظف لازم يعرف النافذة مفتوحة ولا لا قبل ما يكتب. أسوأ تجربة: موظف يكتب رد طويل لعميل راسلهم أمس الصبح، يضغط إرسال، وتفشل الرسالة.
• لما النافذة تسكّر، المنصة تحوّله لاختيار قالب بدل الكتابة الحرة.
• الموافقة قبل كل شي. ميتا تذكّر في نفس الصفحة إنك ما ترسل إلا لعميل وافق يستقبل منك.

ومن 1 أكتوبر 2026 صارت ردودك داخل النافذة تنحسب رسالة رسالة، بعد ما كانت مجانية. شرحنا الحسبة كاملة في أسعار واتساب API في السعودية. يعني المنصة الي تخلي البوت يرد بخمس رسائل قصيرة بدل رسالة وحدة، صارت تكلفك أكثر.

3. القوالب: تنكتب، تنراجع، وممكن تتوقف بعد ما تنعتمد

القالب رسالة جاهزة فيها متغيرات (اسم العميل، رقم الفاتورة) ترسلها برا النافذة. وحسب أساسيات القوالب عند ميتا:

• لكل قالب فئة: تسويقي، أو خدمي (Utility)، أو مصادقة. والفئة تدخل في السعر.
• المراجعة تلقائية عند الإنشاء وعند أي تعديل، وممكن تاخذ لين 24 ساعة. والقالب ما ينرسل إلا وحالته APPROVED.
• الاعتماد مو نهائي. ميتا تقيّم القالب من تفاعل الناس معه، وممكن توقفه مؤقتًا (Paused) لو تكرر عليه رد فعل سلبي أو قلّت قراءته، أو تعطّله (Disabled).
• ميتا ما تترجم قوالبك. القالب العربي قالب، والإنجليزي قالب ثاني، وكل واحد ينكتب وينراجع لحاله.
• القالب الي ما ينستخدم 12 شهر تأرشفه ميتا، وينحذف بعد 28 يوم لو ما رجّعته.
• عدد القوالب مربوط بالتوثيق. قبل توثيق نشاطك، كل حساب واتساب للأعمال حده 250 قالب. بعد التوثيق ومع اسم عرض معتمد، يوصل لين 6,000. والتوثيق نفسه شرحناه في توثيق حساب واتساب للأعمال.

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

في K-Message: القوالب معتمدة من ميتا وتنرسل بس للعملاء الي وافقوا، وتتابع التسليم والقراءة والردود. والحملات بالقوالب تنرسل لمجموعات العملاء. ووقت الإعداد نجهّز القوالب والردود ومسارات الأتمتة على نشاطك.

4. الموافقة وإيقاف الإرسال: قبل أول حملة

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

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

في K-Message: كل جهة اتصال معها سجل موافقة فيه المصدر والتاريخ. والإرسال لجهة بدون موافقة موثقة ينرفض من النظام نفسه، مو مجرد تنبيه. وأي رسالة توصل فيها كلمة إيقاف، توقف الإرسال لصاحبها تلقائيًا. والمنصة ما تسمح ترفع قوائم أرقام مشتراة أو مجمّعة من مصادر عامة.

5. التسجيل المدمج (Embedded Signup): مين يربط الرقم ومين يملكه

أي منصة تخدم أكثر من منشأة تحتاج إذن من ميتا تدير حسابات غيرها. وحسب توثيق الويبهوك نفسه، المنصة ما يقدر عملاؤها يعطونها هالصلاحيات وقت الربط إلا بعد ما تاخذ «وصول متقدم» من مراجعة ميتا للتطبيق (App Review). وهذا جزء من الي يخلي الشركة مزود تقني معتمد من ميتا.

بعدها يجي التسجيل المدمج: نافذة رسمية من ميتا تنفتح داخل المنصة، صاحب النشاط يدخل فيها بحسابه، ويختار أو ينشئ حساب واتساب للأعمال، ويوثّق رقمه. وميتا تقول إن المنشأة الي تسجلت بهالطريقة تملك أصولها في واتساب، والمنصة ما تقدر تقيّد وصولها لـ WhatsApp Manager. ولو بتبني لنفسك بس، تتجاوز هذا كله وتربط رقمك على تطبيقك مباشرة.

في K-Message: كيرنلتكس مزوّد تقني معتمد من ميتا، فتربط رقمك بنفسك من نافذة ميتا داخل المنصة، والحساب والرقم يبقون في محفظة أعمالك. ونرشدك في توثيق نشاطك عند ميتا، بس القرار قرار ميتا.

6. صندوق الوارد المشترك: الرقم واحد والفريق كامل

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

• الإسناد: كل محادثة لها مسؤول، عشان ما يرد اثنين على نفس العميل، ولا تضيع محادثة لأن كل واحد ظن الثاني رد.
• الملاحظات الداخلية: الموظف يكتب للفريق جنب المحادثة، والعميل ما يشوفها.
• التوجيه: محادثات المبيعات تروح للمبيعات، والدعم للدعم.
• الوسائط: حسب صفحة الوسائط عند ميتا، رابط أي صورة أو فويس يوصلك ينتهي بعد 5 دقايق، والملف نفسه تقدر تحمّله من ميتا 7 أيام بس. المنصة الي ما تحفظ نسختها، الفويس الي أرسله العميل قبل أسبوعين ما عاد يفتح.
• صيغة الأرقام: ميتا تنصح ترسل الرقم بعلامة + ومفتاح الدولة. لو ناقصة، تنضاف له مقدمة دولة رقمك، والرسالة ممكن ما توصل أو تروح لرقم غلط. فالأرقام المكتوبة 05 في الإكسل أو في نظامك لازم تتوحّد قبل أول حملة.

في K-Message: صندوق وارد مشترك فيه محادثات واتساب وإنستقرام، ومعهم الإيميل، مع الإسناد والملاحظات والتوجيه. والواجهة عربية مبنية من اليمين لليسار من الأساس، مو ترجمة آلية. ولوحات حية لسرعة الرد وحجم المحادثات وأداء الفريق.

7. تسليم المحادثة من الذكاء الاصطناعي لموظف

البوت مو ميزة في الـ API. ميتا توصل رسالة العميل، والمنصة هي الي تقرر مين يرد: قاعدة، ولا بوت، ولا موظف. وأصعب نقطة مو إن البوت يرد، أصعب نقطة متى يسكت:

• يحوّل لما العميل يطلب موظف، أو يشتكي، أو فيه خلاف على فلوس، أو ما يكون متأكد من الجواب.
• لما الموظف يمسك المحادثة، البوت يوقف عن هذا العميل تمامًا. ما فيه أسوأ من بوت يدخل بنص كلام الموظف.
• الأسعار والمواعيد تجي من مصدر واحد (قاعدة المعرفة أو نظامك)، مو من «المعقول».

وبما إن ردود النافذة صارت تنحسب من أكتوبر 2026، البوت الثرثار صار مكلف بعد. فصّلنا البوت نفسه في ربط الذكاء الاصطناعي بواتساب.

في K-Message: وكيل ذكاء اصطناعي يرد بأسلوب علامتك من قاعدة معرفتك، ويحوّل لموظف في أي وقت. ومعه بوت عربي، ومسارات (Flows) وقواعد كلمات مفتاحية تفرز العميل وتوجهه بدون برمجة، وحجز مواعيد.

تبني منصة على واتساب Cloud API ولا تشتري وحدة جاهزة؟

بعد القائمة الي فوق، القرار يوضح:

ابنِ بنفسك لو رسائلك تطلع من نظامك وما أحد ينتظر يرد عليها: رمز تحقق، إشعار شحنة، فاتورة. وعندك مطوّر يتابعها بعد الإطلاق، مو بس يطلقها. هنا تحتاج الويبهوك والقوالب والموافقة، وتقدر تستغني عن صندوق الوارد والبوت.

اشترك في منصة لو فيه بشر يردون. صندوق الوارد والإسناد وحفظ الوسائط والبوت وتحويله، كلها شغل ما يخلص بيوم الإطلاق. وميتا تغيّر قواعدها (مثل محاسبة الردود في أكتوبر 2026)، ولازم أحد يلحق عليها.

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

أسئلة تكشف لك أي منصة واتساب قبل ما تشترك

1. لو سيرفركم تعطل ساعة، وش يصير للرسائل الي وصلت فيها؟ وكيف تمنعون التكرار؟
2. الموظف يشوف إن نافذة الـ 24 ساعة سكّرت قبل ما يكتب؟
3. تتابعون حالة القوالب وجودتها، ولا بعرف إن القالب توقف من عملائي؟
4. وين تنحفظ الصور والفويسات، ولكم مدة؟
5. كيف تحفظون موافقة العميل، وكيف يوقف الرسائل؟
6. الربط بالتسجيل المدمج، والحساب والرقم في محفظة أعمالي أنا؟
7. البوت يسكت لما يمسك الموظف المحادثة؟ ومتى يرجع؟

المنصة الي عندها جواب واضح على السبعة، بنت الأجزاء الي فوق.

أسئلة سريعة

واتساب Cloud API مجاني؟

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

وش الفرق بين «واتساب API» و«واتساب Cloud API»؟

«واتساب API» اسم دارج لمنصة واتساب للأعمال الرسمية من ميتا. والـ Cloud API نسختها الي تستضيفها ميتا على سيرفراتها، وهي الي تقصدها أغلب المنصات اليوم لما تقول «واتساب API». أما تطبيق واتساب للأعمال على الجوال فشي ثاني، والفرق بينهم في واتساب API ولا تطبيق واتساب للأعمال.

لو اشتركت في منصة وبعدين ما ناسبتني، يروح رقمي؟

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

كيف نشتغل عليها

نربط رقمك على K-Message بالتسجيل المدمج، ونرشدك في توثيق نشاطك عند ميتا، ونكتب قوالبك ونجهّز سجل الموافقات قبل أول حملة. بعدها نبني معرفة البوت من معلوماتكم الفعلية، ونضبط متى يحوّل للفريق، وندرّب فريقك على صندوق الوارد. وK-Message منتج مستقل من كيرنلتكس، ما يرتبط بميتا ولا واتساب.

التفاصيل في صفحة واتساب API، أو احجز استشارة ونشوف معك هل تحتاج منصة أصلًا، ولا يكفيك ربط مباشر من نظامك.