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

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

    English
    في الصفحة دي

    الويب هوك

    ضبط ويب هوك الحساب

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

    رابط https عام (متشيك ضد SSRF). المفتاح بيرجع مرة واحدة عند الإنشاء.

    البارامترات

    الهيدرز

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

    الـ Body

    الاسمالنوعالقيودالوصف
    urlإجباريالنوعstringالقيود—الوصفرابط https:// عام على بورت 443 (أو 80). العناوين الخاصة/الداخلية مرفوضة والـ redirects مش بتتتبع.
    eventsاختياريالنوعarray | nullالقيود—الوصفأنواع الأحداث اللي عايز توصلك. سيبها فاضية (أو null) لكل الأحداث — والأنواع الجديدة هتوصلك تلقائي.

    الطلب

    curl -X PUT "https://mursilat.com/api/v2/webhook" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -H "Content-Type: application/json" \
      -d '{
      "url": "https://example.com/mursilat",
      "events": null
    }'
    الطلب — JSON
    {
      "url": "https://example.com/mursilat",
      "events": null
    }

    الرد

    200مثال

    200 — application/json
    {
      "url": "https://example.com/mursilat",
      "events": [
        "message.received",
        "message.status",
        "interactive.reply",
        "poll.vote",
        "contact.opted_out",
        "contact.opted_in",
        "session.status",
        "number.status",
        "number.restricted",
        "campaign.status",
        "otp.verified",
        "conversation.attributed"
      ],
      "secretConfigured": true,
      "secret": "whsec_…(shown once)"
    }

    شكل الرد

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

    • responseobject4 حقل
      • urlstring "https://example.com/mursilat"
      • eventsarray12 عنصر
        • [0]string "message.received"
      • secretConfiguredboolean true
      • secretstring "whsec_…(shown once)"

    الأخطاء

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

    الأخطاء →

    جرّب

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

    مثال موثّق

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

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

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

    نفس الطلب بـ curl
    curl -X PUT 'https://mursilat.com/api/v2/webhook' \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H 'Accept: application/json' \
      -H 'Content-Type: application/json' \
      -d '{"url":"https://example.com/mursilat","events":null}'

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

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

    PUT https://mursilat.com/api/v2/webhook