atendroZAP Documentação
DocsGrupos
Markdown
POST/group/updateImage

Alterar imagem do grupo

JPEG/PNG/GIF até 8 MiB; corpo JSON até 12 MiB; convertido em JPEG até 640×640. remove/delete removem a foto.

Autenticação

Header obrigatório: token. Use o token da instância.

Base URL: a API do servidor selecionado, como https://1.atendro.cloud. O domínio wpp.atendro.cloud hospeda a documentação e o console.

Idempotência: suporta Idempotency-Key, com retenção de 24 horas. Preserve a mesma chave, método, caminho e bytes do corpo ao repetir. Entenda a idempotência.

Headers adicionais

CampoTipoPresençaDescrição
X-Request-IdstringopcionalASCII visível sem espaços, 1–128 caracteres. Inválido/ausente é substituído por UUID. Ecoado na resposta. Comprimento máximo: 128
Idempotency-KeystringopcionalASCII visível sem espaços, 1–128. Repetir método, caminho e os mesmos bytes do JSON. 409 em andamento; 422 se mudar a requisição. 504 é guardado e não deve causar reenvio automático. Comprimento mínimo: 1. Comprimento máximo: 128

Corpo da requisição

Formato: application/json. Corpo obrigatório.

CampoTipoPresençaDescrição
groupjidstringobrigatórioIdentificador do grupo terminado em @g.us. Comprimento mínimo: 1
imagestringobrigatórioData URI/base64/URL permitida (JPEG, PNG, GIF; até 8 MiB), ou remove/delete. Convertida para JPEG até 640×640. Comprimento mínimo: 1

Respostas

Alterar imagem do grupo

CampoTipoPresençaDescrição
responsestringobrigatório—
needs_refreshbooleanobrigatórioValores: true
pictureIdstringopcionalPresente na atualização de imagem.