Ir al contenido

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.