Watsy
التحقق والرسائلسجل الرسائل

التحقق والرسائل

سجل الرسائل

آخر محاولات الإرسال في المشروع، من الأحدث إلى الأقدم.

GEThttps://watsy.me/v1/messages
curl "https://watsy.me/v1/messages?limit=20" \
  -H "Authorization: Bearer $WATSY_KEY"
{
  "object": "list",
  "data": [
    {
      "id": "7e1d2c3b-4a59-4687-9a0b-c1d2e3f4a5b6",
      "object": "message",
      "verification_id": "5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11",
      "channel": "telegram",
      "provider": "telegram_gateway",
      "status": "sent",
      "error_code": null,
      "price_milli": 18000,
      "created_at": "2026-10-28T10:00:01.000Z",
      "updated_at": "2026-10-28T10:00:02.000Z",
      "phone": "+9647701234567"
    },
    {
      "id": "0b6f6a3e-1c2d-4e5f-8a9b-1c2d3e4f5a6b",
      "object": "message",
      "verification_id": "5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11",
      "channel": "whatsapp",
      "provider": "meta_cloud",
      "status": "failed",
      "error_code": "whatsapp_131026",
      "price_milli": 0,
      "created_at": "2026-10-28T10:00:00.000Z",
      "updated_at": "2026-10-28T10:00:01.000Z",
      "phone": "+9647701234567"
    }
  ]
}

المصادقة

  • Authorizationstring (header)إلزامي

    Bearer ثم مفتاح المشروع: wsy_live_… أو wsy_test_….

الترويسات

  • X-Request-Idstring

    اختياري، 8 إلى 64 حرفاً. نعيده في الرد، وإلا نولّد واحداً.

معطيات الاستعلام

  • limitintegerالافتراضي: 20

    عدد النتائج من 1 إلى 100.

الرد (200)

application/json
  • objectstringإلزامي

    دائماً list.

  • datamessage[]إلزامي

    محاولة لكل قناة جُرّبت، مع رقم المستلم.

    عرض الحقول الفرعية
    • idstring

      معرّف محاولة الإرسال.

    • objectstring

      دائماً message.

    • verification_idstring

      عملية التحقق التي تتبعها المحاولة.

    • channelstring

      القناة.

      القيم:whatsapptelegramsms

    • providerstring

      المزوّد الذي نفّذ المحاولة: meta_cloud (رقم Watsy على واتساب)، whatsapp_own (رقمك الخاص)، telegram_gateway، أو test في وضع الاختبار.

    • statusstring

      delivered يظهر عندما يرسل المزوّد تقرير تسليم (واتساب حالياً).

      القيم:pendingsentdeliveredfailed

    • error_codestring | null

      سبب الفشل من المزوّد، مثل whatsapp_131026 أو telegram_PHONE_NUMBER_INVALID أو timeout.

    • price_milliinteger

      صافي ما خُصم لهذه المحاولة بالـ milli-IQD. المحاولة المُستردّة تظهر 0.

    • created_atstring

      وقت الإنشاء (ISO 8601، UTC).

    • updated_atstring

      آخر تحديث.

    • phonestring

      رقم المستلم بصيغة E.164.

مفتاح الاختبار يرى رسائل الاختبار فقط، ومفتاح live يرى الرسائل الحقيقية فقط. لا يوجد ترقيم صفحات حالياً: النتائج هي الأحدث فقط.