انتقل للمحتوى

    عربي أو إنجليزي · ↑↓ للتنقل · Enter للفتح · Esc للقفل

    English
    في الصفحة دي

    الرسايل

    مراحل حالة الرسالة

    GET/v2/messages/{messageId}
    • الصلاحية:messages:read
    • Idempotency-Key:مش مستخدم
    • مفتاح الرقم شغال— بيقبل كمان مفتاح x-api-key القديم الخاص بالرقم، لنفس الرقم.
    • قراءة بس

    queued → sent → delivered → read أو failed مع كود الخطأ.

    البارامترات

    المسار

    الاسمالنوعالقيودالوصف
    messageIdإجباريالنوعstringالقيود—الوصفid الرسالة اللي رجع من POST /v2/messages.

    الهيدرز

    الاسمالنوعالقيودالوصف
    X-Request-Idاختياريالنوعstringالقيود—الوصفاختياري: id الطلب بتاعك وبيرجعلك (غير كده بنعمل req_…). اديه للدعم لو احتجت.

    الطلب

    curl -X GET "https://mursilat.com/api/v2/messages/3EB0A1B2C3D4E5F60718" \
      -H "Authorization: Bearer $WASLA_API_KEY"

    الرد

    200مثال

    200 — application/json
    {
      "id": "3EB0A1B2C3D4E5F60718",
      "numberId": "cm1abcd2345efgh6789ijkl",
      "type": "text",
      "reference": "order-1042",
      "to": "2010****4567",
      "status": "read",
      "scheduledAt": null,
      "error": null,
      "interactionId": null,
      "timeline": [
        {
          "status": "queued",
          "at": "2026-10-13T08:00:00.000Z"
        },
        {
          "status": "sent",
          "at": "2026-10-13T08:00:01.200Z"
        },
        {
          "status": "delivered",
          "at": "2026-10-13T08:00:02.900Z"
        },
        {
          "status": "read",
          "at": "2026-10-13T08:03:10.000Z"
        }
      ],
      "createdAt": "2026-10-13T08:00:00.000Z",
      "updatedAt": "2026-10-13T08:03:10.000Z"
    }

    شكل الرد

    حقول الرد في المثال. افتح الكائنات والقوايم.

    • responseobject12 حقل
      • idstring "3EB0A1B2C3D4E5F60718"
      • numberIdstring "cm1abcd2345efgh6789ijkl"
      • typestring "text"
      • referencestring "order-1042"
      • tostring "2010****4567"
      • statusstring "read"
      • scheduledAtnull null
      • errornull null
      • interactionIdnull null
      • timelinearray4 عنصر
        • [0]object2 حقل
          • statusstring "queued"
          • atstring "2026-10-13T08:00:00.000Z"
      • createdAtstring "2026-10-13T08:00:00.000Z"
      • updatedAtstring "2026-10-13T08:03:10.000Z"

    الأخطاء

    غير أخطاء المصادقة وحدود الطلبات والتحقق اللي ممكن ترجع من أي endpoint:

    الأخطاء →

    جرّب

    ابعت الطلب ده من متصفحك لـ API مرسلات.

    مثال موثّق

    معاينة — النسخة دي من التوثيق مش على mursilat.com، فالكونسول بيعرض المثال الموثّق بدل ما يكلم الـ API.

    الطلبات الحقيقية بتستخدم رقمك وباقتك الحقيقيين: ممكن تبعت رسايل واتساب وتصرف من رصيدك وتمسح بيانات. (قراءة بس)

    متخزن في ذاكرة التبويب ده بس: عمره ما بيتحفظ ولا بيتحط في الرابط، وبيتبعت لـ mursilat.com بس. لو عملت reload بيتنسي.

    بارامترات المسار

    تبعت الطلب ده بجد؟

    GET /v2/messages/{messageId}