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

Alterar participantes

add/remove/promote/demote. approve/reject retornam 400 invalid_action. Conferir Error por participante e atualizar o grupo.

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
actionstringobrigatórioValores: "add", "remove", "promote", "demote"
participantsarray<string>obrigatórioMínimo de itens: 1

Respostas

Alterar participantes

CampoTipoPresençaDescrição
groupUpdatedarray<object>obrigatório—
groupUpdated[].JIDstringobrigatório—
groupUpdated[].Errorintegerobrigatório—
needs_refreshbooleanobrigatórioValores: true