Skip to main content
POST
Atualiza a foto de perfil de um grupo do WhatsApp através de URL ou base64, ou remove a imagem atual do grupo.

Gerenciamento de Imagem

Opções para fornecer a imagem do grupo.URL da imagem:
  • Link direto para arquivo JPEG acessível
  • Servidor deve permitir acesso público
  • URL deve retornar a imagem diretamente
  • Exemplo: https://example.com/group-image.jpg
Base64:
  • String codificada em base64 da imagem
  • Com ou sem prefixo data:image/jpeg;base64,
  • Ideal para imagens geradas dinamicamente
  • Não requer hospedagem externa
Remover imagem:
  • Use "remove" ou "delete" como valor
  • Remove a foto atual do grupo
  • Grupo fica sem imagem de perfil
Especificações obrigatórias da imagem.Formato:
  • Apenas JPEG é aceito pelo WhatsApp
  • PNG, GIF, WebP não são suportados
  • Converta para JPEG antes de enviar
Resolução:
  • Máximo: 640x640 pixels
  • Recomendado: formato quadrado
  • Imagens maiores serão rejeitadas
  • WhatsApp redimensiona automaticamente se necessário
Tamanho:
  • Mantenha arquivo otimizado
  • Imagens muito grandes causam erro 413
  • Recomendado: menos de 100KB
Requisitos para alterar a imagem do grupo.Você precisa ser:
  • Membro ativo do grupo
  • Administrador do grupo
  • Conectado a uma instância válida
Configuração “restrict”:
  • Se restrict: true, apenas admins podem alterar
  • Se restrict: false, pode depender de configurações
  • Esta API sempre requer permissão de admin
Sem permissão de admin, retorna erro 403.
Situações para atualizar a imagem do grupo.Aplicações práticas:
  • Personalização da identidade visual
  • Atualização para campanhas ou eventos
  • Sincronização com logo da empresa
  • Remoção de imagens inadequadas
  • Automação de branding corporativo
  • Imagens temáticas sazonais
  • Geração dinâmica com IA ou design
  • Integração com sistemas de gestão

Authorization

string
required
Chave de autenticação da sua conexão, utilizada no header Authorization como Bearer Token.
Você encontra sua API Key no botão API da sua conexão no painel ZapClass.
A chave sempre começa com o prefixo zc_.
Exemplo: zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP

Body Parameters

string
required
Identificador único do grupo (JID).
Formato: número@g.us
Exemplo: 120363308883996631@g.us
string
required
URL, base64 ou comando de remoção.
URL: Link direto para imagem JPEG
Base64: String codificada da imagem
Remover: "remove" ou "delete"
Exemplo: "https://example.com/logo.jpg"
Restrições: A imagem deve ser JPEG com resolução máxima de 640x640 pixels. Outros formatos ou tamanhos maiores serão rejeitados pelo WhatsApp.