Evento por instância

groups.upsert

Grupo criado, descoberto ou sincronizado.

flag: groupsUpsert

Requisição

http

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

Payload

json

{
  "data": [
    {
      "addressingMode": "pn",
      "creation": 1783187000,
      "id": "[email protected]",
      "isCommunity": false,
      "owner": "[email protected]",
      "participants": [
        {
          "admin": "admin",
          "id": "[email protected]",
          "isAdmin": true,
          "isSuperAdmin": false,
          "lid": "279847268053216@lid"
        }
      ],
      "subject": "Grupo"
    }
  ],
  "event": "groups.upsert",
  "instance": {
    "connectionStatus": "online",
    "externalAttributes": {},
    "id": 1,
    "name": "codechat",
    "ownerJid": "[email protected]"
  },
  "timestamp": "2026-07-04T18:00:00Z"
}

idstring

obrigatório, não aceita `null`. JID do grupo.

subjectstring

obrigatório, não aceita `null`. Nome do grupo.

participantsGroupParticipantWebhookData[]

obrigatório, não aceita `null`. Participantes conhecidos do grupo.

notifystring

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

addressingModestring

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

ownerstring

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

ownerPnstring

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

ownerUsernamestring

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

ownerCountryCodestring

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

subjectOwnerstring

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

subjectOwnerPnstring

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

subjectOwnerUsernamestring

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

subjectTimenumber

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

creationnumber

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

descstring

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

descOwnerstring

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

descOwnerPnstring

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

descOwnerUsernamestring

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

descIdstring

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

descTimenumber

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

linkedParentstring

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

restrictboolean

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

announceboolean

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

memberAddModeboolean

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

joinApprovalModeboolean

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

isCommunityboolean

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

isCommunityAnnounceboolean

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

sizenumber

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

ephemeralDurationnumber

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

inviteCodestring

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

authorstring

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

authorPnstring

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

authorUsernamestring

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

Observações de entrega

O payload e array para compatibilidade com contratos de lista, mesmo quando uma entrega contem um grupo.
Implemente idempotência por chave de negócio e aceite a possibilidade de duplicidades e reordenação.