Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.waspytech.com/llms.txt

Use this file to discover all available pages before exploring further.

​
¿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, documentoSí — el contacto debe haber escrito en las últimas 24hs
TemplateNo — 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"
  }
}
Si serviceWindowExpiresAt es null o una fecha pasada, la ventana está cerrada.

​
Flujo recomendado

  1. Si necesitás contactar a alguien que no te escribió → enviá un template.
  2. Cuando el contacto responde → se abre la ventana de 24hs.
  3. Dentro de la ventana → podés enviar texto libre, imágenes, documentos, etc.
  4. 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.