¿Qué es la ventana de servicio?
WhatsApp tiene una regla: solo podés enviar mensajes de texto libre a un contacto si ese contacto te escribió en las últimas 24 horas. Eso se llama ventana de servicio.
Reglas
| Tipo de mensaje | ¿Requiere ventana activa? |
|---|
| Texto, imagen, video, audio, documento | Sí — el contacto debe haber escrito en las últimas 24hs |
| Template | No — se puede enviar en cualquier momento |
¿Cómo funciona en la API?
Si intentás enviar un mensaje de texto libre fuera de la ventana, recibís un error:
{
"error": {
"code": "SERVICE_WINDOW_EXPIRED",
"message": "La ventana de servicio expiró. Usá un template para iniciar conversación.",
"status": 403
}
}
¿Cómo saber si la ventana está activa?
Consultá la conversación con GET /conversations/:id. El campo serviceWindowExpiresAt indica cuándo expira:
{
"data": {
"id": "conv-uuid",
"serviceWindowExpiresAt": "2026-04-14T14:32:00.000Z"
}
}
serviceWindowExpiresAt es null o una fecha pasada, la ventana está cerrada.
Flujo recomendado
- Si necesitás contactar a alguien que no te escribió → enviá un template.
- Cuando el contacto responde → se abre la ventana de 24hs.
- Dentro de la ventana → podés enviar texto libre, imágenes, documentos, etc.
- Cuando la ventana cierra → volvé a usar un template.
Para atención al cliente, el flujo natural es: el cliente escribe → tu equipo responde dentro de la ventana. No necesitás templates para responder.