Skip to main content

​
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"
    ]
  }'

​
Resposta

{
  "success": true,
  "data": {
    "id": "[email protected]",
    "subject": "Equipe de Vendas",
    "owner": "[email protected]",
    "creation": 1705233000,
    "participants": [
      {
        "id": "[email protected]",
        "isAdmin": false
      },
      {
        "id": "[email protected]",
        "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"

​
Obter Informações do Grupo

Detalhes completos de um grupo específico. 
curl -X GET "https://api.wapizap.com/api/v2/groups/[email protected]?instanceId=sua-instancia" \
  -H "Authorization: Bearer SEU_TOKEN"

​
Atualizar Grupo

​
Alterar Nome do Grupo

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

​
Alterar Descrição

curl -X PATCH "https://api.wapizap.com/api/v2/groups/[email protected]" \
  -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/[email protected]/participants" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "action": "add",
    "participants": ["5511777777777"]
  }'

​
Remover Participantes

curl -X POST "https://api.wapizap.com/api/v2/groups/[email protected]/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/[email protected]/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/[email protected]/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/[email protected]/settings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "announce": true
  }'

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

curl -X PATCH "https://api.wapizap.com/api/v2/groups/[email protected]/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/[email protected]/settings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -d '{
    "instanceId": "sua-instancia",
    "ephemeral": 86400
  }'
Valor ephemeralDuração
0Desativado
8640024 horas
6048007 dias
777600090 dias
curl -X GET "https://api.wapizap.com/api/v2/groups/[email protected]/invite-info?instanceId=sua-instancia" \
  -H "Authorization: Bearer SEU_TOKEN"

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/[email protected]?instanceId=sua-instancia" \
  -H "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": "[email protected]",
    "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: [email protected]).

​
Próximos Passos

Enviar Mensagens

Envie diferentes tipos de mensagens

Configurar Webhooks

Receba notificações de eventos do grupo