Gerenciando Grupos

Este guia mostra como criar e gerenciar grupos WhatsApp usando a Wapizap API.

Pré-requisitos

Instância conectada
API Key configurada
Permissões de administrador (para algumas operações)

Criar um Grupo

Crie um novo grupo com participantes iniciais.

curl -X POST https://api.wapizap.com/api/v2/groups \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "subject": "Equipe de Vendas",
    "participants": [
      "5511999999999",
      "5511888888888"
    ]
  }'

const response = await fetch('https://api.wapizap.com/api/v2/groups', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer SEU_TOKEN'
  },
  body: JSON.stringify({
    instanceId: 'sua-instancia',
    subject: 'Equipe de Vendas',
    participants: [
      '5511999999999',
      '5511888888888'
    ]
  })
});

const group = await response.json();
console.log('Grupo criado:', group.data.id);

import requests

response = requests.post(
    'https://api.wapizap.com/api/v2/groups',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer SEU_TOKEN'
    },
    json={
        'instanceId': 'sua-instancia',
        'subject': 'Equipe de Vendas',
        'participants': [
            '5511999999999',
            '5511888888888'
        ]
    }
)

group = response.json()
print('Grupo criado:', group['data']['id'])

Resposta

{
  "success": true,
  "data": {
    "id": "120363123456789012@g.us",
    "subject": "Equipe de Vendas",
    "owner": "5511777777777@s.whatsapp.net",
    "creation": 1705233000,
    "participants": [
      {
        "id": "5511999999999@s.whatsapp.net",
        "isAdmin": false
      },
      {
        "id": "5511888888888@s.whatsapp.net",
        "isAdmin": false
      }
    ]
  }
}

O ID do grupo sempre termina com @g.us. Guarde este ID para operações futuras.

Listar Grupos

Obtenha todos os grupos da instância.

curl -X GET "https://api.wapizap.com/api/v2/groups?instanceId=sua-instancia" \
  -H "Authorization: Bearer SEU_TOKEN"

const response = await fetch(
  'https://api.wapizap.com/api/v2/groups?instanceId=sua-instancia',
  {
    headers: {
      'Authorization': 'Bearer SEU_TOKEN'
    }
  }
);

const groups = await response.json();
console.log('Total de grupos:', groups.data.length);

Obter Informações do Grupo

Detalhes completos de um grupo específico.

curl -X GET "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us?instanceId=sua-instancia" \
  -H "Authorization: Bearer SEU_TOKEN"

const groupId = '120363123456789012@g.us';
const response = await fetch(
  `https://api.wapizap.com/api/v2/groups/${groupId}?instanceId=sua-instancia`,
  {
    headers: {
      'Authorization': 'Bearer SEU_TOKEN'
    }
  }
);

const group = await response.json();
console.log('Participantes:', group.data.participants.length);

Atualizar Grupo

Alterar Nome do Grupo

curl -X PATCH "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "subject": "Equipe de Vendas 2026"
  }'

const response = await fetch(
  'https://api.wapizap.com/api/v2/groups/120363123456789012@g.us',
  {
    method: 'PATCH',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer SEU_TOKEN'
    },
    body: JSON.stringify({
      instanceId: 'sua-instancia',
      subject: 'Equipe de Vendas 2026'
    })
  }
);

Alterar Descrição

curl -X PATCH "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "description": "Grupo oficial da equipe de vendas. Regras: respeito mútuo."
  }'

Gerenciar Participantes

Adicionar Participantes

curl -X POST "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/participants" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "action": "add",
    "participants": ["5511777777777"]
  }'

const response = await fetch(
  'https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/participants',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer SEU_TOKEN'
    },
    body: JSON.stringify({
      instanceId: 'sua-instancia',
      action: 'add',
      participants: ['5511777777777']
    })
  }
);

Remover Participantes

curl -X POST "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/participants" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "action": "remove",
    "participants": ["5511777777777"]
  }'

Promover a Administrador

curl -X POST "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/participants" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "action": "promote",
    "participants": ["5511999999999"]
  }'

Rebaixar de Administrador

curl -X POST "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/participants" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "action": "demote",
    "participants": ["5511999999999"]
  }'

Configurações do Grupo

Restringir Mensagens (Somente Admins)

curl -X PATCH "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/settings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "announce": true
  }'

// announce: true = somente admins podem enviar mensagens
// announce: false = todos podem enviar mensagens

const response = await fetch(
  'https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/settings',
  {
    method: 'PATCH',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer SEU_TOKEN'
    },
    body: JSON.stringify({
      instanceId: 'sua-instancia',
      announce: true
    })
  }
);

Restringir Edição de Info (Somente Admins)

curl -X PATCH "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/settings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "locked": true
  }'

