WhatsApp Status
Status for Outbound Messages
When sending outbound messages, the following represents a common sequence of status values:
| Status | Description |
|---|---|
| QUEUE | Messangi has received your request to create the message. Indicates that the message has been scheduled for sending but has not yet been sent out. This status means the message is waiting in line to be processed and delivered to the recipient. It's essentially in a holding pattern, queued up in our system until it can be dispatched. |
| DEQUEUED | Messangi Indicates that the message has been removed from the queue and is now being processed for sending. This transition occurs after the message was previously in a waiting state (queued) and is now actively being sent to META. |
| CODE_NOT_ALLOWED | Messangi suggests that the WhatsApp Business Account (WABA) used is either not activated on the platform or lacks the capability to message the recipient. Additionally, it could be because the owner does not have a WABA assigned , which is required to send the message. Contact our support team to verify the WABA. |
| INCOMPLETE | Messangi indicates that a personalized WhatsApp message was sent without the necessary placeholder data filled in. Please note, personalized messages are those that feature dynamic fields—like "Name", "Phone Number", "Last Name", and similar—which need to be populated before sending. |
| BLACKLISTED | Messangi indicates that the intended recipient's phone number is on a blacklist, preventing any messages from being sent to that number. When a number is blacklisted, it is essentially blocked from receiving any further communications from the sender's number or campaign, ensuring that no messages are delivered to that recipient. |
| QUOTA_EXCEEDED | The WhatsApp Business Account (WABA) has surpassed the allowed limit for sending messages within a specified period, as defined by WhatsApp's messaging policies or limits. |
| SENT | Indicates that the message has been successfully dispatched from our system and is en route to META. This status means that the message is on its way to the recipient but does not confirm that the message has been delivered to the end user. It signifies a successful handoff to the next stage in the message delivery process. NOTE: A message may remain in the “SENT” status despite being delivered. This is often because the recipient has disabled “Read receipts” in their WhatsApp settings (commonly known as the “blue double check”).In some instances, a message might stay in the “SENT” status without being delivered. Possible reasons for this are:1. Recipient Device Connectivity: Ensure that the recipient’s device is connected to the internet. If the device is offline, powered off, or in an area with no coverage, the message will stay in the “SENT” status until it can be delivered or eventually discarded. Additionally, check that the recipient’s phone number is registered and active on WhatsApp. 2. Restrictions on the Recipient (Blocking or Privacy Settings): If the recipient has blocked the sender’s number, the message may not be delivered, even if it shows as “SENT.” Privacy settings on the recipient’s device may also impact message delivery. The message might also not be delivered if the recipient hasn’t accepted WhatsApp’s latest Terms of Service and Privacy Policy or if they are using an outdated version of WhatsApp. WhatsApp recommends the following minimum versions: • Android: 2.21.15.15 • SMBA: 2.21.15.15 • iOS: 2.21.170.4 • SMBI: 2.21.170.4 • KaiOS: 2.2130.10 • Web: 2.2132.6 3. Restrictions for Authentication Templates: Authentication templates have security measures for linked devices, so authentication messages are sent only to the user’s main WhatsApp device. For instance, if a user is on WhatsApp Web, OTP (One-Time Password) messages won’t appear there and will only be visible on their main mobile app. WhatsApp tries to deliver these messages within their valid period, with a maximum retry time of 10 minutes. If delivery fails within this time, WhatsApp stops retrying, and the message may remain in the “SENT” status. |
Status for Completed Messages
Once the message is sent, three potential final statuses can be achieved:
| Status | Description |
|---|---|
| DELIVRD | Messangi has received confirmation of message delivery from META. The message has successfully reached the recipient's device. This status confirms that the message not only was sent and processed by META but also was received by the intended recipient's WhatsApp application, ensuring that the communication was successfully completed. |
| READ | Indicates that the recipient has opened and seen the message. |
| FAILED | Indicates that META could not deliver the message to the recipient's device. Possible Reasons for WhatsApp "FAILED" status: - Network issues: This could include an unstable internet connection on the sender's or recipient's end, or issues with the WhatsApp servers. - Incorrect phone number: If the recipient's phone number is incorrect or not registered on WhatsApp, the message will fail to send. - Blocked contact: If the recipient has blocked the sender's number, the message will not be delivered. - Content restrictions: WhatsApp has restrictions on the type of content that can be sent through the platform. If a message contains content that violates these restrictions, it will be blocked.- 24-hour rule: If a user hasn't interacted with a business in the past 24 hours, non template messages from that business will be marked as spam and won't be delivered. |
Updated 6 days ago