> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/campanas/logica-de-mensajes-y-limites.md). # Lógica de Mensajes y Límites Las campañas de agentes de texto de Dapta envían mensajes de WhatsApp a través de la Plataforma Business de Meta. Las reglas que gobiernan cuándo salen los mensajes, cuántos pueden enviarse y qué ocurre cuando la entrega falla son una combinación del motor de programación de Dapta y los **límites de mensajería a nivel de cuenta de Meta**. Esta página explica ambos. ## Estados de la Campaña Cada campaña recorre un ciclo de vida representado por su estado. Puedes ver el estado actual en la lista de campañas y en la página de detalle. | Estado | Descripción | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **Queued** | Campaña creada pero el flujo de envío aún no ha comenzado. | | **Running** | La campaña está enviando mensajes activamente a los contactos. | | **Waiting — Schedule** | El horario actual está fuera de todas las ventanas de envío configuradas. El envío se reanuda automáticamente cuando se abre la próxima ventana. | | **Waiting — Tier** | La campaña alcanzó el límite diario de mensajería de Meta para tu cuenta. El envío se reanuda automáticamente cuando el límite se resetea. | | **Paused** | La campaña fue pausada manualmente. No se envían mensajes hasta que actives el toggle nuevamente. | | **Completed** | Todos los contactos han sido procesados o se alcanzó la fecha de fin. | | **Cancelled** | La campaña fue cancelada manualmente. Los contactos restantes no recibirán mensajes. | | **Failed** | Un error irrecuperable detuvo la campaña. | {% hint style="info" %} **Waiting — Tier** es un estado operativo normal, no un error. Tu campaña se reanudará automáticamente una vez que tu ventana de 24 horas de envío se resetee con Meta. {% endhint %} *** ## Ventanas de Envío El horario de envío controla **qué días** y **qué horas** tiene permitida tu campaña enviar mensajes. Todos los horarios siguen la **zona horaria** configurada en la campaña. ### Días de Contacto Elige una de tres opciones: * **Every day** — la campaña envía los siete días de la semana. * **Weekdays (Lun–Vie)** — la campaña envía solo en días hábiles. * **Custom** — elige días específicos de la semana. ### Franjas Horarias Cada día activo tiene sus propias franjas horarias con hora de inicio y fin. Puedes agregar múltiples franjas por día — por ejemplo, 9:00 AM – 12:00 PM y 2:00 PM – 6:00 PM. Se aplican las siguientes reglas: * Las franjas **no pueden solaparse** dentro del mismo día. * La **hora de inicio debe ser anterior a la hora de fin**. * Al menos **un día debe estar activo** con al menos una franja horaria. {% hint style="warning" %} Si la campaña está en ejecución y llega a un horario fuera de todas las ventanas de envío, pasa a **Waiting — Schedule** y se reanuda automáticamente cuando comience la próxima ventana. No se omite ningún contacto. {% endhint %} *** ## Niveles de Mensajería de WhatsApp La cantidad de contactos únicos que tu campaña puede enviar mensajes por día no se configura en Dapta — está determinada por el **sistema de niveles de mensajería de Meta**, que está vinculado a la reputación de calidad de tu Cuenta Business de WhatsApp. A partir de octubre de 2025, los límites de mensajería aplican a nivel de **portafolio de negocio**: todos los números de teléfono bajo el mismo Meta Business Portfolio comparten un único límite diario. ### Tabla de Niveles | Nivel | Contactos únicos por día | Requisito | | ----------------- | ------------------------ | --------------------------------------------------------- | | **No verificado** | 250 | Por defecto para cuentas nuevas sin verificar | | **Nivel 1** | 1.000 | Verificación Business de Meta completada | | **Nivel 2** | 10.000 | Volumen consistente en Nivel 1 + calidad mantenida | | **Nivel 3** | 100.000 | Volumen consistente en Nivel 2 + calidad mantenida | | **Ilimitado** | Sin límite | Calidad sostenida en Nivel 3 sin violaciones de políticas | {% hint style="info" %} Estos límites cuentan **contactos únicos por ventana de 24 horas**, no mensajes totales. Enviar múltiples mensajes al mismo contacto en un día cuenta como uno hacia tu límite. {% endhint %} *** ## Calificación de Calidad Meta asigna una **calificación de calidad** a tu Cuenta Business de WhatsApp basada en cómo responden los destinatarios a tus mensajes — principalmente si bloquean tu número o reportan mensajes como spam. | Calificación | Color | Significado | | ------------ | ----------- | --------------------------------------------------------------------------------------------------------------------------- | | **Alta** | 🟢 Verde | Los mensajes son bien recibidos. Las actualizaciones de nivel son posibles. | | **Media** | 🟡 Amarillo | Se detectan más bloqueos de lo habitual. El nivel está congelado — no hay actualizaciones hasta que la calidad se recupere. | | **Baja** | 🔴 Rojo | Retroalimentación negativa significativa. El avance de nivel está bloqueado. La cuenta puede ser revisada. | Puedes verificar tu calificación de calidad y nivel de mensajería actual en el **Meta Business Manager** en la configuración de tu Cuenta Business de WhatsApp. *** ## Avanzar al Siguiente Nivel Las actualizaciones de nivel ocurren **automáticamente** — no necesitas solicitarlas manualmente. Meta evalúa tu cuenta cada **6 horas**. ### No verificado → Nivel 1 Completa la **Verificación Business de Meta** en tu Meta Business Manager. Una vez verificada, tu límite aumenta a 1.000 contactos/día de inmediato. ### Nivel 1 → Nivel 2 → Nivel 3 → Ilimitado Las actualizaciones automáticas ocurren cuando **ambas** condiciones son verdaderas: 1. Tu cuenta ha usado **≥ 50% de su límite diario actual** de manera consistente durante los últimos **7 días**. 2. Tu calificación de calidad es **Verde (Alta)** o **Amarilla (Media)** — no Roja. Cuando ambas condiciones se cumplen, Meta actualiza tu nivel en aproximadamente **6 horas**. En condiciones óptimas, una sola cuenta puede avanzar múltiples niveles en el mismo día hábil. {% hint style="success" %} **Consejo:** Para subir de nivel más rápido, enfócate en enviar a contactos que hayan dado su consentimiento con mensajes personalizados y relevantes. Evita envíos masivos genéricos — generan bloqueos y reducen tu calificación de calidad. {% endhint %} *** ## Qué Reduce tu Calificación de Calidad Meta reduce las calificaciones de calidad cuando una proporción significativa de destinatarios responde negativamente. Causas comunes: * **Altas tasas de bloqueo** — generalmente por encima del 2–3% de los destinatarios bloqueando tu número. * **Reportes de spam** — destinatarios que tocan "Reportar" en un mensaje. * **Violaciones de plantilla** — usar plantillas de categoría marketing para contenido que no es marketing, o viceversa. * **Sobrecarga de frecuencia** — enviar demasiados mensajes al mismo usuario en poco tiempo. {% hint style="warning" %} Meta aplica un **límite de frecuencia** general de aproximadamente 2 mensajes de marketing por usuario por día en todas las empresas. Superar este límite devuelve el código de error `131049`. Dapta marca los contactos afectados y programa un reintento para la próxima ventana de envío. {% endhint %} *** ## Lógica de Reintentos Cuando un mensaje no se puede entregar, Dapta sigue una política de reintentos estructurada según el tipo de falla. | Tipo de Falla | Comportamiento | | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- | | **Error transitorio** (red, problema temporal del proveedor) | Reintento hasta **3 intentos en total**, programado en la próxima ventana de envío disponible. | | **Límite de velocidad / cuota diaria alcanzada** | El envío se pausa hasta que la cuota se resetea, luego continúa automáticamente. | | **Plantilla pausada o rechazada** | Contacto marcado como **Failed** de inmediato — sin reintentos. | | **Error no recuperable del proveedor** | Contacto marcado como **Failed** de inmediato — sin reintentos. | Una vez que un contacto alcanza **3 intentos fallidos**, se marca como **Failed** y se omite por el resto de la campaña. *** ## Ventana de Deduplicación de 24 Horas Para prevenir envíos dobles accidentales, Dapta aplica una **ventana de deduplicación de 24 horas** por número de teléfono por canal de WhatsApp. Si ya se envió exitosamente un mensaje a un número de teléfono en las últimas 24 horas, cualquier intento de envío posterior al mismo número se omite automáticamente y se registra como `dedup_skip`. Esto aplica **en todas las campañas** que comparten el mismo canal de agente. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/campanas/logica-de-mensajes-y-limites.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.