Pular para o conteúdo principal

Pegar chats

Método#

/chats#

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

Header#

KeyValue
Client-TokenTOKEN DE SEGURANÇA DA CONTA

Conceituação#

Este método é reponsavel por retornar todos os chats.


Atributos#

Obrigatórios#

AtributosTipoDescrição
pageintegerUtilizado para paginação você de informar aqui a pagina de chats que quer buscar
pageSizeintegerEspecifica o tamanho do retorno de chats por pagina

Opcionais#

AtributosTipoDescrição

Request Params#

URL exemplo#

Método

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


Response#

200#

AtributosTipoDescrição
archivedbooleantrue ou false indica se o chat está arquivado
pinnedbooleantrue ou false indica se o chat está fixado
phonestringPhone do contato
unreadstringindica o numero de mensagens não lidas em um chat
namestringNome atribudo ao chat, lembrando que se for um grupo ou lista de transmissão deve retorar os respectivos IDs
lastMessageTimestringTimestamp com a data e hora da última interação com o chat
muteEndTimestringTimestamp com a data e hora que a notificação vai ser reativada (-1 é para sempre)
isMutedstring0 ou 1 indica se você silênciou ou não este chat
isMarkedSpambooleantrue ou false indica se você marcou este chat como spam
messagesUnreadintegerdescontinuado

Exemplo

[
{
"archived": "false",
"pinned": "true",
"messagesUnread": 0,
"phone": "5511999999999",
"unread": "0",
"name": "Z-API SUPORTE",
"lastMessageTime": "1622991687",
"isMuted": "0",
"isMarkedSpam": "false"
},
{
"archived": "false",
"pinned": "true",
"messagesUnread": 0,
"phone": "5511999999999",
"unread": "0",
"name": "Z-api - Team",
"lastMessageTime": "1622990503",
"muteEndTime": 1655953774000,
"isMuted": "0",
"isMarkedSpam": "false"
}
]

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#