Skip to main content

​
Para que serve

Grupos no WhatsApp são onde turmas, equipes e comunidades conversam junto. Com o Notifique você pode listar grupos, mandar aviso para o grupo inteiro, incluir ou tirar pessoas e mandar link de convite — tudo pela mesma conexão (número) que você já pareou para atendimento ou envios individuais, sem ficar repetindo cada passo no celular. Este conjunto de funções é tratado como experimental: pode mudar com o tempo e exige que o workspace aceite recursos de grupos nas configurações.

​
Por que isso importa

  • Menos trabalho manual — convites e avisos repetidos saem do sistema que você já usa (ERP, CRM, robô).
  • Um canal só — não é um produto separado do WhatsApp “normal”; é a mesma instância, com rotas extras para grupos.
  • Escala — dá para falar com vários grupos na mesma chamada em algumas operações (por exemplo participantes ou convite).
As regras do próprio WhatsApp continuam valendo: quem é admin, quem pode adicionar gente, etc. A API não substitui isso.

​
O que você pode fazer no painel

Ativar recursos experimentais de grupos no workspace (em geral em Configurações → Recursos experimentais) e marcar na chave de API a permissão de grupos (whatsapp:groups) só nas integrações que realmente precisarem.

​
O que você pode fazer por integração (API)

  • Enviar mensagem para grupo — mesma rota de envio do WhatsApp; o destino é o identificador do grupo (o tal do JID, no formato …@g.us), em vez do número da pessoa.
  • Ver grupos e quem está dentro — listagem paginada; participantes vêm em rota à parte.
  • Adicionar ou remover gente, mandar convite por link, cancelar link antigo e pegar o link atual — cada um com seu endereço na API.
A chave de API já está ligada a um workspace — não envie x-workspace-id na API v1. Os nomes exatos dos caminhos e corpos estão no OpenAPI do canal WhatsApp (seção de grupos).

​
O que precisa estar certo (senão a API recusa)

  1. Grupos (experimental) ligado no workspace.
  2. Chave com escopo whatsapp:groups.
  3. Instância do número conectada (ativa) e que de fato participe dos grupos que você quer mexer.
Se algo disso faltar, costuma vir 403, por exemplo com ideia de recurso desligado ou permissão em falta.

​
Próximos passos

​
Resumo em uma frase (para colar em outro lugar)

Grupos (experimental) no Notifique permitem avisar turmas e times no WhatsApp, gerenciar participantes e convites pela API, usando a mesma instância do número — com recurso ligado no workspace e permissão whatsapp:groups na chave.