Mi entrada no fue publicada

Si se suponía que una campaña debía publicar una entrada y no apareció, sigue esta página en orden. La mayoría de los casos caen en uno de unos pocos grupos; la lista de verificación te señalará rápidamente el correcto.

¿Hiciste clic en “Generate Now”?

Si la entrada que falta fue desencadenada por el botón Generate Now en una campaña (en lugar de por el planificador de Structura), la ruta de código es diferente y el modo de fallo más común tiene una solución rápida. Dos cosas a verificar antes de la lista de verificación completa:

¿La respuesta REST mostró un error? Un mensaje que mencione Herramientas → Estado del sitio o max_allowed_packet significa que la tarea en segundo plano fue rechazada por MySQL — aumenta el valor max_allowed_packet de la base de datos a al menos 4 MB en tu servidor. El tutorial completo para esa solución está en Las imágenes no se generan, Paso 1 — misma causa raíz, misma solución.
Abre el detalle de ejecución de la campaña (haz clic en la ejecución desde la tarjeta de la campaña o en la Cola activa del panel). Una ejecución fallida de una sola entrada que “no pudo cargar su payload de campaña” significa que la tarea en segundo plano se ejecutó demasiado tarde (los datos del formulario en caché ya habían expirado). Haz clic en Generate Now de nuevo.

Si ninguna de estas opciones aplica, continúa con la lista de verificación.

Paso 1: ¿La campaña está activa?

Ve a Structura → Campaigns.
Encuentra la campaña. Verifica el indicador de Estado.

En ejecución — debería estar publicando. Pasa al Paso 2.
En pausa — la campaña fue pausada, intencionalmente o no. Reanúdala desde la página de detalle de la campaña (botón Pausar / Reanudar). Consulta Pausar o eliminar una campaña.
Borrador — la campaña nunca fue finalizada. Ábrela y completa el paso Resumen.

Paso 2: ¿Debía publicarse hoy?

Verifica el ajuste de Ritmo de la campaña en su página de detalle. Si está configurada como semanal y hoy no es el día programado, simplemente aún no ha ejecutado — eso es lo esperado.

Paso 3: ¿Se ejecutó el planificador?

Abre Structura → Panel y verifica la tarjeta de Cola activa. Si la actividad más reciente es mucho más antigua que la cadencia de tu campaña (horas o días de retraso), el cron de WordPress no está ejecutando las tareas de Structura. Haz clic en el ícono de campana — si hay un aviso abierto de salud del Plugin sobre WP-Cron, esa es tu respuesta. Si no lo hay, ejecuta Diagnósticos desde Ajustes → Diagnósticos para que aparezca uno.

Causas comunes cuando WP-Cron es el culpable:

Sitio con poco tráfico. El cron de WordPress se ejecuta con las cargas de página; un sitio que nadie visita no ejecutará tareas programadas. Solución: instala un desencadenador de cron “real” (p. ej., agrega una llamada a WP-Cron al cron de tu servidor), o simplemente visita el sitio manualmente.
Un plugin de caché o seguridad bloqueando wp-cron. Verifica que wp-cron.php sea accesible.
Un sustituto de WP-Cron del proveedor de hosting está mal configurado. Algunos hosts administrados deshabilitan WP-Cron y lo reemplazan con su propio sistema. Confirma que esté funcionando.

Consulta WP-Cron está deshabilitado para la solución.

Paso 4: ¿La campaña seleccionó un tema?

Abre la campaña y observa la ejecución más reciente (la lista Campaigns → [campaña] → Ejecuciones recientes). Haz clic en la ejecución para ver su cronograma de pasos.

Paso de palabras clave exitoso — se seleccionó un tema. Continúa.
Paso de palabras clave fallido con “no hay temas disponibles” — el grupo de palabras clave de la campaña está agotado. Edita la campaña y agrega más palabras clave objetivo. Consulta Palabras clave objetivo.

Paso 5: ¿Funcionó la generación del borrador?

En la misma vista de detalle de ejecución, observa el paso de Contenido.

Paso exitoso — el borrador fue generado. Continúa.
Paso fallido — el mensaje de fallo te indica qué salió mal. El clasificador asigna causas comunes a avisos para el usuario que aparecen en el ícono de campana:
- Clave de IA rechazada — tu clave BYOK ha sido revocada o rotada. Abre Ajustes → Motor de IA y actualiza o reemplaza la clave. Consulta Ajustes de IA.
- Cuota agotada — si estás en un plan Cloud y usaste la cuota de generación de este ciclo. Espera el siguiente ciclo o realiza una mejora.
- No hay clave de IA conectada — Structura no tenía una clave BYOK para el proveedor solicitado. Abre Ajustes → Motor de IA y agrega una.

Paso 6: ¿La publicación fue exitosa?

En el detalle de ejecución, observa el paso de Publicar.

