Skip to main content

Last Seen

Method#

/privacy/last-seen#

POST https://api.z-api.io/instances/{{instanceId}}/token/{{instanceToken}}/privacy/last-seen

Header#

KeyValue
Client-TokenACCOUNT SECURITY TOKEN

Concept#

Through this method, it is possible to configure who can see your "last seen" status.


Attributes#

Required#

AttributesTypeDescription
visualizationTypestringVisibility scope (ALL, NONE, CONTACTS, CONTACT_BLACKLIST)

String (visualizationType)

Visibility scope. Accepted values:

  • ALL (Everyone can see)
  • NONE (No one can see)
  • CONTACTS (Only my contacts)
  • CONTACT_BLACKLIST (Only my contacts, except...)

Optional#

AttributesTypeDescription
contactsBlacklistarray objectContacts to be added or removed from the blacklist. Should be sent when "visualizationType" is "CONTACT_BLACKLIST"

Array Object (contactsBlacklist)

AttributesTypeDescription
actionstringAction to be taken for the contact; add or remove from the blacklist (add, remove)
phonestringContact's phone number

Request Body#

Method

POST https://api.z-api.io/instances/YOUR_INSTANCE/token/YOUR_TOKEN/privacy/last-seen

Example

{
"visualizationType": "ALL"
}
{
"visualizationType": "CONTACT_BLACKLIST",
"contactsBlacklist": [
{ "action": "add", "phone": "554411111111" },
{ "action": "remove", "phone": "554422222222" }
]
}
Important

It is essential to highlight that the blacklist (list of disallowed contacts) is different for each privacy configuration, meaning that the blacklist for "last seen" is not the same as that for "profile photo," and so on for all configurations that accept the blacklist.

Tip

You do not need to resend the "contactsBlacklist" attribute with contacts already added. This parameter is only for changes in the blacklist.


Response#

200#

AttributesTypeDescription
successbooleantrue if successful, false in case of failure

Example

{
"success": true
}

405#

In this case, ensure that you are sending the method specification correctly, i.e., check if you sent the POST or PUT as specified at the beginning of this topic.

415#

If you receive a 415 error, make sure to add the "Content-Type" of the object you are sending in the request headers, in most cases, it should be "application/json".


Code#