Pular para o conteúdo principal
Use estes endpoints para criar e administrar grupos do WhatsApp pelo canal ligado ao seu ApiID: listar grupos e participantes, adicionar ou remover pessoas, promover administradores, alterar título, descrição e foto, e obter ou revogar o link de convite. Para enviar mensagens a um grupo, veja Mensagens em Grupo. Todas as rotas usam POST em https://{BaseUrl}/v2/api/external/{ApiID}/<rota>, com o cabeçalho Authorization: Bearer {BearerToken}. O campo whatsappId é o ID do canal, e cada grupo é identificado pelo ID no formato 12345678901@g.us.
Link de convite: getInviteLink e revokeInviteLink exigem que o número conectado seja administrador do grupo e funcionam nos canais por QR Code (Baileys e Zapo). A resposta de getInviteLink traz groupId, inviteCode e inviteLink; quando não há código, vem também reason (not_admin, group_not_found, timeout, channel_not_supported ou unknown). Ao revogar, o link anterior para de funcionar na hora. Sair do grupo: group/leave funciona só no canal WABA oficial; nos demais tipos retorna ERR_LEAVE_GROUP_WABA_ONLY.

Respostas

As rotas respondem com success: true e o resultado em data:

Resultado das rotas de participantes

/group/addParticipant, /group/removeParticipant, /group/promote e /group/demote exigem que o número conectado seja administrador do grupo. Em addParticipant a exigência vale em geral: a exceção é o grupo que permite a qualquer membro adicionar pessoas. A resposta traz um item por grupo em data, no formato { groupId, status, message?, reason?, providerStatus?, participants? } (os campos com ? só aparecem quando se aplicam): Em cada número de participants, status é success, error ou unknown, e reason explica a recusa: Se todos os números forem recusados, o grupo vem com status: "error", message: "ERR_GROUP_PARTICIPANTS_REJECTED" e reason: "participants_rejected". Nos canais por QR Code, confira o status de cada número em participants para saber quem foi processado. Nas demais falhas, o reason do grupo é um destes: