> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Controles de calidad y entrega

> Comprende por qué los mensajes aprobados pueden retrasarse o bloquearse, y responde a las señales de calidad sin realizar reintentos a ciegas.

Una solicitud de API válida y una plantilla aprobada no garantizan que cada mensaje llegue a su destinatario.

WhatsApp utiliza señales de calidad y controles de entrega para proteger a los clientes de mensajes no deseados. Diagnostica el nivel afectado antes de modificar una plantilla, aumentar el gasto o reintentar una campaña.

## Controles que pueden afectar a la entrega

El **ritmo de envío (pacing)** permite a WhatsApp evaluar las respuestas a una plantilla antes de liberar más mensajes. No interpretes cada retraso como un fallo de transporte.

La **pausa o inhabilitación** puede hacer que una plantilla no esté disponible tras recibir comentarios negativos o una baja interacción. Comprueba el estado actual de la plantilla antes de programar envíos adicionales.

Los **límites de marketing a nivel de destinatario** pueden impedir que un cliente reciba otro mensaje de marketing, incluso si tu propia cuenta tiene capacidad disponible. Estos límites afectan a la experiencia general del cliente, no solo a los mensajes de tu empresa.

Meta describe estos mecanismos en los [aspectos fundamentales de las plantillas](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/). Sus umbrales y disponibilidad pueden cambiar; no prometas una cuota fija para cada cliente.

## Diagnosticar a partir del resultado

| Observación | Primera acción |
| - | - |
| Solicitud aceptada pero aún sin entrega | Sigue las actualizaciones de estado y verifica si hay procesamiento pendiente; no dupliques el envío de inmediato. |
| La plantilla está pausada o inhabilitada | Detén los envíos dependientes y revisa los comentarios y el contenido. |
| Los fallos se concentran en una sola plantilla | Revisa su categoría, calidad, estado y la audiencia reciente. |
| Los fallos se concentran en clientes individuales | Examina los errores específicos del destinatario y sus preferencias de comunicación. |
| Los fallos afectan a muchas plantillas y números | Comprueba la capacidad de la cuenta, el estado de la cuenta, el estado de la integración y la facturación. |

Consulta los [estados de entrega de mensajes](/es/documentation/whatsapp-business-platform/messaging/message-delivery-statuses) para conocer el ciclo de vida de un mensaje. Conserva el código de error exacto y los identificadores relevantes al ponerte en contacto con soporte.

## Códigos de error comunes y qué comprobar

YCloud puede devolver sus propios errores y errores de WhatsApp en origen. Conserva el código real y los detalles; a continuación se muestran códigos comunes de **Meta** , no todos los resultados posibles de YCloud.

| Código | Qué comprobar |
| - | - |
| `130429` | Rendimiento excedido; reduce la velocidad de envío. |
| `131026` | No entregable; no concluyas que el destinatario te ha bloqueado. |
| `131042` | Configuración de facturación o pago; no es automáticamente una suspensión por políticas. |
| `131047` | Ventana de servicio vencida; elige una plantilla de mensaje aprobada adecuada. |
| `131049` | Control de entrega por destinatario o interacción; evita reintentos inmediatos. |
| `131050` | El destinatario canceló los mensajes de marketing de tu empresa; no reintentes ese envío de marketing. |
| `132000` | Discrepancia en el número de parámetros de la plantilla. |
| `132001` | Discrepancia en el nombre, idioma o aprobación de la plantilla. |
| `132015` / `132016` | Plantilla pausada o inhabilitada; detén los envíos dependientes. |

Para `131049`, Meta aconseja esperar al menos 24 horas antes de un posible reenvío si se sospecha de un límite en el destinatario. Esperar **no** garantiza la entrega; confirma primero el consentimiento, la relevancia y si está justificado otro intento. Esto es diferente de `131050`, que indica que el destinatario optó por no recibir marketing.

Fuente: [códigos de error de Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes).

## Realizar un diagnóstico enfocado

Compara un conjunto pequeño de mensajes representativos por plantilla, remitente, fuente de audiencia, hora y error. No realices pruebas contactando repetidamente al mismo destinatario con fallos.

Por ejemplo, si una plantilla falla en varios números mientras que otras funcionan, investiga primero el estado y los parámetros de esa plantilla. Si muchas plantillas fallan tras un cambio en la facturación, examina la configuración de la cuenta y facturación antes de reescribir su texto.

Crea un registro breve del incidente: fallo observado, alcance afectado, último envío correcto conocido, cambios recientes, acción de contención y siguiente responsable. Esto transforma un «WhatsApp no funciona» en un problema específico y comprobable.

## Mejorar la experiencia del cliente

Prioriza la relevancia antes que el volumen:

* Envía lo que el cliente esperaba al dar su consentimiento.
* Aprovecha la intención reciente del cliente y una razón clara para contactarlo.
* Coordina la frecuencia entre campañas y automatizaciones.
* Identifica a tu empresa claramente.
* Mantén el contenido preciso, útil y fácil de accionar.
* Facilita la opción de darse de baja y aplícala de inmediato.

Monitorea tanto los resultados de entrega como las respuestas de los clientes. Una alta tasa de entrega con un número creciente de cancelaciones de suscripción (opt-outs) no representa una campaña saludable.

## Reintenta de forma deliberada

Reintenta solo cuando el error indique una condición recuperable y el mensaje siga siendo útil. Utiliza reintentos limitados y evita generar notificaciones duplicadas a los clientes.

No reenvíes repetidamente un mensaje de marketing bloqueado, no rotes números comerciales ni reclasifiques contenido promocional como de utilidad para eludir los controles.

Si el cliente inicia una nueva conversación, responde a su solicitud real utilizando el tipo de mensaje permitido. No consideres esa interacción como una autorización para reiniciar campañas no relacionadas.

## Temas relacionados

* [Revisión y ciclo de vida de las plantillas](/es/documentation/whatsapp-business-platform/messaging/message-templates/template-review-and-lifecycle)
* [Límites de mensajería y rendimiento](/es/documentation/whatsapp-business-platform/pricing-limits-and-quality/messaging-limits-and-throughput)
* [Cancelación de suscripción de clientes (opt-out)](/es/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-out)
* [Restricciones y apelaciones de cuentas](/es/documentation/whatsapp-business-platform/consent-policies-and-account-health/account-restrictions-and-appeals)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.