whatsapp api Setup

? فكرة المشروع:

نسعى إلى إنشاء نظام Back-End متكامل لربط حساب واتساب للأعمال (WhatsApp Business API – Cloud Version) بخوادمنا، بحيث يمكننا إرسال واستقبال الرسائل بشكل رسمي وآمن، مع إعداد كامل للـ Webhooks والتوثيق.

الأهداف الأساسية:

1.إعداد تطبيق أعمال داخل منصة Meta Developer وربط منتج WhatsApp Cloud API به.

2.إنشاء Webhook فعّال لاستقبال إشعارات الرسائل (الواردة، المرسلة، المقروءة).

3.بناء واجهة API باستخدام FastAPI تسمح بإرسال واستقبال الرسائل بشكل برمجي.

4.إعداد نظام لتخزين البيانات (PostgreSQL أو MongoDB).

5.إدارة رموز الوصول (Access Tokens) وتجديدها آليًا.

6.اختبار التكامل بإرسال رسالة "Hello World" إلى أرقام حقيقية.

7.توفير توثيق واضح وسهل الاستخدام (Swagger / OpenAPI docs).

8.النشر على بيئة سحابية (مثل AWS / Render / Railway) مع إعداد SSL.

️ نطاق العمل المطلوب:

•تصميم هيكل المشروع (project structure) باستخدام أفضل ممارسات FastAPI.

•تنفيذ endpoints خاصة بالرسائل (send / receive / status).

•ربط الـ Webhook مع Meta وإدارة التحقق (Webhook Verification).

•بناء جداول القاعدة (users, messages, logs).

•تنفيذ وحدة Logging & Monitoring لتتبع أداء النظام.

•إعداد Docker وملفات التشغيل (docker-compose).

•اختبار كامل للنظام باستخدام pytest أو أدوات مماثلة.

المتطلبات الفنية:

•خبرة قوية في Python + FastAPI

•خبرة سابقة في REST APIs وWebhooks

•معرفة جيدة بمنصة Meta for Developers

•خبرة في قواعد البيانات (PostgreSQL / SQLAlchemy)

•خبرة في النشر على السحابة (AWS / Render / Railway / Docker)

•معرفة بالتكامل مع APIs خارجية (مثل Twilio أو SendGrid) تعتبر ميزة إضافية

? مخرجات المشروع النهائية:

•كود نظيف ومنظّم قابل للتوسع.

•بيئة تشغيل جاهزة (Dockerized).

•ملف توثيق كامل (API Docs + Readme).

•نظام يعمل فعليًا ومربوط مع حساب WhatsApp Business.

•دعم فني قصير بعد التسليم (لمدة أسبوعين للتأكد من الاستقرار).