> ## Documentation Index
> Fetch the complete documentation index at: https://developer.omni.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ventana de 24 horas

> Entiende cómo funciona la ventana de 24 horas de la API Oficial de WhatsApp y cuándo usar plantillas

export const frontendUrl = 'https://app.omni.z-api.io';

export const projectName = 'Omni Z-API';

## Entender la ventana de 24 horas de WhatsApp

La ventana de 24 horas es una regla de la **API Oficial de WhatsApp** que Meta define para controlar cuándo una empresa puede conversar libremente con un cliente y cuándo tiene que usar **plantillas de mensaje**.

Entender este concepto es imprescindible para usar la plataforma correctamente y evitar errores al enviar mensajes.

## ¿Qué es la ventana de 24 horas?

La ventana de 24 horas es un periodo que empieza siempre que el **cliente envía un mensaje** a la empresa.

Durante ese periodo, tu empresa puede responder libremente con mensajes normales: textos, imágenes, documentos, audios, vídeos, listas y botones.

Cada mensaje nuevo que envíe el cliente **reinicia ese contador** de 24 horas.

### Ejemplo

| Hora                    | Evento                        | Ventana                                                 |
| ----------------------- | ----------------------------- | ------------------------------------------------------- |
| 10:00                   | El cliente envía «Hola»       | Ventana abierta hasta las 10:00 del día siguiente       |
| 15:30                   | La empresa responde           | Permitido                                               |
| 18:20                   | El cliente envía otro mensaje | La ventana pasa a expirar a las 18:20 del día siguiente |
| 09:00 del día siguiente | La empresa responde           | Permitido                                               |

## Cuando la ventana está abierta

Mientras la ventana esté abierta puedes enviar prácticamente cualquier tipo de mensaje.

**Mensajes permitidos:**

* Texto
* Imágenes
* Vídeos
* Audios
* Documentos
* Stickers (cuando son compatibles)
* Ubicación
* Contactos
* Botones interactivos
* Listas
* Respuestas automáticas
* Mensajes enviados por agentes de IA
* Mensajes enviados por agentes humanos

<Note>
  Durante ese periodo no hace falta usar plantillas para responder al cliente.
</Note>

## Cuando la ventana expira

Tras **24 horas sin recibir ningún mensaje nuevo del cliente**, la conversación se cierra. A partir de ese momento:

* No se pueden enviar mensajes normales
* Cualquier intento será rechazado por la API de WhatsApp

Para iniciar una conversación nueva habrá que enviar una **plantilla aprobada por Meta**.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo enviar mensajes normales pasadas las 24 horas?">
    No. Una vez que la ventana expira, solo se puede enviar una plantilla aprobada.
  </Accordion>

  <Accordion title="El cliente respondió a la plantilla. ¿Puedo conversar con normalidad?">
    Sí. En cuanto el cliente responde, se abre una nueva ventana de 24 horas.
  </Accordion>

  <Accordion title="¿Cada mensaje del cliente reinicia la ventana?">
    Sí. Cada vez que el cliente envía un mensaje nuevo, la ventana se renueva por otras 24 horas.
  </Accordion>

  <Accordion title="¿Puedo enviar archivos multimedia durante la ventana?">
    Sí. Las imágenes, los vídeos, los documentos, los audios y otros formatos compatibles se pueden enviar con normalidad mientras la ventana esté abierta.
  </Accordion>

  <Accordion title="¿Necesito crear una plantilla para cada conversación?">
    No. Las plantillas solo son necesarias para iniciar o reanudar una conversación cuando no hay una ventana de 24 horas abierta.
  </Accordion>
</AccordionGroup>

## Resumen

| Situación                                   | ¿Puedo enviar un mensaje normal? | ¿Necesito plantilla? | ¿Meta cobra? |
| ------------------------------------------- | -------------------------------- | -------------------- | ------------ |
| El cliente escribió en las últimas 24 horas | ✅ Sí                             | ❌ No                 | ❌ No         |
| La ventana expiró                           | ❌ No                             | ✅ Sí                 | ✅ Sí         |
| El cliente respondió a la plantilla         | ✅ Sí                             | ❌ No                 | ❌ No         |
| El cliente no respondió a la plantilla      | ❌ No                             | ✅ Sí                 | ✅ Sí         |

## Buenas prácticas

* Responde al cliente mientras la ventana de 24 horas esté abierta para mantener el hilo de la conversación
* Usa plantillas solo cuando necesites iniciar o reanudar una conversación
* Elige la categoría de plantilla correcta (**Marketing**, **Utilidad** o **Autenticación**) para evitar rechazos en la aprobación
* Controla la expiración de la ventana para automatizar el envío de plantillas cuando sea necesario