Keeping track of the delivery status for outgoing WhatsApp messages is crucial for effective communication and customer engagement. Rocket.Chat WhatsApp apps provide a convenient way to receive real-time updates on the status of your messages.
To start receiving these updates, go to the WhatsApp app and follow these steps:
Navigate to the Settings tab and set the Message Status Endpoint URL.
Enable Allow Quote Messages settings.
Click Save Changes.
The app sends a request with the status payload to the specified URL each time your message's status changes, such as when it is sent, delivered, or read.
Always confirm that the "Allow Quote Messages" setting is enabled to receive the full information payload.
The table below highlights the payload format you will receive on the endpoint for status update:
Field Name | Type | Description |
---|---|---|
msId | string or undefined | The message Id. |
mobileNo | string | The recipient’s WhatsApp phone number. |
MessageStatus | string | Status of the message - sent, delivered, read |
timestamp | string | Timestamp of request |
ErrorDetails | Optional Type: String or WhatsApp error format | Errors from template messages will be shown here |
type | string | The type of message. It can either be a template message or a regular message. |
connectedWhatsAppNo | string | Your connected WhatsApp Number from which you had sent the message to the user |
message | string | The outgoing message |
You can choose to filter the message status updates you receive at the Message Status Endpoint URL based on the message type. Go to Filter Message Status settings and select from the following options:
All: Receive the status of all messages
Regular Messages: Receive the status of regular messages only
Template Messages: Receive the status of template messages only
By utilizing this functionality, you can gain valuable insights into the delivery and engagement of your WhatsApp communications, helping you optimize your messaging strategies and provide better customer experiences.