Sendveo API

تتيح Sendveo API لأنظمتك ربط أرقام واتساب، وإرسال الرسائل واستقبالها، وبثّ الرسائل الواردة إلى نقطة النهاية الخاصة بك، كل ذلك تحت حساب Sendveo الخاص بك. إنها واجهة REST API صغيرة ويمكن التنبؤ بسلوكها، تتحدّث JSON عبر HTTPS.

مقدمة

تُصادَق كل طلب بمفتاح API تنشئه في لوحة التحكم. الاستجابات بصيغة JSON، والأخطاء تتشارك مغلّفًا واحدًا، والمعرّفات سلاسل نصية مبهمة يمكنك تخزينها كما هي.

العنوان الأساسي

تقع كل نقاط النهاية تحت عنوان أساسي واحد مُصدَّر بإصدار:

العنوان الأساسي

https://api.sendveo.com/v1

المسارات في هذا المرجع نسبية إلى ذلك العنوان الأساسي، على سبيل المثال /numbers هو https://api.sendveo.com/v1/numbers.

بداية سريعة

أرسل طلبك الأول. اعرض الأرقام الموجودة في حسابك:

GET/v1/numbers

cURL

curl https://api.sendveo.com/v1/numbers \
  -H "X-API-KEY: sv_live_your_key_here"

استجابة ناجحة:

200 OK

{
  "numbers": [
    {
      "id": "chn_sales01",
      "displayName": "Sales line",
      "declaredNumber": "+212661234567",
      "pairedNumber": "+212661234567",
      "status": "CONNECTED",
      "connectedAt": "2026-08-19T09:12:00Z"
    }
  ]
}

التحديثات المباشرة في لوحة التحكم

تبقى لوحة تحكم Sendveo محدَّثة ما دامت مفتوحة: تتحرّك علامات التسليم، وتظهر التفاعلات والتعديلات، وتصل الرسائل الجديدة إلى القائمة مع عدّادات غير المقروء، ويظهر تغيّر حالة أي رقم فورًا. وهي تقرأ تدفّقًا على GET /app/events يحمل الأحداث الستة عشر نفسها التي يحملها الـ webhook، وبالأشكال نفسها. أما لأنظمتك أنت فالـ webhook هو القناة المناسبة، لأنه دائم وقابل لإعادة المحاولة؛ والتدفّق موجَّه لمتصفّح يحمل جلسة لوحة تحكم.

الاصطلاحات

أرقام الهاتف تستخدم الصيغة E.164 (علامة + بادئة ورمز الدولة). الطوابع الزمنية بصيغة ISO 8601 بتوقيت UTC. المعرّفات سلاسل نصية مبهمة؛ والأعداد أرقام. تُرجع كل نقاط نهاية القوائم كائنًا يحوي مصفوفة مُسمّاة، وليس مصفوفة مجرّدة أبدًا.

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