Skip to main content

WhatsApp

Send WhatsApp Business messages and manage templates.

📄️Get WhatsApp message status

Returns the current delivery status of a WhatsApp Business message identified by its messageId. Use this endpoint to track the full lifecycle of a WhatsApp message after it has been sent, including whether the recipient has read it. The messageId is the identifier returned in the response when you originally sent the message through the WhatsApp send endpoint. Store this identifier on your side at send time so you can poll for status later. WhatsApp delivery statuses and their meanings: SENT - the message has been accepted by the platform and forwarded to the WhatsApp Business API infrastructure. At this point the message is in transit to the WhatsApp servers but has not yet been delivered to the recipient device. This corresponds to a single grey checkmark in the WhatsApp UI. DELIVERED - the WhatsApp servers confirmed that the message was delivered to the recipient device. This corresponds to double grey checkmarks in the WhatsApp UI. The recipient may not have opened the conversation yet. READ - the recipient has opened the conversation and viewed the message. This corresponds to double blue checkmarks in the WhatsApp UI. This status is unique to WhatsApp among the supported channels and provides valuable engagement insight. Note that recipients can disable read receipts in their WhatsApp privacy settings, in which case the status will remain at DELIVERED even after the message has been read. RECEIVED - the message was acknowledged by the WhatsApp system but final delivery to the handset is not yet confirmed. This is an intermediate state. ERROR - the message could not be delivered. Common causes include: the recipient phone number is not registered on WhatsApp, the WhatsApp Business account has been restricted or banned, the message template was rejected, the 24-hour customer service window has expired (for non-template messages), or the destination number is invalid. Check the response details for the specific error reason. EXPIRED - the message was not delivered within the allowed time window and was discarded. This can happen when the recipient device is offline for an extended period. UNKNOWN - no status information is available from WhatsApp, which may indicate the message is still being processed or that the status callback was not received. WhatsApp-specific considerations: WhatsApp enforces a 24-hour customer service window. Outside this window, you can only send pre-approved template messages. Sending a non-template message outside the window will result in an ERROR status. Also, WhatsApp has rate limits and quality ratings that can affect delivery. You can also query WhatsApp message status through the generic delivery status endpoint GET /partner-gateway/v1/messages/status/{customerMessageId}?channel=WHATSAPP for a unified cross-channel experience. Error responses: 401 is returned if the API key is missing or invalid. 404 is returned if the messageId does not exist or does not belong to the authenticated company.

Last updated on