Paso exitoso — la entrada está en WordPress. Ve a Entradas → Todas las entradas y búscala (busca por título o fecha). Si está allí, tu problema probablemente es un problema de tema / front-end: la entrada existe pero el tema no la muestra en la página de inicio, página de categoría, o donde esperas verla. Verifica el estado y la categoría de la entrada.
Paso fallido — lo más común:
- Error del lado de WordPress — falló la escritura en la base de datos, un plugin vetó la inserción. El mensaje de error del paso señala la excepción subyacente.
- Guardado como borrador en lugar de publicado — en casos raros Structura guarda la entrada como borrador pendiente de revisión (p. ej., políticas de moderación, algunos plugins de SEO). Verifica la lista Entradas → Todas las entradas incluyendo los Borradores.

”Omitimos una entrada duplicada” / la ejecución se detuvo en Publicar

Si el paso de Publicar de la ejecución falló y el mensaje indica que la entrada habría reutilizado una dirección web que ya publicas, Structura la detuvo a propósito.

Dos entradas en la misma dirección no pueden existir a la vez, por lo que la segunda habría salido en vivo con una URL casi idéntica (.../tu-tema-2). En la práctica, esas dos páginas compiten entre sí en Google, y la más nueva generalmente pierde mientras arrastra hacia abajo a la más antigua — por lo que una entrada programada que haría esto se omite en lugar de publicarse. También recibirás un aviso de Palabras clave en el ícono de campana que nombra la campaña.

Nada está roto y nada se ha perdido. Significa que la campaña se ha quedado sin terreno genuinamente nuevo que cubrir. Abre Campaigns → [tu campaña] → Editar y selecciona Agregar palabra clave o Redescubrir, y la próxima entrada programada cubrirá algo nuevo. Consulta Palabras clave objetivo.

Esto solo aplica a las entradas que Structura publica en su propio horario. Si solicitas una entrada tú mismo con Generate Now, Structura asume que lo quisiste así y la publica en una dirección numerada.

”Entregando mediante un método de respaldo” / tu sitio bloqueó la entrega directa

A veces un plugin de seguridad, firewall, sistema anti-bot o capa de caché en tu servidor intercepta el webhook de Structura — la solicitud que entrega tu entrada terminada a WordPress. En lugar de llegar a WordPress, se encuentra con una página de desafío (un CAPTCHA, una verificación de bot, o una respuesta en caché/bloqueada). Esto es más común en hosts administrados con protección agresiva contra bots.

Tu entrada no se ha perdido. Cuando Structura detecta que la entrega directa fue bloqueada, cambia automáticamente a un método de entrega de respaldo: tu sitio silenciosamente obtiene la entrada terminada de Structura en lugar de esperar a que sea enviada. Verás que la ejecución permanece en Entregando por un momento breve, y la entrada generalmente aparece en pocos minutos. La generación de imágenes y todo lo demás siguen funcionando — nada del producto está bloqueado.

Por lo tanto, la advertencia que ves es un aviso, no un fallo. El único inconveniente del método de respaldo es que la entrega es ligeramente más lenta que el envío instantáneo.

Restaurar la entrega instantánea (opcional pero recomendado). Para volver a la publicación inmediata, añade el webhook de Structura a la lista de permitidos para que tu servidor deje de desafiarlo o almacenarlo en caché. Una vez que sea accesible nuevamente, Structura vuelve automáticamente a la entrega instantánea en la próxima ejecución — no necesitas cambiar nada manualmente.

El endpoint en tu sitio es /wp-json/structura/v1/webhook/receive-blueprint.
En los ajustes de seguridad / anti-bot / firewall de tu servidor (o mediante un ticket de soporte), excluye esa ruta de los desafíos de bot y CAPTCHAs. Una exclusión basada en la ruta es más confiable que añadir una dirección IP a la lista de permitidos, ya que la dirección desde la que proviene la solicitud puede cambiar.
Si ejecutas un plugin de caché o una caché a nivel de servidor, excluye la misma ruta del caché también.

Si no estás seguro de dónde están esos ajustes, el equipo de soporte de tu servidor puede hacerlo en un minuto — diles: “Un webhook API legítimo de servidor a servidor a /wp-json/structura/v1/webhook/receive-blueprint está siendo interceptado por tu protección contra bots / firewall. Por favor, añade este endpoint a la lista de permitidos.” Luego ejecuta Generate Now de nuevo.

Paso 7: ¿El fan-out de canales fue exitoso?

Incluso si una entrada fue publicada en WordPress, puede que esperes verla en Slack / LinkedIn / etc. En el detalle de ejecución, el paso de Canales tiene un resultado por canal. Los fallos de canal también generan avisos para el usuario en el ícono de campana. Consulta Un canal muestra “fallido” para solucionar esa capa.

Si nada de esto aplica

Contacta con soporte con:

El nombre de la campaña.
El día/hora aproximado en que esperabas la entrada.
El ID de ejecución de la campaña (visible en la URL de la vista de detalle de ejecución).
Cualquier ID de aviso abierto del ícono de campana.