Evento por instância

contacts.upsert

Contato criado ou atualizado no cadastro local.

flag: contactsUpsert

Requisição

http

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

Payload

json

{
  "data": {
    "action": "upserted",
    "id": 41,
    "lid": "279847268053216@lid",
    "profilePicUrl": null,
    "pushName": "Cliente",
    "remoteJid": "[email protected]"
  },
  "event": "contacts.upsert",
  "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

obrigatório, aceita `null`. Push name salvo para o contato.

profilePicUrlstring | null

obrigatório, aceita `null`. URL de foto do perfil quando conhecida.

actionstring

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

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.