WhatsApp API على Omdaa: إرسال واستقبال بدون Twilio — دليل 2026
على Omdaa، WhatsApp API منتج GA أساسي: تربط رقمك عبر جلسة QR من Sessions، ثم ترسل وتستقبل عبر REST أو الواجهة، وتوجّه الأحداث إلى Webhooks أو بوتات n8n/OpenAI. الطبقة OMDAA API Free بدون حد زمني للاستخدام العادل — لا تحتاج Twilio للبدء.
الفرق التشغيلي عن «مكتبة Baileys محلية»: Omdaa تدير الاتصال، إعادة الربط، المراقبة، والمفاتيح على خوادم الإنتاج. أنت تركز على منطق العمل (دعم، تأكيد طلب، تنبيه، تذكير) بدل صيانة WebSocket وQR بنفسك.
ماذا تستطيع فعله فعلياً؟
- إرسال نص، صور، ملفات، صوت، موقع، جهات اتصال، ملصقات، تفاعلات (reactions).
- رسائل تفاعلية: أزرار، قوائم، استطلاعات، قوالب من Interactive و Templates.
- استقبال رسائل واردة وتمريرها لـ Webhooks أو بوت.
- مجموعات وجهات اتصال من Groups / Contacts.
- جدولة وBulk من لوحات Scheduled و Bulk مع سياسة opt-in.
مسار التشغيل في 10 دقائق
① سجّل على omdaa.com · ② أنشئ Session وامسح QR · ③ انتظر حالة connected في Monitoring · ④ أنشئ API Key من API Keys · ⑤ أرسل رسالة تجريبية من Messages أو curl حسب omdaa.net · ⑥ اربط Webhook HTTPS لاستقبال الوارد.
إن فشل QR: أعد توليد QR، تأكد أن الرقم غير مربوط بجهاز/سيرفر آخر بنفس الوقت، وراجع diagnostics في الجلسة. للبروكسي المقيد استخدم إعداد Proxy على الجلسة.
Web مقابل Meta Cloud API
جلسة Web مناسبة للدعم، الأتمتة الخفيفة، والتجارب، وربط CRM عبر Webhooks. للحجم الكبير جداً، قوالب Meta الرسمية المعتمدة، أو متطلبات compliance صارمة — راجع أسعار واتساب للأعمال 2026 وخطط Cloud. Omdaa لا تلغي Meta؛ تقدّم مساراً أسرع للبدء ومساراً مجانياً للـ Free API.
أمان وممارسات
ضع المفاتيح في backend فقط. لا ترسل spam — استخدم opt-in. للأرقام الجديدة راجع تأهيل الرقم وحدود الحظر. راقب Quality وsession health قبل حملات Bulk.
تكاملات مكمّلة
بعد استقرار الإرسال: اربط Webhooks، ثم n8n أو OpenAI Bots، أو تحكّم من Cursor عبر MCP.
هندسة الطلب: من الـ Client إلى واتساب
يمر طلب الإرسال النموذجي كالتالي: تطبيقك يستدعي REST على omdaa.com/api/v1 بمفتاح Bearer، الـ backend يتحقق من الـ scopes والجلسة، ثم يمرّر الرسالة لمحرك الجلسة المتصلة. عند النجاح تحصل على معرف رسالة يمكنك تخزينه في CRM لربط المحادثة لاحقاً مع تذكرة الدعم.
للاستقبال، المسار معكوس: واتساب → محرك الجلسة → حدث Webhook أو بوت. صمّم idempotency من اليوم الأول لأن إعادة المحاولة واردة في الشبكات غير المستقرة. افصل طابور المعالجة عن HTTP response السريع حتى لا تفقد أحداثاً بسبب timeout.
أنواع الرسائل ومتى تستخدم كل نوع
النص القصير للتأكيدات الفورية. الصور لإثبات الشحن أو دليل منتج. الملفات للفواتير PDF. الأزرار لاختيارات محدودة (تتبع / إلغاء / موظف). القوائم عندما تتجاوز الخيارات ثلاثة. الاستطلاعات لـ NPS بعد إغلاق التذكرة. الموقع لطلب مندوب أو فرع قريب. لا تخلط كل الأنواع في أول رسالة — ابدأ بنص واضح ثم قدّم تفاعلاً.
مقارنة عملية مع البدائل
مقابل Twilio/Cloud: Omdaa أسرع للبدء ومسار Free أوضح للمطورين؛ Cloud أنسب للقوالب الرسمية المعتمدة والحجم المؤسسي. مقابل Wassenger/UltraMsg: ركّز على أن Omdaa تجمع Free API + MCP + Mail + Identity في حساب واحد. مقابل self-host Baileys: توفر Ops (reconnect/monitoring) على حساب Omdaa بدل نوبتك الليلية.
مؤشرات جودة قبل الإطلاق العام
اختبر على رقم داخلي أولاً. قِس نسبة فشل الإرسال، زمن وصول Webhook، ومعدل إعادة ربط الجلسة أسبوعياً. وثّق runbook: من يُبلَّغ عند سقوط الجلسة؟ أين المفاتيح؟ من يملك pause للـ Bulk؟ بدون runbook يتحول الـ API إلى نقطة فشل صامتة.
أسئلة شائعة
هل WhatsApp API على Omdaa مجاني؟
نعم ضمن OMDAA API Free للاستخدام العادل؛ راجع لوحة free-api للصلاحيات والحدود.
هل أحتاج حساب Twilio؟
لا للبدء عبر جلسات Omdaa. Twilio بديل منفصل لست مضطراً له.
كم جلسة أستطيع؟
حسب خطتك — تظهر في Dashboard و Billing.
أين الوثائق؟
https://omdaa.net و DevPortal WhatsApp.
ابدأ مجاناً: إنشاء حساب · لوحة التحكم · الوثائق