การแจ้งเตือนสถานะและการกำหนดราคา

ไคลเอ็นต์ WhatsApp Business API จะส่งการแจ้งเตือนเกี่ยวกับ status ของข้อความระหว่างคุณและผู้ใช้ของคุณ การแจ้งเตือนเหล่านี้จะส่งผ่านอ็อบเจ็กต์ statuses

การอัพเดตสถานะ

การอัพเดตการกำหนดราคา

ตัวอย่าง

ในตัวอย่างต่อไปนี้ recipient_id อาจเป็นช่อง group_id แทน โดยขึ้นอยู่กับว่าข้อความถูกส่งไปยังบุคคลหรือกลุ่ม

สถานะ: ส่งข้อความแล้ว

ระบบจะได้รับ Webhook ดังต่อไปนี้เมื่อธุรกิจส่งข้อความโดยเป็นส่วนหนึ่งของการสนทนาที่เริ่มโดยผู้ใช้ (หากการสนทนานั้นไม่ได้เริ่มต้นจากจุดเข้าใช้งานฟรี)

{
   "statuses": [{
     "id": "ID",
     "recipient_id": "WHATSAPP_ID",
     "status": "sent",
     "timestamp": "TIMESTAMP",
     "type": "message",
     "message": {         
        "recipient_id":"WHATSAPP_ID"   
     },
     "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",
     "message": {   
       "media_id": "98d14c8e-0310-4061-8f99-2d148274c286",
       "recipient_id":"WHATSAPP_ID"  
     },
     "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",         
    "message": {
        "recipient_id":"WHATSAPP_ID" 
    },
    "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",
    "message": {
        "recipient_id":"WHATSAPP_ID"   
    },
    "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",
    "message": {
        "recipient_id":"WHATSAPP_ID" 
      },
    "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",
    "message": {
        "recipient_id": "WHATSAPP_ID" 
    },
    "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",  
    "message": {
        "recipient_id": "WHATSAPP_ID" 
    },
    "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",  
    "message": {
        "recipient_id": "WHATSAPP_ID" 
    }
  }]
}

สถานะ: ส่งข้อความไม่สำเร็จ

รหัสข้อผิดพลาด 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",
        "message": {
           "recipient_id": "WHATSAPP_ID" 
      }
    }]
}

ส่วนย่อยของการสนทนาจะไม่รวมอยู่ในการเรียกกลับหากข้อความถูกลบ โดยจะไม่มีการเรียกเก็บเงินหรือการเปิดใช้งานการสนทนาเข้ามาเกี่ยวข้องในกรณีนี้

สถานะข้อความที่เป็นไปได้ทั้งหมด

โปรดดูข้อมูลนี้ที่ภาพรวม, ข้อความ

คำถามที่พบบ่อย