Grupos

Crie e administre grupos de WhatsApp pela API: listar, ver participantes, adicionar/remover/promover membros, mudar assunto e descrição, gerar link de convite e sair. Os ids de grupo terminam em @g.us.

Sua API key (para testar aqui)

Gere uma chave em Painel → API Keys. A chave fica só no seu navegador (localStorage) e nunca aparece nos exemplos de código.

Listar grupos

messages:read

GET/v1/groups

Lista os grupos em que o número conectado participa.

Resposta 200

[
  {
    "id": "120363…@g.us",
    "subject": "Equipe",
    "size": 8,
    "announce": false,
    "restrict": false,
    "owner": "5511…@s.whatsapp.net"
  }
]

curl -X GET "https://api.mandapi.net/v1/groups" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE"

▶ Testar no sandbox

Detalhe do grupo

messages:read

GET/v1/groups/{id}

Metadados completos: participantes, admins, descrição, link de convite.

Campo	Tipo	Descrição
`id`obrigatório	string	Id do grupo (…@g.us).

Resposta 200

{
  "id": "120363…@g.us",
  "subject": "Equipe",
  "description": "Grupo do time",
  "owner": "5511…@s.whatsapp.net",
  "participants": [
    {
      "id": "5511…@s.whatsapp.net",
      "admin": "superadmin"
    }
  ]
}

curl -X GET "https://api.mandapi.net/v1/groups/665f0a1b2c3d4e5f6a7b8c9d" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE"

▶ Testar no sandbox

Criar grupo

messages:send

POST/v1/groups

Cria um grupo com um assunto e uma lista de participantes.

Campo	Tipo	Descrição
`subject`obrigatório	string	Nome do grupo.
`participants`obrigatório	string[]	Números dos participantes.

Resposta 200

{
  "id": "120363…@g.us",
  "subject": "Equipe de vendas"
}

curl -X POST "https://api.mandapi.net/v1/groups" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "subject": "Equipe de vendas",
  "participants": [
    "5511999998888",
    "5511888887777"
  ]
}'

Gerenciar participantes

messages:send

POST/v1/groups/{id}/participants

Adiciona, remove, promove ou rebaixa participantes.

Campo	Tipo	Descrição
`id`obrigatório	string	Id do grupo.
`action`obrigatório	string	add \| remove \| promote \| demote.
`participants`obrigatório	string[]	Números afetados.

Resposta 200

{
  "updated": [
    {
      "jid": "5511777776666@s.whatsapp.net",
      "status": "200"
    }
  ]
}

curl -X POST "https://api.mandapi.net/v1/groups/665f0a1b2c3d4e5f6a7b8c9d/participants" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "add",
  "participants": [
    "5511777776666"
  ]
}'

Alterar assunto

messages:send

PATCH/v1/groups/{id}/subject

Muda o nome (assunto) do grupo.

Campo	Tipo	Descrição
`id`obrigatório	string	Id do grupo.
`subject`obrigatório	string	Novo nome.

Resposta 200

{
  "id": "120363…@g.us",
  "subject": "Equipe de vendas 2026"
}

curl -X PATCH "https://api.mandapi.net/v1/groups/665f0a1b2c3d4e5f6a7b8c9d/subject" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "subject": "Equipe de vendas 2026"
}'

Alterar descrição

messages:send

PATCH/v1/groups/{id}/description

Muda a descrição do grupo.

Campo	Tipo	Descrição
`id`obrigatório	string	Id do grupo.
`description`obrigatório	string	Nova descrição.

Resposta 200

{
  "id": "120363…@g.us",
  "description": "Comunicados oficiais do time."
}

curl -X PATCH "https://api.mandapi.net/v1/groups/665f0a1b2c3d4e5f6a7b8c9d/description" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "Comunicados oficiais do time."
}'

Link de convite

messages:read

GET/v1/groups/{id}/invite

Retorna o código e o link de convite do grupo.

Campo	Tipo	Descrição
`id`obrigatório	string	Id do grupo.

Resposta 200

{
  "code": "AbCdEf…",
  "link": "https://chat.whatsapp.com/AbCdEf…"
}

curl -X GET "https://api.mandapi.net/v1/groups/665f0a1b2c3d4e5f6a7b8c9d/invite" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE"

▶ Testar no sandbox

Sair do grupo

messages:send

POST/v1/groups/{id}/leave

Faz o número conectado sair do grupo.

Campo	Tipo	Descrição
`id`obrigatório	string	Id do grupo.

Resposta 200

{
  "id": "120363…@g.us",
  "left": true
}

curl -X POST "https://api.mandapi.net/v1/groups/665f0a1b2c3d4e5f6a7b8c9d/leave" \
  -H "Authorization: Bearer mapi_live_SUA_CHAVE"