Pular para o conteúdo principal

Pegar metadata do Chat

Método#

/chat/{phone}#

GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/chats/{phone}

Header#

KeyValue
Client-TokenTOKEN DE SEGURANÇA DA CONTA

Conceituação#

Este método é reponsavel por retornar as informações do metadata de um chat.


Atributos#

Obrigatórios#

AtributosTipoDescrição
phonestringTelefone do destinatário no formato DDI DDD NÚMERO Ex: 551199999999. IMPORTANTE Envie somente números, sem formatação ou máscara

Opcionais#

AtributosTipoDescrição

Request Params#

URL exemplo#

Método

GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/chats/5511999999999

Response#

200#

AtributosTipoDescrição
phonestringPhone do contato
unreadstringindica o número de mensagens não lidas em um chat
lastMessageTimestringTimestamp com a data e hora da ultima ingeração com o chat
isMutedstring0 ou 1 indica se você silênciou ou não este chat
isMarkedSpambooleantrue ou false indica se você marcou este chat como spam
profileThumbnailstringURL da foto do chat o Whatsapp apaga após 48h
isGroupAnnouncementbooleantrue ou false indica se o chat é um grupo de avisos
isGroupbooleantrue ou false indica se o chat é um grupo
notesobject (Note)Anotações atribuidas ao chat (somente whatsapp business)
messagesUnreadintegerdescontinuado
aboutstringRecado do perfil

Object (Note)

AtributosTipoDescrição
idstringId da anotação
contentstringTexto da anotação
createdAtnumberTimestamp da criação da anotação
lastUpdateAtnumberTimestamp da ultima atualização da anotação

Exemplo

{
"phone": "5511999999999",
"unread": "0",
"lastMessageTime": "1619461666",
"isMuted": "0",
"isMarkedSpam": "false",
"profileThumbnail": "https://pps.whatsapp.net/v/t61.24694-24/170931400_212202650511993_3423338295209291992_n.jpg?ccb=11-4&oh=4b96b3bf7114122667f80d021b194f2c&oe=60C179E2",
"messagesUnread": 0,
"about": "Recado do perfil",
"isGroupAnnouncement": false,
"isGroup": false,
"notes": {
"id": "KlesU6f4f/Qd5d6VuAbvOMi31rg/F92owVe/xDYad1C=",
"content": "texto da anotação",
"createdAt": 1655953774000,
"lastUpdateAt": 1655953774000
}
}

405#

Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no inicio deste tópico.

415#

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json"


Code#