إذا كانت احتياجاتك تتجاوز التكاملات الجاهزة، فواجهة برمجة تطبيقات Wbots API تمنحك تحكمًا كاملًا: أرسل رسائل، اقرأ المحادثات، وأدر جهات الاتصال برمجيًا من أي نظام تبنيه بنفسك.
المصادقة بمفتاح API
كل طلب لواجهة Wbots API يحتاج مفتاح مصادقة (API Key) يُنشأ من الإعدادات ← المطورين ← مفاتيح API. أرسل المفتاح في ترويسة الطلب (Header):
| الترويسة | القيمة |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
لا تضع مفتاح API في كود الواجهة الأمامية (Frontend) المرئي للمستخدمين — استخدمه فقط من الخادم (Backend).
أهم النقاط الطرفية (Endpoints)
| النقطة الطرفية | الوظيفة |
|---|---|
| POST /v1/messages | إرسال رسالة جديدة لعميل عبر أي قناة مرتبطة |
| GET /v1/conversations | جلب قائمة المحادثات مع إمكانية الفلترة |
| GET /v1/contacts | جلب بيانات جهات الاتصال |
| POST /v1/contacts | إنشاء أو تحديث جهة اتصال |
مثال عملي: إرسال رسالة
مثال بسيط لإرسال رسالة واتساب عبر Wbots API باستخدام cURL:
| curl -X POST https://api.wbots.app/v1/messages \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"channel":"whatsapp","to":"+201xxxxxxxxx","text":"مرحبًا! طلبك في الطريق 🚚"}' |
استجابة ناجحة تعيد معرّف الرسالة (message_id) وحالتها، يمكنك استخدامه لتتبّع التسليم لاحقًا.
حدود الاستخدام (Rate Limits)
لحماية استقرار المنصة، تخضع الطلبات لحدود معدّل حسب باقتك. إن تجاوزت الحد، ستستقبل استجابة بكود الحالة 429 — أعد المحاولة بعد فترة قصيرة (Exponential Backoff) بدل الإرسال المتكرر الفوري.
استقبال الأحداث عبر Webhooks
بدل الاستعلام المستمر (Polling)، اضبط Webhook ليصلك إشعار فوري بكل رسالة أو محادثة جديدة — أكفأ بكثير من فحص القاعدة كل بضع ثوانٍ.
الأسئلة الشائعة
هل Wbots API متاح لكل الباقات؟
الوصول لواجهة API متاح حسب باقتك — راجع صفحة الأسعار أو تواصل مع فريق المبيعات لمعرفة التفاصيل.
ما هي صيغة البيانات المستخدمة؟
كل الطلبات والاستجابات بصيغة JSON عبر HTTPS، باتباع مبادئ REST القياسية.
هل يمكن اختبار الـ API قبل الإطلاق الفعلي؟
نعم، استخدم بيئة الاختبار (Sandbox) إن كانت متاحة في باقتك، أو ابدأ بحساب تجريبي منخفض الحجم.
كيف أتعامل مع الأخطاء؟
تعيد الواجهة أكواد حالة HTTP قياسية (400 لخطأ في الطلب، 401 لمصادقة غير صحيحة، 429 لتجاوز الحد) مع رسالة توضيحية في نص الاستجابة.