NODAPI

Grupos e Comunidades

Listar todos os grupos com filtros e paginacao

POST/group/list

Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.

Retorna uma lista com todos os grupos disponiveis para a conta do WhatsApp atualmente conectada, com opcoes de filtros e paginacao via corpo (POST). A rota GET continua para quem prefere a listagem direta sem paginacao.

Corpo da requisição (JSON)

CampoTipoDescrição
limitinteger

Quantidade maxima de resultados por pagina (padrao 50, maximo 1000)

Exemplo: 50

offsetinteger

Deslocamento base zero

Exemplo: 0

searchstring

Texto para filtrar grupos por nome/JID

forceboolean

Se definido como true, forca a atualizacao do cache de grupos. Util para garantir que as informacoes mais recentes sejam recuperadas.

Exemplo: false

noParticipantsboolean

Se definido como true, retorna a lista de grupos sem incluir os participantes. Util para otimizar a resposta quando nao ha necessidade dos dados dos participantes.

Exemplo: false

* obrigatório

Respostas

  • 200Lista de grupos recuperada com sucesso
  • 500Erro interno do servidor ao recuperar grupos

Experimente

Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.

Cole a chave gerada no painel.