Buscar grupos
Método#
/groups#
GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/groups
Header#
| Key | Value |
|---|---|
| Client-Token | TOKEN DE SEGURANÇA DA CONTA |
Conceituação#
Este método é responsável por retornar todos os grupos.
Atributos#
Obrigatórios#
| Atributos | Tipo | Descrição |
|---|---|---|
| page | integer | Utilizado para paginação você de informar aqui a pagina de grupos que quer buscar |
| pageSize | integer | Especifica o tamanho do retorno de grupos por pagina |
Opcionais#
| Atributos | Tipo | Descrição |
|---|---|---|
Request Params#
URL exemplo#
Método
GET https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/groups?page=1&pageSize=10
Response#
200#
| Atributos | Tipo | Descrição |
|---|---|---|
| archived | boolean | true ou false indica se o chat está arquivado |
| pinned | boolean | true ou false indica se o chat está fixado |
| phone | string | Phone do contato |
| unread | string | indica o numero de mensagens não lidas em um chat |
| name | string | Nome atribudo ao chat, lembrando que se for um grupo ou lista de transmissão deve retorar os respectivos IDs |
| lastMessageTime | string | Timestamp com a data e hora da última interação com o chat |
| muteEndTime | string | Timestamp com a data e hora que a notificação vai ser reativada (-1 é para sempre) |
| isMuted | string | 0 ou 1 indica se você silênciou ou não este chat |
| isMarkedSpam | boolean | true ou false indica se você marcou este chat como spam |
| isGroup | boolean | true ou false indica se é um grupo ou não |
| messagesUnread | integer | descontinuado |
Exemplo
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"