إشعارات الحالة والتسعير

يرسل عميل واجهة API الخاصة بواتساب للأعمال إشعارات حول status الرسالة بينك وبين المستخدمين. ويتم إرسال هذه الإشعارات عبر الكائن statuses.

تحديثات الحالة

تحديثات التسعير

أمثلة

في الأمثلة التالية، ربما يكون المعرف recipient_id هو الحقل group_id بدلًا من ذلك. ويعتمد ذلك على ما إذا كانت الرسالة مرسلة إلى فرد أم مجموعة.

الحالة: تم إرسال الرسالة

يتم تلقي حدث webhook التالي عندما يرسل النشاط التجاري رسالة كجزء من المحادثة التي بدأها المستخدم (إذا لم يتم إنشاء تلك المحادثة في نقطة إدخال مجانية):

{
   "statuses": [{
     "id": "ID",
     "recipient_id": "WHATSAPP_ID",
     "status": "sent",
     "timestamp": "TIMESTAMP",
     "type": "message",
     "conversation": {
       "id": "CONVERSATION_ID",
       "expiration_timestamp": TIMESTAMP,
       "origin": {
         "type": "user_initiated"
       }
      },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "user_initiated"
    }
   }]
}

يتم تلقي حدث webhook التالي عندما يرسل النشاط التجاري رسالة كجزء من المحادثة التي بدأها النشاط التجاري:

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "sent",
    "timestamp": "TIMESTAMP",
    "type": "message",         
    "conversation": {
      "id": "CONVERSATION_ID",
      "expiration_timestamp": TIMESTAMP,
      "origin": {
         "type": "business_initiated"
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "business_initiated"
    }
   }]
}

يتم تلقي حدث webhook التالي عندما يرسل النشاط التجاري رسالة ردًا على المحادثة التي بدأها المستخدم التي تم إنشاؤها من نقاط إدخال مجانية:

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "sent",
    "timestamp": "TIMESTAMP",
    "type": "message",  
    "conversation": {
      "id": "CONVERSATION_ID",
      "expiration_timestamp": TIMESTAMP,
      "origin": {
         "type": "referral_conversion",
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": false,
      "category": "referral_conversion"
    }
   }]
}

الحالة: تم تسليم الرسالة

يتم تلقي حدث webhook التالي عندما يتم تسليم رسالة النشاط التجاري وتكون تلك الرسالة جزءًا من المحادثة التي بدأها المستخدم (إذا لم يتم إنشاء تلك المحادثة في نقطة إدخال مجانية):

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "delivered",
    "timestamp": "TIMESTAMP",
    "type": "message",
    "conversation": {
      "id": "CONVERSATION_ID",
      "origin": {
         "type": "user_initiated"
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "user_initiated"
    }
  }]
}

يتم تلقي حدث webhook التالي عند تسليم رسالة النشاط التجاري وتكون تلك الرسالة جزءًا من المحادثة التي بدأها النشاط التجاري:

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "delivered",
    "timestamp": "TIMESTAMP",
    "type": "message",
    "conversation": {
      "id": "CONVERSATION_ID",
      "origin": {
         "type": "business_initiated"
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "business_initiated"
    }
  }]
}

يتم تلقي حدث webhook التالي عند تسليم رسالة النشاط التجاري وتكون تلك الرسالة جزءًا من المحادثة التي بدأها المستخدم التي تم إنشاؤها من نقطة إدخال مجانية:

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "delivered",
    "timestamp": "TIMESTAMP",
    "type": "message",  
    "conversation": {
      "id": "CONVERSATION_ID",
      "origin": {
         "type": "referral_conversion",
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": false,
      "category": "referral_conversion"
    }
  }]
}

الحالة: تمت قراءة الرسالة

الاستدعاء القياسي لرسالة تمت قراءتها:

{
  "statuses":[{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "read",
    "timestamp": "TIMESTAMP",
    "type": "message"
  }]
}

الحالة: فشل إرسال الرسالة

رمز الخطأ 470

{
  "statuses": [{
    "errors": [{
      "code": 470,
      "title": "Failed to send message because you are outside the support window for freeform messages to this user. Please use a valid HSM notification or reconsider." 
    }],
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "failed",
    "timestamp": "TIMESTAMP"
  }]
}

رمز الخطأ 480

{
  "statuses": [{
      "errors": [{
          "code": 480,
          "title": "Failed to send message since we detect an identity change of the contact"
      }],
      "id": "ID",
      "recipient_id": "WHATSAPP_ID",
      "status": "failed",
      "timestamp": "TIMESTAMP"
   }]
}

لا يتم تضمين قسم المحادثة الفرعي في الاستدعاء، إذا فشل إرسال الرسالة. ولا يتم تضمين تنشيط الفوترة أو المحادثة في هذه الحالة.

الحالة: تم حذف الرسالة

الاستدعاء القياسي لرسالة تم حذفها:

{
  "statuses": [{
        "id": "ID",
        "recipient_id": "WHATSAPP_ID",
        "status": "deleted",
        "timestamp": "TIMESTAMP",
        "type": "message"
    }]
}

لا يتم تضمين قسم المحادثة الفرعي في الاستدعاء، إذا تم حذف الرسالة. ولا يتم تضمين تنشيط الفوترة أو المحادثة في هذه الحالة.

كل حالات الرسائل الممكنة

لمعرفة هذه المعلومات، راجع نظرة عامة، الرسائل.

الأسئلة المتكررة