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

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

    English
    في الصفحة دي

    زرار الموقع وروابط واتساب

    إنشاء رابط واتساب متتبَّع

    POST/v2/links
    • الصلاحية:links:write
    • Idempotency-Key:اختياري
    • بيغيّر إعدادات

    https://mursilat.com/l/<slug> بيسجل ضغطة مجهولة ويحوّل (302) لـ wa.me بالرسالة الجاهزة + الكود — ومش لأي مكان تاني أبدًا. الاسم: 10 حروف عشوائية (صعب تخمينها) أو كلمة تختارها. قيم utm_* على الرابط بتغطي على الافتراضي. أكواد QR (SVG / PNG) في لوحة التحكم.

    البارامترات

    الهيدرز

    الاسمالنوعالقيودالوصف
    Idempotency-Keyاختياريالنوعstringالقيود≤ 191 حرفالوصفid فريد من عندك للعملية دي (حد أقصى 191 حرف ASCII). لو كررت بنفس المفتاح ونفس الـ body بيرجعلك أول رد ومعاه Idempotent-Replayed: true — عمرها ما تتنفذ مرتين. بيتحفظ 24 ساعة.
    X-Request-Idاختياريالنوعstringالقيود—الوصفاختياري: id الطلب بتاعك وبيرجعلك (غير كده بنعمل req_…). اديه للدعم لو احتجت.

    الطلب

    curl -X POST "https://mursilat.com/api/v2/links" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -H "Content-Type: application/json" \
      -d '{
      "name": "Instagram bio",
      "numberId": "cm1abcd2345efgh6789ijkl",
      "message": "عايز أعرف الأسعار",
      "utm": {
        "source": "instagram",
        "medium": "bio"
      }
    }'
    الطلب — JSON
    {
      "name": "Instagram bio",
      "numberId": "cm1abcd2345efgh6789ijkl",
      "message": "عايز أعرف الأسعار",
      "utm": {
        "source": "instagram",
        "medium": "bio"
      }
    }

    الرد

    201مثال

    201 — application/json
    {
      "id": "cm9link0001",
      "name": "Instagram bio",
      "slug": "k7m2xq9prw",
      "customSlug": false,
      "url": "https://mursilat.com/l/k7m2xq9prw",
      "numberId": "cm1abcd2345efgh6789ijkl",
      "number": {
        "name": "فرع المعادي",
        "phone": "201001234567"
      },
      "message": "عايز أعرف الأسعار",
      "utm": {
        "source": "instagram",
        "medium": "bio",
        "campaign": "",
        "content": "",
        "term": ""
      },
      "attribution": {
        "enabled": true,
        "label": "ref",
        "position": "end"
      },
      "enabled": true,
      "stats7d": {
        "clicks": 64,
        "conversations": 18
      },
      "createdAt": "2026-10-14T09:00:00.000Z",
      "updatedAt": "2026-10-14T09:00:00.000Z"
    }

    شكل الرد

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

    • responseobject14 حقل
      • idstring "cm9link0001"
      • namestring "Instagram bio"
      • slugstring "k7m2xq9prw"
      • customSlugboolean false
      • urlstring "https://mursilat.com/l/k7m2xq9prw"
      • numberIdstring "cm1abcd2345efgh6789ijkl"
      • numberobject2 حقل
        • namestring "فرع المعادي"
        • phonestring "201001234567"
      • messagestring "عايز أعرف الأسعار"
      • utmobject5 حقل
        • sourcestring "instagram"
        • mediumstring "bio"
        • campaignstring ""
        • contentstring ""
        • termstring ""
      • attributionobject3 حقل
        • enabledboolean true
        • labelstring "ref"
        • positionstring "end"
      • enabledboolean true
      • stats7dobject2 حقل
        • clicksinteger 64
        • conversationsinteger 18
      • createdAtstring "2026-10-14T09:00:00.000Z"
      • updatedAtstring "2026-10-14T09:00:00.000Z"

    الأخطاء

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

    الأخطاء →

    جرّب

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

    مثال موثّق

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

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

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

    نفس الطلب بـ curl
    curl -X POST 'https://mursilat.com/api/v2/links' \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H 'Accept: application/json' \
      -H 'Content-Type: application/json' \
      -d '{"name":"Instagram bio","numberId":"cm1abcd2345efgh6789ijkl","message":"عايز أعرف الأسعار","utm":{"source":"instagram","medium":"bio"}}'

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

    ده بيغيّر إعدادات حسابك.

    POST https://mursilat.com/api/v2/links