¿Por qué se rechazó mi plantilla de WhatsApp?

Meta rechazó el contenido de la plantilla o el envío falló antes de la aprobación; el estado y el motivo del idioma enviado identifican cuál de los dos ocurrió.

Una plantilla puede parecer activa mientras un idioma de reemplazo no superó la revisión. Investiga la versión que enviaste para que una aprobación anterior no oculte el cambio fallido.

¿Qué estado identifica el problema?

Un estado rejected significa que Meta rechazó el contenido. submit_failed significa que el envío no se completó. pending significa que todavía no hay un resultado definitivo. Lee status en el idioma de la versión enviada antes de elegir una solución.

El registro de idioma distingue estos resultados:

EstadoQué ocurrióSiguiente acción
rejectedMeta rechazó el contenidoRevisa el motivo del rechazo y corrige un nuevo borrador
submit_failedEl envío no se completóRevisa el error y soluciona su causa
pendingMeta está revisando el contenido, o Bird está confirmando su recepciónEspera un veredicto y vuelve a leer el idioma

Para un rechazo de contenido, compara el motivo indicado con las directrices de plantillas. Un error de envío puede deberse en cambio a credenciales, medios o entrega de la solicitud.

La redacción del mensaje es solo una causa posible. Las credenciales, los medios y la entrega de la solicitud también pueden fallar.

¿Por qué falló el envío antes de la aprobación?

La solicitud no se completó por un problema de preparación local, un rechazo de Meta o intentos de entrega agotados.

Lee error.description para identificar la causa registrada. Algunos ejemplos son una credencial de cuenta inutilizable, un nombre derivado de plantilla en conflicto o medios que no se pueden preparar.

Para medios, verifica el problema de URL, tamaño o formato indicado. Cambiar la redacción del mensaje no repara un recurso inaccesible o inadecuado.

Un meta_error_code identifica un rechazo registrado de Meta. Bird lo omite en sus propios fallos. Meta también puede omitir un código en su rechazo.

Usa la descripción junto con el estado antes de decidir quién debe actuar. Conserva el código registrado cuando pidas a soporte que investigue un rechazo de Meta.

Cuando se agotan los reintentos de entrega, Bird comprueba si Meta tiene el contenido enviado antes de resolver el resultado. Sigue el resultado registrado en lugar de asumir que un tiempo de espera agotado demuestra que nada llegó.

¿Por qué no hay objeto de rechazo?

Bird omite rejection cuando Meta no proporciona motivo de rechazo, incluso si el estado del idioma es rejected.

Decide según status en lugar de la presencia de ese objeto. Un motivo ausente no convierte el idioma en aprobado ni en envíable.

Cuando está presente, rejection.reason contiene el motivo de Meta. Un recommendation puede acompañarlo, pero no todo rechazo incluye uno.

Conserva el identificador de plantilla, la versión y el idioma enviados cuando solicites soporte para un rechazo sin detalles. Esos datos identifican la revisión que necesita investigación.

¿Qué hago mientras un idioma está pendiente?

Vuelve a leer el idioma hasta que cambie su estado. No crees otro envío basándote solo en ese estado.

Un idioma pendiente está en revisión, o Bird aún está confirmando que Meta lo recibió. Bird mantiene el idioma en tránsito porque modificarlo actuaría sobre un resultado no confirmado.

El bloqueo impide cambios mientras el resultado del idioma no se resuelve. Las escrituras, la eliminación y la reversión permanecen bloqueadas con E15020 mientras el idioma está en tránsito. Espera a un estado definitivo antes de realizar esos cambios.

Si Meta tiene contenido coincidente, Bird adopta su estado registrado. El idioma puede pasar a aprobado, rechazado o pendiente, según la decisión de Meta.

Si Bird confirma que el envío no llegó, registra submit_failed. Cuando no puede establecer ninguno de los dos resultados, el idioma sigue pendiente.

Contacta con soporte indicando el identificador de plantilla si el idioma sigue pendiente. Los envíos repetidos no resuelven si Meta aceptó el original.

¿Cómo corrijo la plantilla y confirmo el reintento?

Para rejected, soluciona la causa con un borrador nuevo. Para submit_failed, hazlo después de que Bird confirme que la solicitud no llegó. Envía el idioma corregido. Luego comprueba el estado del idioma para confirmar que el reintento se resolvió.

Bird mantiene las versiones enviadas inmutables. Abre un borrador nuevo en lugar de intentar sobrescribir la versión cuya revisión falló.

Si la cuenta también está restringida o prohibida, Meta controla esa decisión sobre la cuenta.

Ejecuta la validación antes de enviar. Un resultado de validación limpio comprueba las reglas de contenido de Bird, pero no predice la aprobación de Meta.

Después del envío, inspecciona esa versión con bird whatsapp templates versions languages get. El estado agregado de la plantilla aún puede describir una versión activa anterior.

Por lo tanto, una plantilla active anterior no demuestra que el reemplazo fue aprobado. Confirma el veredicto del idioma enviado antes de usar su contenido modificado.

En resumen

  1. Empieza por el estado del idioma enviado.

    rejected es un veredicto de contenido. submit_failed significa que el envío falló. pending significa que todavía no hay un resultado definitivo.

  2. Usa el campo de motivo correspondiente.

    Lee rejection para un rechazo de contenido y error para un fallo de envío. La ausencia de detalles en el motivo no cambia el estado.

  3. No reenvíes un idioma pendiente.

    Meta puede tener ya el envío. Vuelve a leer el idioma y contacta con soporte si sigue pendiente.

  4. Corrige el contenido en un borrador nuevo.

    Una versión enviada es inmutable. Sigue el idioma de la nueva versión tras reenviar, en lugar del estado activo anterior de la plantilla.

Construye sobre la misma red.

Obtén una clave API de prueba de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.

Start building with Bird in minutes.