Mensagens Temporárias

curl -X PATCH "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/settings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "ephemeral": 86400
  }'

Valor `ephemeral`	Duração
`0`	Desativado
`86400`	24 horas
`604800`	7 dias
`7776000`	90 dias

Link de Convite

Obter Link de Convite

curl -X GET "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/invite-info?instanceId=sua-instancia" \
  -H "Authorization: Bearer SEU_TOKEN"

const response = await fetch(
  'https://api.wapizap.com/api/v2/groups/120363123456789012@g.us/invite-info?instanceId=sua-instancia',
  {
    headers: {
      'Authorization': 'Bearer SEU_TOKEN'
    }
  }
);

const invite = await response.json();
console.log('Link:', invite.data.inviteUrl);
// https://chat.whatsapp.com/AbCdEfGhIjK

Entrar via Link de Convite

curl -X POST "https://api.wapizap.com/api/v2/groups/join" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "inviteCode": "AbCdEfGhIjK"
  }'

O inviteCode é apenas a parte final do link, não a URL completa.

Sair do Grupo

curl -X DELETE "https://api.wapizap.com/api/v2/groups/120363123456789012@g.us?instanceId=sua-instancia" \
  -H "Authorization: Bearer SEU_TOKEN"

const response = await fetch(
  'https://api.wapizap.com/api/v2/groups/120363123456789012@g.us?instanceId=sua-instancia',
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer SEU_TOKEN'
    }
  }
);

Essa ação é irreversível. Você só poderá voltar ao grupo se for convidado novamente.

Enviar Mensagem para o Grupo

Use o ID do grupo no campo to:

curl -X POST https://api.wapizap.com/api/v2/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "to": "120363123456789012@g.us",
    "type": "text",
    "text": "Olá equipe! Reunião às 15h."
  }'

Melhores Práticas

Permissões

Você precisa ser admin do grupo para adicionar/remover participantes e alterar configurações.

Rate Limits

Adicione no máximo 5 participantes por requisição para evitar bloqueios.

Validação

Valide os números antes de adicionar ao grupo usando /contacts/check.

ID do Grupo

Sempre use o ID completo com @g.us (ex: 120363123456789012@g.us).

Próximos Passos

Enviar Mensagens

Envie diferentes tipos de mensagens

Configurar Webhooks

Receba notificações de eventos do grupo

Comecar

Guias

Suporte

Gerenciando Grupos

Gerenciando Grupos

Pré-requisitos

Criar um Grupo

Resposta

Listar Grupos

Obter Informações do Grupo

Atualizar Grupo

Alterar Nome do Grupo

Alterar Descrição

Gerenciar Participantes

Adicionar Participantes

Remover Participantes

Promover a Administrador

Rebaixar de Administrador

Configurações do Grupo

Restringir Mensagens (Somente Admins)

Restringir Edição de Info (Somente Admins)

Mensagens Temporárias

Link de Convite

Obter Link de Convite

Entrar via Link de Convite

Sair do Grupo

Enviar Mensagem para o Grupo

Melhores Práticas

Permissões

Rate Limits

Validação

ID do Grupo

Próximos Passos

Enviar Mensagens

Configurar Webhooks

​Gerenciando Grupos

​Pré-requisitos

​Criar um Grupo

​Resposta

​Listar Grupos

​Obter Informações do Grupo

​Atualizar Grupo

​Alterar Nome do Grupo

​Alterar Descrição

​Gerenciar Participantes

​Adicionar Participantes

​Remover Participantes

​Promover a Administrador

​Rebaixar de Administrador

​Configurações do Grupo

​Restringir Mensagens (Somente Admins)

​Restringir Edição de Info (Somente Admins)

​Mensagens Temporárias

​Link de Convite

​Obter Link de Convite

​Entrar via Link de Convite

​Sair do Grupo

​Enviar Mensagem para o Grupo

​Melhores Práticas

Permissões

Rate Limits

Validação

ID do Grupo

​Próximos Passos

Enviar Mensagens

Configurar Webhooks

Gerenciando Grupos

Pré-requisitos

Criar um Grupo

Resposta

Listar Grupos

Obter Informações do Grupo

Atualizar Grupo

Alterar Nome do Grupo

Alterar Descrição

Gerenciar Participantes

Adicionar Participantes

Remover Participantes

Promover a Administrador

Rebaixar de Administrador

Configurações do Grupo

Restringir Mensagens (Somente Admins)

Restringir Edição de Info (Somente Admins)

Mensagens Temporárias

Link de Convite

Obter Link de Convite

Entrar via Link de Convite

Sair do Grupo

Enviar Mensagem para o Grupo

Melhores Práticas

Próximos Passos