Referência/Webhooks/groups.update
Evento por instância

groups.update

Atualizacao parcial de metadados de grupo.

flag: groupsUpdated

Requisição

http
POST /webhooks/codechat HTTP/1.1
Content-Type: application/json
x-webhook-event: groups.update

Payload

json
{
"data": [
{
"partial": {
"announce": true,
"subject": "Novo nome do grupo",
"subjectTime": 1783188000
}
}
],
"event": "groups.update",
"instance": {
"connectionStatus": "online",
"externalAttributes": {},
"id": 1,
"name": "codechat",
"ownerJid": "[email protected]"
},
"timestamp": "2026-07-04T18:00:00Z"
}
partialGroupPartialWebhookData

obrigatório, não aceita `null`. Metadados parciais alterados no grupo.

partial.notifystring

opcional, não aceita `null`. Nome de notificacao do grupo quando informado.

partial.addressingModestring

opcional, não aceita `null`. Modo de enderecamento do grupo quando informado.

partial.ownerstring

opcional, não aceita `null`. JID do owner quando informado.

partial.ownerPnstring

opcional, não aceita `null`. Phone number do owner quando informado.

partial.ownerUsernamestring

opcional, não aceita `null`. Username do owner quando informado.

partial.ownerCountryCodestring

opcional, não aceita `null`. Codigo de pais do owner quando informado.

partial.subjectOwnerstring

opcional, não aceita `null`. JID de quem definiu o subject quando informado.

partial.subjectOwnerPnstring

opcional, não aceita `null`. Phone number de quem definiu o subject quando informado.

partial.subjectOwnerUsernamestring

opcional, não aceita `null`. Username de quem definiu o subject quando informado.

partial.subjectTimenumber

opcional, não aceita `null`. Timestamp Unix do subject quando informado.

partial.creationnumber

opcional, não aceita `null`. Timestamp Unix de criacao quando informado.

partial.descstring

opcional, não aceita `null`. Descricao do grupo quando informada.

partial.descOwnerstring

opcional, não aceita `null`. JID de quem definiu a descricao quando informado.

partial.descOwnerPnstring

opcional, não aceita `null`. Phone number de quem definiu a descricao quando informado.

partial.descOwnerUsernamestring

opcional, não aceita `null`. Username de quem definiu a descricao quando informado.

partial.descIdstring

opcional, não aceita `null`. ID da descricao quando informado.

partial.descTimenumber

opcional, não aceita `null`. Timestamp Unix da descricao quando informado.

partial.linkedParentstring

opcional, não aceita `null`. Grupo/comunidade pai quando informado.

partial.restrictboolean

opcional, não aceita `null`. Restricao de edicao quando informada.

partial.announceboolean

opcional, não aceita `null`. Modo anuncio quando informado.

partial.memberAddModeboolean

opcional, não aceita `null`. Modo de adicao por membros quando informado.

partial.joinApprovalModeboolean

opcional, não aceita `null`. Modo de aprovacao de entrada quando informado.

partial.isCommunityboolean

opcional, não aceita `null`. Indica comunidade quando informado.

partial.isCommunityAnnounceboolean

opcional, não aceita `null`. Indica grupo de anuncios da comunidade quando informado.

partial.sizenumber

opcional, não aceita `null`. Tamanho do grupo quando informado.

partial.ephemeralDurationnumber

opcional, não aceita `null`. Duracao de mensagens temporarias em segundos quando informada.

partial.inviteCodestring

opcional, não aceita `null`. Codigo de convite quando informado.

partial.authorstring

opcional, não aceita `null`. Autor da alteracao quando informado.

partial.authorPnstring

opcional, não aceita `null`. Phone number do autor quando informado.

partial.authorUsernamestring

opcional, não aceita `null`. Username do autor quando informado.

Observações de entrega

  • O handler atual envia array com um item contendo partial.
  • Implemente idempotência por chave de negócio e aceite a possibilidade de duplicidades e reordenação.