Referência/Webhooks/labels.association
Evento por instância

labels.association

Associacao ou remocao de label em chat ou mensagem.

flag: labelsAssociation

Requisição

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

Payload

json
{
"data": {
"action": "add",
"chatJid": "[email protected]",
"dateTime": "2026-07-04T18:00:00Z",
"labelId": "7",
"type": "chat"
},
"event": "labels.association",
"instance": {
"connectionStatus": "online",
"externalAttributes": {},
"id": 1,
"name": "codechat",
"ownerJid": "[email protected]"
},
"timestamp": "2026-07-04T18:00:00Z"
}
typestring

obrigatório, não aceita `null`. Tipo de associacao. Valores possíveis: `chat`, `message`.

chatJidstring

obrigatório, não aceita `null`. JID da conversa.

messageIdstring

opcional, não aceita `null`. ID da mensagem quando type=message.

labelIdstring

obrigatório, não aceita `null`. ID da label.

actionstring

opcional, não aceita `null`. Acao inferida quando labeled esta presente. Valores possíveis: `add`, `remove`.

dateTimestring

obrigatório, não aceita `null`. Timestamp RFC3339 do processamento.

additionalPropertiesobject

opcional, não aceita `null`. Campos achatados do evento original.

Observações de entrega

  • Sem observações adicionais.
  • Implemente idempotência por chave de negócio e aceite a possibilidade de duplicidades e reordenação.