Skip to main content

​
Por que este recurso importa

Grupos são onde comunidades, turmas e times conversam. Automatizar convite, entrada em massa e avisos poupa horas de trabalho manual no celular. A Notifique expõe isso como API sobre a mesma instância WhatsApp que você já usa para mensagens 1:1 — com escopos e flags específicos porque o recurso é experimental.

​
O que você encontra no painel

  • Recursos experimentais — ativar grupos no workspace (geralmente em Settings → Recursos experimentais), com aceite explícito.
  • API Keys — marcar o escopo whatsapp:groups nas chaves que podem listar grupos, mexer em participantes ou convites.
  • Mesma instância — o número que você pareou com QR é o “ator” dentro dos grupos; permissões do WhatsApp ainda valem (admin, quem pode adicionar pessoas, etc.).

​
O que você encontra na API

​
Enviar mensagem para grupo

Use a mesma rota de mensagens: POST /v1/whatsapp/messages com instanceId, type, payload e, em to, um ou mais JIDs de grupo (ex.: 120363295648424210@g.us) em vez de números. Suporta agendamento e Idempotency-Key.

​
Listar grupos e participantes

  • GET /v1/whatsapp/instances/{instanceId}/groups — listagem paginada com cache; se ainda estiver carregando, pode vir loading: true (tente de novo em instantes).
  • GET .../groups/{groupId}/participants — participantes não vêm na listagem geral; use esta rota.

​
Adicionar, remover e convites

  • Adicionar/remover participantes — uma requisição pode cobrir vários grupos (to = array de JIDs de grupo); a resposta traz data.results por grupo.
  • Enviar link de convite — body com groups e to (quem recebe o link no privado); opcional description.
  • Revogar link e obter URL/código do convite — rotas dedicadas por groupJid.

​
O que é JID

Identificador do grupo no formato 123456789@g.us. Você obtém os JIDs na listagem de grupos da instância e reutiliza em envio, add/remove e convites.

​
Requisitos (sem isso dá 403)

  1. Workspace com Recursos de grupos (experimental) ativados.
  2. API Key com escopo whatsapp:groups.
  3. instanceId pertencente ao workspace da chave (e permitido se a chave tiver restrição por instanceIds).
Códigos típicos: GROUP_FEATURES_DISABLED ou mensagem de escopo ausente.

​
Autenticação

  • Header: Authorization: Bearer sk_live_xxxxx ou x-api-key: sk_live_xxxxx

​
Próximos passos

  • Quick Start — exemplos: listar, enviar para grupo, participantes e convites
  • Introdução WhatsApp — visão geral do canal e webhooks message.*
  • OpenAPI WhatsApp — rotas de grupos na referência do canal