Que operações existem para grupos?

O grupo tem rotas para criar e listar, consultar dados, gerenciar participantes, obter e redefinir convites e alterar configurações como nome, descrição, imagem, modo de anúncio, aprovação de entrada e bloqueio de edição. Para a lista geral, a chamada é GET /group/list; as outras operações são separadas por ação.

Rota O que faz
POST /group/create Cria um grupo com nome e, quando necessário, participantes.
GET /group/list Lista os grupos da instância.
POST /group/info Consulta dados de um grupo.
POST /group/updateParticipants Adiciona, remove, promove ou rebaixa participantes.
POST /group/inviteInfo Consulta informações do convite do grupo.
POST /group/resetInviteCode Redefine o código de convite.
POST /group/updateName, /group/updateDescription Atualiza nome ou descrição.
POST /group/updateAnnounce, /group/updateJoinApproval Ajusta anúncio e aprovação para entrada.
POST /group/updateLocked, /group/updateMemberAddMode Altera bloqueio e quem pode adicionar membros.

Exemplo de criação com os campos do handler:

POST /group/create
Content-Type: application/json

{"name":"Suporte","participants":["5511999999999"]}

Como as rotas de comunidade se organizam?

Comunidades têm um caminho próprio de criação e operações para relacionar grupos. POST /community/editgroups recebe a comunidade, o grupo filho e uma ação de vínculo ou desvínculo. POST /community/subgroups consulta os grupos associados à comunidade.

Rota O que faz
POST /community/create Cria uma comunidade. Usa o handler de criação de grupo com isCommunity: true.
POST /community/editgroups Vincula ou desvincula um grupo da comunidade.
POST /community/subgroups Lista os subgrupos de uma comunidade. 
POST /community/create
Content-Type: application/json

{"name":"Clientes","participants":[],"isCommunity":true}

O corpo demonstra os campos aceitos pelo handler compartilhado de criação. Para editar relações, use parent e child com os identificadores da comunidade e do grupo, além de action igual a link ou unlink.

O que posso fazer com canais?

As rotas de canais ficam sob /newsletter/*. O conjunto passa de trinta caminhos para criação, listagem, consulta e busca, assinatura e acompanhamento, mensagens, reações, administração e preferências. Para publicar uma mensagem, a rota é POST /newsletter/messages; há rotas distintas para edição, remoção e reação.

Rota O que faz
POST /newsletter/create Cria um canal com nome e descrição.
GET /newsletter/list, POST /newsletter/search Lista canais da instância ou busca canais.
POST /newsletter/subscribe, /newsletter/follow, /newsletter/unfollow Acompanha ou deixa de acompanhar um canal.
POST /newsletter/mute, /newsletter/unmute Silencia ou reativa notificações do canal.
POST /newsletter/messages Publica uma mensagem no canal.
POST /newsletter/messages/edit, /newsletter/messages/delete Edita ou remove uma mensagem publicada.
POST /newsletter/reaction Envia uma reação.
POST /newsletter/admin/invite, /newsletter/admin/accept, /newsletter/admin/remove Convida, aceita ou remove administradores.
POST /newsletter/owner/transfer Transfere a propriedade do canal.
POST /newsletter/settings, /newsletter/statuses Atualiza configurações ou consulta status do canal.

Exemplo de criação, com name obrigatório e description opcional:

POST /newsletter/create
Content-Type: application/json

{"name":"Novidades","description":"Atualizações do serviço"}

Como escolher a rota de status?

Há três destinos de publicação tratados por rotas diferentes. O status comum é voltado à lista de contatos da conta e aceita texto ou conteúdo de mídia. O status de grupo é destinado a um JID de grupo; o status de canal é enviado ao identificador do canal. Para remover um status publicado em grupo, há uma operação DELETE própria.

Rota O que faz
POST /send/status Publica status para contatos.
POST /send/group-status Publica status com destino de grupo.
DELETE /send/group-status Revoga status de grupo pelo destino e ID da mensagem.
POST /send/channel-status Publica status com destino de canal.

Exemplo de status para contatos:

POST /send/status
Content-Type: application/json

{"type":"text","text":"Aviso da semana"}

Para grupo e canal, o handler recebe chatid ou number como destino, além dos campos de conteúdo. Os exemplos mostram texto simples:

POST /send/group-status
Content-Type: application/json

{"chatid":"JID_DO_GRUPO","type":"text","text":"Aviso do grupo"}
POST /send/channel-status
Content-Type: application/json

{"chatid":"JID_DO_CANAL","type":"text","text":"Atualização do canal"}

O corpo do DELETE aceita destino e messageid; quando o status foi publicado para a comunidade vinculada, informe também o campo booleano correspondente. A resposta da API descreve a operação processada, sem equivaler a confirmação de leitura por cada destinatário.

Para uma comparação documental com outras APIs, veja o post Diferenciais da API GoZAP. Os formatos acima foram conferidos nos handlers e modelos da API; se uma operação não tiver corpo descrito no trecho de contrato, siga a referência correspondente antes de adaptar um cliente.

Como planejar a integração?

Separe as tarefas por destino: operações de administração de grupo, relações de comunidade, gestão do canal e publicação de status. Isso mantém claro qual identificador deve seguir em cada requisição e ajuda a separar erros de estrutura do recurso escolhido. Na autenticação, use as credenciais da instância conforme a referência da API.

As rotas não definem, por si, um compromisso de taxa comercial, disponibilidade ou entrega a um destinatário. Projete o cliente para interpretar as respostas, registrar erros e acompanhar eventos relevantes da sua aplicação. A existência de uma rota comprova que a operação está disponível no código, mas não substitui requisitos de operação, política de dados ou análise de risco.

Veja também o guia de risco de uso de API não oficial e o material de preços da API WhatsApp para avaliar modelo de conexão e orçamento.

Quando não escolher a GoZAP

Não escolha a GoZAP se sua política exige exclusivamente a plataforma oficial da Meta ou se sua equipe precisa instalar e operar o software em infraestrutura própria. A GoZAP conecta em dois modos nativos, Web e Mobile, ambos fora da API oficial da Meta. Veja o modo Mobile.

Se esses limites não atendem aos requisitos da sua organização, escolha uma solução compatível com a política interna.