# دليل مطوري Wbots API: المصادقة والنقاط الطرفية | Wbots

> مرجع تقني لواجهة برمجة تطبيقات Wbots: كيفية المصادقة بمفتاح API، أهم النقاط الطرفية لإرسال الرسائل وقراءة المحادثات، مع مثال كود عملي.

**Canonical URL:** https://wbots.app/kb-api-developers.html  
**Content language:** en (the site also serves Arabic; use the on-page language switcher)  
**Format:** Markdown representation of the HTML page at the same URL.

---
**المنتج Product**

**الحلول Solutions**

**المصادر Resources**

**الشركة Company**

## دليل مطوري Wbots API: المصادقة، النقاط الطرفية، وأمثلة عملية

إذا كانت احتياجاتك تتجاوز التكاملات الجاهزة، فواجهة برمجة تطبيقات **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](https://wbots.app/kb-integrations) ليصلك إشعار فوري بكل رسالة أو محادثة جديدة — أكفأ بكثير من فحص القاعدة كل بضع ثوانٍ.

### الأسئلة الشائعة

#### هل Wbots API متاح لكل الباقات؟

الوصول لواجهة API متاح حسب باقتك — راجع صفحة الأسعار أو تواصل مع فريق المبيعات لمعرفة التفاصيل.

#### ما هي صيغة البيانات المستخدمة؟

كل الطلبات والاستجابات بصيغة JSON عبر HTTPS، باتباع مبادئ REST القياسية.

#### هل يمكن اختبار الـ API قبل الإطلاق الفعلي؟

نعم، استخدم بيئة الاختبار (Sandbox) إن كانت متاحة في باقتك، أو ابدأ بحساب تجريبي منخفض الحجم.

#### كيف أتعامل مع الأخطاء؟

تعيد الواجهة أكواد حالة HTTP قياسية (400 لخطأ في الطلب، 401 لمصادقة غير صحيحة، 429 لتجاوز الحد) مع رسالة توضيحية في نص الاستجابة.

#### ابدأ البناء مع Wbots API

احصل على مفتاح API وابدأ ربط أنظمتك المخصّصة اليوم.

### مقالات ذات صلة

#### دليل Wbots الكامل

من الصفر إلى مكتب دعم يعمل بالكامل — دليل شامل خطوة بخطوة.

#### تكاملات Wbots

Webhooks وواجهة API لربط أدواتك بأنظمتك.

#### حل مشاكل Wbots الشائعة

إجابات سريعة لأكثر المشاكل تكرارًا.

##### في هذا المقال

---

## About Wbots

Wbots is an omni-channel customer support platform operated by W Techne for Information
Technology (Egypt). It is an independent WhatsApp Business Solution Provider and is **not**
affiliated with, or operated by, Meta Platforms, Inc. WhatsApp and Meta are trademarks of
Meta Platforms, Inc.

- Site index for AI agents: https://wbots.app/llms.txt
- Sitemap: https://wbots.app/sitemap.xml
- Help center: https://wbots.app/kb
- Pricing: https://wbots.app/pricing
- Contact: https://wbots.app/contact
- Security contact: https://wbots.app/.well-known/security.txt