الحصول على حالة تسليم الرسالة عبر WhatChimp API

تتبع ما إذا تم إرسال رسائلك أو تسليمها أو قراءتها أو فشلت.

Updated 5 February 2026

تتبع ما إذا تم إرسال رسائلك أو تسليمها أو قراءتها أو فشلت، واكتشف لماذا لم تصل الرسالة.

قبل البدء: تأكد من أن لديك مفتاح API الخاص بك ورقم تعريف الهاتف. راجع البدء مع WhatChimp Developer API للحصول على تعليمات الإعداد.

Endpoint

GET/POST /api/v1/whatsapp/get/message-status

https://app.whatchimp.com/api/v1/whatsapp/get/message-status

المعاملات

أين أحصل على wa_message_id؟ كل إرسال ناجح عبر API WhatChimp يُرجع wa_message_id في الاستجابة. احفظ هذه القيمة للتحقق من حالة التسليم لاحقاً.

أين أحصل على whatsapp_bot_id؟ استدعِ endpoint User Info (GET /user/myInfo) — يُرجع مصفوفة whatsapp_bots_details الخاصة بك مع معرفات الروبوت.

أمثلة الطلبات

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/message-status?apiToken=API-KEY&wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=&whatsapp_bot_id=123

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/message-status' \
  -d 'apiToken=API-KEY' \
  -d 'wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=' \
  -d 'whatsapp_bot_id=123'

الاستجابة

{
  "status": "1",
  "message": {
    "message_status": "delivered",
    "delivery_status_updated_at": "2024-07-28 13:21:03",
    "read_time": null,
    "failed_time": null,
    "failed_reason": ""
  }
}

قيم حالة التسليم

حقول الاستجابة

أسباب الفشل الشائعة

حالات الاستخدام

• إيصالات التسليم: تأكد من تسليم الرسائل قبل اتخاذ الإجراء التالي في سير العمل الخاص بك
• تتبع القراءة: اعرف متى شاهد العميل رسالتك
• معالجة الأخطاء: اكتشف الرسائل الفاشلة وأطلق محاولات إعادة أو تنبيهات
• مراقبة SLA: تتبع أوقات التسليم للرسائل الحساسة للوقت مثل OTPs

مقالات ذات صلة

• Get Conversation History via WhatChimp API: استرجع المحادثة الكاملة مع مشترك
• Send Template Messages via WhatChimp API: أرسل رسائل قالب (يُرجع wa_message_id الذي تحتاجه)
• Getting Started with WhatChimp Developer API: إعداد ومصادقة API