Skip to main content
POST
Gerencia os grupos vinculados a uma comunidade, permitindo adicionar novos grupos ou remover grupos existentes da estrutura comunitária.

Gestão de Grupos

Vincula grupos existentes à comunidade.Ação: add
  • Grupos devem existir previamente
  • Vincula grupos à estrutura da comunidade
  • Grupos aparecem listados na comunidade
  • Membros têm acesso ao grupo de anúncios
  • Permite organização hierárquica
Requisitos:
  • Você deve ser admin da comunidade
  • Grupos não podem estar em outra comunidade
  • Grupos devem ser válidos e acessíveis
  • Não adicionar grupos já vinculados
Desvincula grupos da comunidade.Ação: remove
  • Remove vínculo do grupo com a comunidade
  • Grupo continua existindo independentemente
  • Membros perdem acesso ao grupo de anúncios
  • Grupo pode ser vinculado a outra comunidade
  • Não exclui o grupo, apenas desvincula
Comportamento:
  • Grupo volta a ser independente
  • Mantém todos os participantes
  • Configurações do grupo preservadas
  • Pode ser re-adicionado depois
Gerenciamento de múltiplos grupos simultaneamente.Vantagens:
  • Adiciona/remove vários grupos de uma vez
  • Economiza tempo em operações grandes
  • Reduz número de requisições à API
  • Ideal para estruturas complexas
Exemplo de uso:
  • Vincular todos os grupos de departamentos
  • Reorganizar estrutura de comunidade
  • Migrar grupos entre comunidades
  • Configuração inicial de comunidade
Situações práticas para gerenciar grupos.Adicionar grupos:
  • Expansão da estrutura da comunidade
  • Novos departamentos ou áreas
  • Integração de grupos existentes
  • Organização de eventos com múltiplas salas
  • Estruturação de filiais regionais
Remover grupos:
  • Reorganização da comunidade
  • Grupos que não fazem mais sentido
  • Migração para outra comunidade
  • Desativação de departamentos
  • Limpeza de estrutura obsoleta

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 da comunidade (JID).
Formato: número@g.us
Exemplo: 120363153742561022@g.us
string
required
Tipo de operação a executar.
Valores: add (adicionar), remove (remover)
Exemplo: "add"
array
required
Lista de JIDs dos grupos a gerenciar.
Formato: ["grupo1@g.us", "grupo2@g.us"]
Exemplo: ["120363324255083289@g.us", "120363308883996631@g.us"]
Importante: Grupos já vinculados a outra comunidade não podem ser adicionados. Primeiro remova o grupo da comunidade anterior.