Ricky logorickyDocs

Marcar una conversación como leída

POST
/conversations/{conversation_id}/read

La marca como leída para todo el equipo hasta su último mensaje, como al abrirla en el inbox. En WhatsApp el contacto ve la confirmación de lectura. No envíes cuerpo.

Permiso: conversations:write.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de ruta

conversation_id*string

ID de la conversación.

Formatouuid

Parámetros de cabecera

Idempotency-Key?string

Opcional. Un valor que eliges, único por escritura lógica, de 8 a 200 caracteres: un UUID o un ID de tu sistema, como order-10482-ready. Reintentar con la misma clave y el mismo cuerpo repite la primera respuesta en lugar de repetir la escritura.

Longitud8 <= length <= 200

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*

Un contacto que habla con la organización en un canal.

curl -X POST 'https://getricky.ai/api/v1/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08/read' \  -H 'Idempotency-Key: order-10482-ready'
{  "data": {    "id": "9b2e4c61-7a3f-4d18-b5c2-6e0f1a2b3c4d",    "channel": {      "id": "8f3c2a5e-6b1d-4c7a-9e2f-1a2b3c4d5e6f",      "type": "whatsapp"    },    "contact": {      "id": "3f6c2b1e-8d4a-4b7e-9a51-2c7d8e9f0a1b",      "display_name": "Ana Pérez",      "external_id": "50760001234",      "username": null    },    "status": "open",    "close_category": "resolved",    "assigned_user_id": "2d4f6a8c-1b3d-4e5f-8a7b-9c0d1e2f3a4b",    "agent_id": "7e8f9a0b-1c2d-4e3f-a4b5-c6d7e8f9a0b1",    "created_at": "2026-10-14T15:30:00.000Z",    "opened_at": "2026-10-14T15:30:00.000Z",    "closed_at": "2026-10-14T15:30:00.000Z",    "last_activity_at": "2026-10-14T15:30:00.000Z",    "last_activity_preview": "¿Ya están mis lentes?",    "unread": true,    "active_handoff": {      "id": "2e3f4a5b-6c7d-4e8f-9a0b-1c2d3e4f5a6b",      "status": "requested",      "requested_by": "agent",      "reason": "customer_requested",      "summary": "La clienta pide hablar con alguien sobre un reembolso.",      "assigned_user_id": "2d4f6a8c-1b3d-4e5f-8a7b-9c0d1e2f3a4b",      "requested_at": "2026-10-14T15:30:00.000Z"    }  }}