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

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

    English
    في الصفحة دي

    الرسايل

    تفاعل على رسالة

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

    إيموجي واحد؛ "" بيشيل التفاعل. للرسايل الواردة ابعت numberId.

    البارامترات

    المسار

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

    الهيدرز

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

    الـ Body

    الاسمالنوعالقيودالوصف
    emojiإجباريالنوعstringالقيود—الوصفإيموجي واحد. "" بيشيل تفاعلك.
    numberIdاختياريالنوعstringالقيود—الوصفبس لو بتتفاعل مع رسالة واردة (أو رسالة ما اتبعتتش من v2).

    الطلب

    curl -X POST "https://mursilat.com/api/v2/messages/3EB0A1B2C3D4E5F60718/reactions" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -H "Content-Type: application/json" \
      -d '{
      "emoji": "👍"
    }'
    الطلب — JSON
    {
      "emoji": "👍"
    }

    الرد

    200مثال

    200 — application/json
    {
      "messageId": "3EB0A1B2C3D4E5F60718",
      "action": "react",
      "emoji": "👍"
    }

    شكل الرد

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

    • responseobject3 حقل
      • messageIdstring "3EB0A1B2C3D4E5F60718"
      • actionstring "react"
      • emojistring "👍"

    الأخطاء

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

    الأخطاء →

    حماية الرقم والسلوك

    مرفوضة: المستلمين اللي لغوا اشتراكهم (422 SAFETY_SUPPRESSED)، والمحتوى الممنوع زي الروابط المختصرة أو الروابط من أرقام جديدة (422 SAFETY_CONTENT_BLOCKED)، والرقم الواقف (423 SAFETY_NUMBER_PAUSED؛ والرد على اللي كلموك آخر 24 ساعة شغال). متكررش دول زي ما هم.

    جرّب

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

    مثال موثّق

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

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

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

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

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

    ده هيبعت رسالة واتساب حقيقية (أو حملة / كود) من رقمك وهيصرف من رصيد باقتك.

    POST /v2/messages/{messageId}/reactions