Skip to main content

Read texts

Method#

/read-message#

POST https://api.z-api.io/instances/YOUR_INSTANCE/token/YOUR_TOKEN/read-message

Header#

KeyValue
Client-TokenACCOUNT SECURITY TOKEN

Concept#

Method used to mark a text message as read

image


Attributes#

Required#

AttributesTypeDescription
phonestringRecipient (or group ID in case you want to send it to a group) telephone number in the format DDI DDD NUMERS Ex: 551199999999. IMPORTANT only send numbers without formatting or a mask
messageIdstringOriginal messages id, in case the message was sent by you it is the code that comes in the response. In case it is a message sent by a contact you will receive this messageID through your webhook’s receive.

Optionals#

AttributesTypeDescription

Request Body#

{
"phone": "5511999998888",
"messageId": "3999984263738042930CD6ECDE9VDWSA"
}

Response#

204#

No content

AttributesTypeDescription

Example

{}

405#

In this case certify that you are sending the correct specification of the method. This means, verify if you sent a POST or GET as specified at the beginning of this topic.

415#

In case you receive 415 error, make sure to add the “Content-Type” of the object you are sending in the request headers, mostly “application/json”


Webhook Response#

Link for webhooks response (upon receiving)

Webhook


Code#