Ventana de 24 horas y plantillas de WhatsApp explicadas

Según la documentación de Meta, cuando un usuario envía un mensaje o hace una llamada a tu empresa, empieza un temporizador de 24 horas llamado ventana de atención al cliente. Mientras la ventana está abierta, la empresa puede enviar mensajes que no son plantilla. Fuera de ella, solo plantillas. Cada mensaje nuevo del cliente reinicia la cuenta.

En la práctica, esto separa dos tipos de conversación. En la iniciada por el cliente, respondes con texto libre, multimedia y botones mientras la ventana esté abierta. En la iniciada por la empresa (cobranza, aviso, campaña), la ventana aún no existe o ya se cerró, y el primer contacto tiene que ser una plantilla. Los términos están en el glosario y en el de plantilla.

Una plantilla es un mensaje con texto preaprobado por Meta, con variables (nombre, fecha, monto) que completas al enviar. Meta clasifica las plantillas en categorías, como marketing, utilidad y autenticación, y la categoría influye en el cobro.

Existe además una ventana especial de punto de entrada gratuito. Según Meta, cuando el usuario llega desde un anuncio de Click to WhatsApp, la ventana puede quedar abierta hasta 7 días, y en ese período los mensajes de marketing, utilidad, autenticación y servicio no se cobran. Revisa las condiciones actuales en la documentación de Meta antes de planear una campaña sobre esto.

Es un error de la API oficial de Meta, no de ZapZap. La descripción oficial es 'han pasado más de 24 horas desde que el destinatario respondió por última vez al número remitente', y la solución que sugiere Meta es enviar una plantilla. Si ves este código, tu mensaje de texto libre se envió con la ventana cerrada.

Otros dos códigos aparecen en las conversaciones sobre el tema. El 131049 indica que el mensaje no se entregó para mantener la salud del ecosistema, y Meta recomienda esperar al menos 24 horas antes de reenviar la plantilla. El 131026 indica que no se pudo entregar, con causas como que el número no sea de WhatsApp, que el destinatario no haya aceptado los términos más recientes o que use una versión antigua de la app. La lista completa está en la página de códigos de error de Meta (developers.facebook.com, documentación de WhatsApp Business Messaging).

ZapZap no devuelve estos códigos, porque pertenecen a la API oficial. Si un código con este formato aparece en tu integración, viene de una API oficial que también usas.

Según Meta, desde el 1 de julio de 2025 el cobro es por mensaje entregado, y no por conversación. La empresa no paga por los mensajes que envían los usuarios. Según la documentación leída el 27/10/2026, los primeros 1.000 mensajes de servicio de cada mes no se cobran, y por encima de eso el cobro de mensajes de servicio rige desde el 1 de octubre de 2026. Los mensajes de marketing, utilidad y autenticación se cobran por categoría.

Los valores en moneda local cambian por trimestre y por categoría, y el precio desactualizado en blogs es la principal fuente de errores de presupuesto. Por eso esta guía no repite tablas: consulta la tabla de tarifas oficial de Meta y usa la calculadora de costo del sitio, que muestra la fecha de verificación. Para una comparación de costos y rutas de contratación, mira la guía de la WhatsApp Business API.

Además de la tarifa de Meta, el proveedor oficial (BSP) puede cobrar mensualidad o margen. Suma todo en el costo por conversación útil antes de decidir.

La regla de ventana y de plantilla es de la plataforma oficial de Meta. En una API no oficial, como ZapZap, conectas el número por QR y envías texto libre, sin plantilla y sin aprobación previa, en cualquier momento. No hay cobro por mensaje de Meta de por medio, y ZapZap cobra por número activo, prepago (precios).

El cambio es de riesgo. Sin el freno de la ventana, quien controla el comportamiento eres tú, y mandar mensajes a quien nunca habló con la empresa es justamente lo que aumenta la probabilidad de denuncia y de restricción del número. El uso no oficial no está previsto en los Términos de WhatsApp, y ninguna herramienta elimina ese riesgo. Mira la guía honesta de la API no oficial y el antibloqueo en WhatsApp.

Una buena práctica prestada de la oficial: aun sin un freno técnico, trata la ventana de 24 horas como una regla de conducta. Responde dentro de ella, pide permiso antes de iniciar una conversación y deja una salida fácil. Comparativo completo en ZapZap vs API oficial.

curl -X POST "https://api.zapzapapi.com/api/v1/$INSTANCE_ID/send/text" \
  -H "x-api-key: $ZAPZAP_API_KEY" \
  -H "x-api-secret: $ZAPZAP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"number":"5511999999999","text":"Olá, Maria! Seu pedido saiu para entrega."}'

Ninguna de las dos es la respuesta universal. Compara costos reales con tu volumen y las consecuencias de perder el número. Para decidir con números, empieza por la calculadora.

Imagina una clínica que recuerda citas. En la API oficial, el recordatorio es el primer contacto de la empresa, así que tiene que ser una plantilla de utilidad aprobada, con variables para nombre, fecha y hora. Si el paciente responde 'confirmo', la ventana de 24 horas se abre y la clínica puede conversar libremente: reprogramar, enviar la dirección, resolver dudas. Si el paciente responde al día siguiente, la ventana ya se cerró y la respuesta de la clínica necesita otra plantilla.

En una API no oficial, el mismo recordatorio es un texto libre. La operación queda más simple y más barata por mensaje, y el cuidado pasa a ser otro: recordar solo a quien agendó, en un horario razonable y con una salida fácil. Para el dueño del negocio, la pregunta útil no es cuál es la más barata, sino qué combinación de costo, control y riesgo tiene sentido para esa parte de la operación. Muchas empresas usan la oficial para recordatorios y cobros formales y la no oficial para la conversación de atención.

Al diseñar el flujo, escribe en una hoja quién habla primero, en qué momento se abre la ventana y qué pasa cuando se cierra. Ese mapa evita sorpresas del error 131047 en la oficial y de mensajes a quien no los esperaba en la no oficial.