whatsapp.onMessageStatusEvent receives sent, delivered, read, failed, and played updates for the connected WhatsApp Business phone number. Use a specific status trigger when you need only one outcome.
automations/watch-whatsapp-delivery.automation.ts
account. Trigger data includes the message ID, status, timestamp, callback data, conversation origin and expiry, pricing classification, structured Meta errors, and providerEvent. recipientId is the recipient’s phone number or group ID, and recipientUserId is their business-scoped user ID (BSUID). Meta omits recipientId when it withholds a user’s phone number, so match users on recipientUserId when present. Pricing values are Meta’s strings, such as free_customer_service or free_group_customer_service; Meta adds values over time.
Meta can add fields and statuses without a new API version. Automate.ax skips a status it can’t read and still delivers the rest of Meta’s batch.
Automate.ax deduplicates status updates by message ID, status, and provider timestamp. A sent response isn’t proof of delivery. Use delivered, read, or failed for downstream handling.