Skip to main content
POST
Gerencia participantes de um grupo através de múltiplas ações: adicionar, remover, promover a admin, rebaixar, aprovar ou rejeitar solicitações.

Ações Disponíveis

Inclui novos membros ao grupo.Ação: add
  • Adiciona números à lista de participantes
  • Participantes recebem notificação de entrada
  • Podem começar a interagir imediatamente
  • Limite de participantes depende do WhatsApp (até 1024)
  • Alguns números podem falhar se bloquearam você
Comportamento:
  • Retorna lista de sucessos e falhas
  • Não bloqueia operação se alguns falharem
  • Participantes já no grupo são ignorados
Remove membros do grupo.Ação: remove
  • Remove participantes da lista
  • Membro perde acesso ao grupo
  • Não pode mais ver mensagens novas
  • Pode retornar se receber novo convite
  • Requer permissão de administrador
Atenção:
  • Não é possível remover o criador do grupo
  • Outros admins podem ou não ser removíveis
  • Remoção é permanente até novo convite
Concede privilégios administrativos a participantes.Ação: promote
  • Transforma membro em administrador
  • Admin pode gerenciar participantes
  • Pode alterar configurações do grupo
  • Pode enviar mensagens mesmo com announce ativo
  • Pode editar info mesmo com restrict ativo
Poderes do Admin:
  • Adicionar/remover participantes
  • Promover/rebaixar outros membros
  • Alterar nome, descrição, imagem
  • Configurar permissões do grupo
Remove privilégios administrativos.Ação: demote
  • Remove status de administrador
  • Membro volta a ser participante comum
  • Perde permissões de gestão
  • Mantém acesso ao grupo normalmente
  • Apenas admins podem rebaixar
Restrições:
  • Criador do grupo não pode ser rebaixado
  • Você não pode rebaixar a si mesmo
  • Mantenha pelo menos um administrador
Aceita pedidos de entrada em grupos com aprovação.Ação: approve
  • Válido para grupos com memberAddMode: admin_approval
  • Aprova participantes aguardando entrada
  • Membro entra imediatamente no grupo
  • Recebe notificação de aprovação
  • Lista de pendentes visível em /groups/info
Útil para grupos privados e seletivos.
Nega pedidos de entrada no grupo.Ação: reject
  • Rejeita solicitações pendentes
  • Participante não entra no grupo
  • Pode solicitar novamente depois
  • Remove da lista de pendentes
  • Não notifica sobre rejeição
Use para manter controle de acesso ao grupo.

Authorization

string
required
Chave de autenticação da sua conexão, utilizada no header Authorization como Bearer Token.
Você encontra sua API Key no botão API da sua conexão no painel ZapClass.
A chave sempre começa com o prefixo zc_.
Exemplo: zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP

Body Parameters

string
required
Identificador único do grupo (JID).
Formato: número@g.us
Exemplo: 120363308883996631@g.us
string
required
Ação a executar nos participantes.
Valores: add, remove, promote, demote, approve, reject
Exemplo: "promote"
array
required
Lista de números ou JIDs dos participantes.
Formato internacional sem + ou espaços.
Exemplo: ["5511999999999", "5511888888888"]
Formato de números: Use apenas dígitos no formato internacional (código do país + DDD + número). Exemplo: 5511999999999 para Brasil.