Ventana de atención (24 h) del contacto
GET/contacts/:id/window
Si un mensaje libre (fuera de plantilla) todavía llega al contacto, número por número. La ventana se abre cuando el contacto escribe y dura 24 h desde su último mensaje (72 h en una conversación que vino de un anuncio de clic a WhatsApp). Fuera de ella solo sale una plantilla aprobada, y es ella la que reabre la conversación.
Con from, la respuesta es sobre un número de la cuenta y trae siempre una entrada, cerrada cuando el contacto nunca le escribió. Sin from, vienen todos los números con los que el contacto conversó, del que cierra más tarde al que cierra antes, y open/expiresAt resumen el mejor de ellos.
Con una API key restringida a algunos números, solo aparecen esos números; un from fuera de ellos responde 403, y un contacto sin conversación en ellos responde 404, como uno que no existe.
Request
Responses
- 200
- 401
- 402
- 403
- 404
- 422
- 429
Ventanas del contacto.
Token ausente, mal formado, desconocido o revocado (authentication), o cuenta
suspendida (tenant_inactive).
Sin derecho de uso (payment_required). El cuerpo trae el motivo en reason y la
salida en action: qué hacer (kind) y la página del panel donde se hace (url).
El recurso no pertenece a tu cuenta (forbidden), o la ruta está en la lista de
bloqueo del espejo (forbidden_endpoint), o tu API key está restringida a algunos
números y la operación es de toda la cuenta (forbidden).
El recurso no existe (not_found).
El payload no pasó la validación (invalid_request, detallado en issues) o fue
rechazado por Meta (meta_error, con el cuerpo original en meta).
Límite de peticiones superado (rate_limit).
Response Headers
Segundos a esperar antes de reintentar.
Categoría de límite aplicada — send, media o default.
Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).
Techo de peticiones de la categoría en la ventana actual.
Peticiones restantes en la ventana actual.