Mark a message as read
Show a customer that you read their WhatsApp message, and optionally that you are typing a reply.
POST
/v1/messaging/messages/{messageId}/readThe customer sees blue ticks on their message. With typing_indicator, they also see that you are typing, until you send your next message or for up to 25 seconds.
Authorization
Bearer token
- Authorizationrequiredheader
Send your API key as
Bearer YOUR_API_KEY.
Path parameters
messageIdrequiredstringID of a message a customer sent you, starting with
msg_.
Body parameters
application/json
typing_indicatoroptionalbooleanAlso show the customer that you are typing. Default
false.
The body can be left out.
Response
application/json200 OK
Example identifiers below are illustrative.
Errors
| Status | code | Returned when |
|---|---|---|
400 | none | The body has an unknown field, or typing_indicator isn't a boolean. |
401 | none | The API key is missing, malformed, revoked, or expired. |
403 | none | The key lacks the whatsapp.send permission. |
403 | FEATURE_NOT_AVAILABLE | WhatsApp is not turned on for your organization. |
404 | message_not_found | No received message with this ID exists in the key's project, or it was deleted after 30 days. |
422 | whatsapp_mark_read_failed | WhatsApp refused to mark the message as read; message includes WhatsApp's reason when it gave one. |
422 | whatsapp_provider_unavailable | WhatsApp couldn't be reached. Try again in a few minutes. |