Status Webhooks

You send a message
      ↓
sent       — Meta accepted it and queued it for delivery
      ↓
delivered  — reached the customer's phone (grey double tick ✓✓)
      ↓
read       — customer opened it (blue double tick ✓✓)

If something goes wrong:
failed     — could not be delivered

{
  "object": "whatsapp_business_account",
  "entry": [{ "changes": [{ "value": {
    "statuses": [{
      "id": "wamid.HBgM...",
      "status": "delivered",
      "timestamp": "1717000000",
      "recipient_id": "919959623255"
    }]
  }}]}]
}

{
  "status": "failed",
  "errors": [{ "code": 131026, "title": "Message Undeliverable" }]
}

if (changes?.statuses) {
  const s  = changes.statuses[0];
  const to = s.recipient_id;

  if (s.status === 'sent')      console.log(`[STATUS] sent      → ${to}`);
  if (s.status === 'delivered') console.log(`[STATUS] delivered → ${to}`);
  if (s.status === 'read')      console.log(`[STATUS] read      → ${to}`);
  if (s.status === 'failed')    console.log(`[STATUS] FAILED    → ${to} | ${s.errors?.[0]?.code}`);
  return;
}