Evento por instância

contacts.update

Atualizacao parcial em contato existente.

flag: contactsUpdated

Requisição

http

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

Payload

json

{
  "data": [
    {
      "action": "updated",
      "businessName": null,
      "id": 41,
      "lid": null,
      "pushName": "Cliente Atualizado",
      "remoteJid": "[email protected]",
      "source": "pushName"
    }
  ],
  "event": "contacts.update",
  "instance": {
    "connectionStatus": "online",
    "externalAttributes": {},
    "id": 1,
    "name": "codechat",
    "ownerJid": "[email protected]"
  },
  "timestamp": "2026-07-04T18:00:00Z"
}

idnumber

obrigatório, não aceita `null`. ID interno do contato persistido.

remoteJidstring

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

lidstring | null

obrigatório, aceita `null`. LID do contato quando conhecido.

pushNamestring | null

opcional, aceita `null`. Push name atualizado quando presente.

businessNamestring | null

opcional, aceita `null`. Nome comercial atualizado quando presente.

actionstring

obrigatório, não aceita `null`. Acao executada. Valores possíveis: `updated`.

sourcestring

obrigatório, não aceita `null`. Origem da alteracao. Valores possíveis: `pushName`, `businessName`.

Observações de entrega

O payload e array; o handler atual normalmente envia um item por entrega.
Implemente idempotência por chave de negócio e aceite a possibilidade de duplicidades e reordenação.