On WhatsApp message status event

onWhatsAppMessageStatusEvent receives sent, delivered, read, failed, and played updates for the connected WhatsApp Business phone number. Use it when one automation needs multiple delivery outcomes; use a semantic status trigger when you need one outcome.

automations/watch-whatsapp-delivery.automation.ts

import { automation } from "automate.ax"
import { onWhatsAppMessageStatusEvent } from "automate.ax/whatsapp"

export default automation("Watch WhatsApp delivery", () => {
  const status = onWhatsAppMessageStatusEvent()

  status.messageId
  status.status
  status.errors
})

It accepts optional static account. The signal includes message and recipient IDs, status, timestamp, callback data, conversation origin and expiry, pricing classification, structured Meta errors, and providerEvent. Status updates are deduplicated by message ID, status, and provider timestamp. A sent response is not proof of delivery; use delivered, read, or failed for downstream handling.

⌘I

Get started

Concepts

Reference

On WhatsApp message status event