Apariencia
conversation.updated
Se envía cuando: un chat se leyó, se marcó como no leído, se archivó o desarchivó, se fijó o desfijó, o se silenció o se le quitó el silencio. Da igual si fue por la API, desde el panel o desde el teléfono del negocio / WhatsApp Web.
Qué trae data: El objeto conversation ya actualizado (con su último mensaje) y changes, la lista de lo que cambió: read, unread, archived, unarchived, pinned, unpinned, muted, unmuted.
Para qué sirve: Mantener tu bandeja igual que WhatsApp: si alguien leyó o archivó el chat en el teléfono, tu CRM se entera. Solo sale cuando uno de esos estados cambia; un mensaje nuevo no lo dispara (para eso están los eventos message.*).
Ejemplo
El cuerpo que recibe tu servidor (datos ficticios):
json
{
"id": "evt_01EXAMPLE00000000000000016",
"type": "conversation.updated",
"created_at": "2026-01-01T12:07:00.000000Z",
"workspace_id": "ten_01EXAMPLE00000000000000000",
"data": {
"conversation": {
"id": "cnv_01EXAMPLE00000000000000000",
"instance_id": "ins_01EXAMPLE00000000000000000",
"type": "direct",
"phone": "5255000000002",
"group_id": null,
"name": "Ana López",
"unread_count": 0,
"marked_unread": false,
"archived": false,
"pinned": false,
"muted": false,
"muted_until": null,
"last_message_at": "2026-01-01T12:04:00+00:00",
"last_message": {
"id": "msg_01EXAMPLE00000000000000000",
"instance_id": "ins_01EXAMPLE00000000000000000",
"direction": "inbound",
"from_me": false,
"source": null,
"api_key_id": null,
"type": "text",
"status": "received",
"to": null,
"from": "5255000000002",
"from_name": "Ana López",
"group_id": null,
"text": "Hello, do you ship to Monterrey?",
"caption": null,
"media": null,
"location": null,
"contacts": null,
"poll": null,
"reply_to": null,
"forwarded": false,
"reactions": [],
"error": null,
"created_at": "2026-01-01T11:59:59+00:00",
"queued_at": null,
"sent_at": null,
"delivered_at": null,
"read_at": null,
"failed_at": null,
"received_at": "2026-01-01T11:59:59+00:00",
"edited_at": null,
"deleted_at": null
},
"created_at": "2026-01-01T12:04:00+00:00",
"updated_at": "2026-01-01T12:07:00+00:00"
},
"changes": [
"read"
]
}
}Todos los eventos comparten el mismo sobre (id, type, created_at, workspace_id, data) y los mismos headers de firma. Cómo verificarla, qué responder y cómo se reintenta: Webhooks.