"استخدام واجهة برمجة تطبيقات واتساب: المتطلبات والقيود"

1. ليس كل واتساب متشابه: الفرق بين التطبيق وواجهة الـ API

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

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

كما رأيت، النقاط الأساسية هي:

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

2. "قواعد اللعبة": أهم قيود واتساب API

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

بناءً على ما قرأته، يمكننا تلخيص أهم ثلاث قواعد:

أ. نافذة الـ 24 ساعة (The 24-Hour Window)

هذه هي القاعدة الأهم على الإطلاق. عندما يرسل لك مستخدم رسالة، تُفتح "نافذة خدمة عملاء" مدتها 24 ساعة.

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

ب. رسائل القوالب (Message Templates)

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

• تنبيهات الشحن ("تم شحن طلبك!").
• تذكير بالموعد ("نود تذكيرك بموعدك غداً").
• رسائل تسويقية ("لدينا خصم 20% لك").

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

ج. الموافقة المسبقة للمستخدم (Opt-In)

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

3. المتطلبات الفنية والتكلفة

الآن بعد أن فهمنا القواعد، ماذا نحتاج عملياً للبدء، وهل الخدمة مجانية؟

المتطلبات الأساسية

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

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

نموذج التكلفة

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

كما رأيت، التكلفة تتكون من:

1. رسوم اشتراك المنصة (Platform Fee): عادةً ما يتم استخدام الخدمة عبر "مزود خدمة معتمد" (Business Solution Provider - BSP) مثل 360dialog أو BusinessChat، والذي يتقاضى اشتراكاً شهرياً.
2. رسوم واتساب لكل محادثة (Per-Conversation Fee): تتقاضى Meta رسوماً عن كل "محادثة" مدتها 24 ساعة. يختلف سعر المحادثة حسب الدولة، وحسب من بدأها (العميل أم الشركة)، ونوعها (خدمة، تسويق، ...إلخ).

خلاصة الدرس

في هذا الدرس التأسيسي، تعلمنا النقاط الحاسمة التي تحكم استخدام واتساب API لبناء وكيلنا:

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

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

ماذا بعد؟

الآن بعد أن فهمنا "قواعد اللعبة"، حان وقت اللعب! في الدرس القادم، سنبدأ العمل البرمجي. سنقوم ببناء أول "أداة" (Tool) في ترسانة وكيلنا الجديد: أداة لإرسال الرسائل الصادرة عبر واتساب. سنطبق ما تعلمناه في الوحدات السابقة عن استدعاء واجهات الـ API باستخدام مكتبة requests في بايثون، ولكن هذه المرة مع واجهة واتساب الحقيقية. استعد لترى وكيلك يرسل أول رسالة واتساب