Listar chats da instância

Amb. de Produção

https://api.way-api.io

GET

/instances/{instanceId}/chats

Última modificação:2026-09-17 22:00:23

Retorna uma lista de contatos e grupos visíveis para a conta conectada.

A instância precisa estar conectada. Use o campo id de qualquer item como targetId para enviar
uma mensagem sem precisar montar manualmente um identificador do WhatsApp.

Requisição

Authorization

Adicionar parâmetro em header

x-api-key

Exemplo:

x-api-key: ********************

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200OK

application/json

Lista de contatos e grupos visíveis para a instância conectada.

Bodyapplication/json

🟠400Requisição Inválida

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

🟠422Erro de Parâmetro

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.way-api.io/instances//chats' \
--header 'x-api-key: <api-key>'

Response Example

200 - Lista de chats

[
    {
        "id": "5511999999999@s.whatsapp.net",
        "name": "Maria Silva",
        "isGroup": false
    },
    {
        "id": "120363123456789@g.us",
        "name": "Grupo Comercial",
        "isGroup": true,
        "participants": 12,
        "description": "Equipe comercial",
        "isAdmin": true
    }
]

Modificado em 2026-09-17 22:00:23