Documentación · Solución de problemas
Resolver el problema correcto sin crear un segundo.
Empiece por el componente que ha fallado, conserve el mensaje de error exacto y compruebe qué ha ocurrido ya en WordPress antes de repetir una acción. Esta guía le ayuda a diagnosticar SitePublisher AI de forma segura y eficiente.
Para SitePublisher AI Free y Pro · Nunca comparta claves, contraseñas o tokens de acceso
Antes de intentarlo de nuevo
Tres comprobaciones previenen la mayoría de los errores de resolución de problemas
Un mensaje de pantalla fallido no siempre significa que todo el flujo de trabajo haya fallado. Generación de texto, creación de imagen, almacenamiento de cola local y publicación WordPress remota son pasos separados.
Capturar el momento exacto
Copie el mensaje de error completo y note la fecha, hora y zona horaria. Grabe la página, el botón o la acción de cola que utilizó, además de la edición SitePublisher AI y compilar que se muestra en la interfaz.
Ver la lista de verificación de soporte →Compruebe ambos sitios WordPress
Para la publicación remota, inspeccione el sitio web central de SitePublisher AI y el sitio web de destino. Busque el destino por el título exacto y compruebe Publicado, Programada, Borrador y Papelera.
Evitar la publicación duplicada →Abrir Health y registros
Utilice los enlaces del tablero de control SitePublisher AI para las comprobaciones y registros Health. Corrija primero un fallo Health requerido, luego reproduzca el problema una vez e inspeccione el tiempo de registro correspondiente.
Ejecutar los controles técnicos →Controles Health
Corregir fallos de entorno necesarios antes de volver a probar el flujo de trabajo
Un fallo requerido puede evitar que SitePublisher AI comience por completo. La página Health muestra el estado y una breve explicación para cada cheque.
Entorno requerido
Pida al proveedor de alojamiento que cambie la versión PHP cuando esta comprobación falle.
Cree una copia de seguridad y actualice WordPress a través del proceso de mantenimiento normal.
cURL, JSON, Mbstring y OpenSSL deben estar disponibles. Las extensiones que faltan son problemas de nivel de alojamiento.
Servicios de complementos y almacenamiento
Si una clase requerida no puede cargar, vuelva a instalar el mismo paquete oficial después de hacer una copia de seguridad. No mezcle carpetas de complementos manualmente.
Ambos directorios deben existir y ser escribibles. Su host puede corregir la propiedad del archivo o los permisos sin exponer credenciales.
Una instalación de marketing heredada detectada es informacional durante la migración; no es en sí una falla requerida.
¿Quién debería arreglarlo?
Los errores ambientales pertenecen al proveedor de alojamiento.
Enviar al host el nombre y el mensaje de verificación fallidos. Nunca enviar una contraseña WordPress, clave OpenAI o contraseña de aplicación con esa solicitud.
Registros
Reproducir una vez, luego aislar el evento de coincidencia
La página Registros puede filtrar por archivo, gravedad, fuente y texto. Use la ventana de tiempo más pequeña y comparta sólo las líneas necesarias para explicar el fallo.
Reproducir un tiempo controlado
- Limpiar los mensajes de pantalla no relacionados antes del ensayo
- Realizar la acción fallida solo una vez
- Anote la hora local exacta y la zona horaria
- Mantener el mensaje de error visible para la comparación
Restringir la vista de registro
- Elija el archivo de registro relevante y el límite de entrada reciente
- Comience con advertencias, errores y niveles críticos
- Buscar por fuente, título del artículo o texto de error
- Utilizar solo 15, 30 o 60 segundos de auto-refrigeración durante las pruebas
Abrir los detalles de forma segura
- Usar Ver detalles para el contexto de evento correspondiente
- Incluya sólo la marca de tiempo, fuente y mensaje útiles
- Redacte dominios o identificadores cuando no sean relevantes
- Nunca copiar claves, contraseñas, tokens o cabeceras de autorización
Coincidir con el síntoma
Use la lista de verificación para el paso que realmente falló
Resolver la causa subyacente antes de seleccionar Retry. Un artículo exitoso, imagen o mensaje remoto no se debe generar una segunda vez simplemente para reparar un error de contabilidad posterior.
Ningún artículo o imagen de AI
Abra OpenAI API Configuración y confirme que la clave está configurada. Compruebe la cuenta OpenAI para facturación, créditos disponibles o límites de uso. Autenticación y errores de cuota requieren una clave o corrección de cuenta; límites de velocidad, tiempos de espera y errores temporales del servidor pueden ser juzgados después de esperar.
Abra la guía API →Sitio web o categorías no se conectarán
Confirme la dirección HTTPS, el acceso WordPress REST y la contraseña de aplicación dedicada. La cuenta autenticada debe ser capaz de editar publicaciones. Para una lista de categorías 403 o vacía, también compruebe el alojamiento separado WAF, incluso si ha eliminado el complemento de seguridad WordPress. Siga la lista de verificación HTTP 403 y el firewall de alojamiento.
Compruebe la guía de conexión →Fallo en la publicación remota
Lea el mensaje HTTP devuelto antes de cambiar nada. Confirme que la cuenta de destino puede crear el estado solicitado, y que el REST API acepta mensajes y medios. Si las credenciales almacenadas ya no se pueden descifrar, introduzca una nueva contraseña de aplicación en Website Settings.
Compruebe primero un resultado existente →Falla una imagen seleccionada o generada
Confirme que el adjunto de Media Library todavía existe y que su archivo es legible. SitePublisher AI rechaza datos de imagen ilegibles, no soportados o sobredimensionados. En un trabajo de cola, un fallo de imagen preserva el artículo completado y lo mueve a revisar en lugar de descartar el texto.
Revisar las opciones de imagen →Bulk Automation se detiene o necesita atención
Compruebe si el proceso se ha detenido deliberadamente, esperando, procesando, en revisión o falló. Lea el error de nivel de fila. Reanudar un proceso interrumpido sólo cuando esté listo; Reintentar es para un fallo resuelto. Eliminar un registro de cola recuperable no elimina publicaciones o medios de WordPress publicados.
Diagnosticar la cola →Un puesto programado es tarde
Compare la zona horaria central, la zona horaria de destino y la vista previa aprobada de UTC. Permita el período de gracia de recuperación de diez minutos y luego utilice Check & Recover programmes. También inspeccione WordPress Site Health para eventos tardíos o solicitudes de loopback fallidas.
Fiabilidad de la programación abierta →Solución de problemas de conexión · HTTP 403
Cuando un firewall de alojamiento bloquea la conexión de su sitio web
Esta guía se aplica a las conexiones remotas del sitio web en SitePublisher AI Pro. Free publica en el sitio web actual; estas comprobaciones no añaden acceso remoto al sitio web a Free.
Un 403 no significa automáticamente una contraseña incorrecta
Puede ver “Verificación de credenciales devuelta HTTP 403” antes de que aparezca cualquier categoría. SitePublisher AI verifica primero el usuario autenticado de WordPress y el permiso de edición, luego recupera categorías. Un firewall puede bloquear esa primera solicitud antes de que WordPress compruebe la credencial.
Una página de error HTML sugiere un servidor o una capa de seguridad, pero no identifica la causa por sí misma. Coincide con la solicitud fallida en los registros de alojamiento. Una página de categoría pública activa o una conexión exitosa de otro servicio no prueba que esta conexión esté permitida.
El alojamiento de seguridad está separado de un complemento WordPress
Defender es un plugin de seguridad WordPress. Un Firewall de aplicaciones web de alojamiento (WAF) puede filtrar las solicitudes antes de que lleguen a WordPress. Eliminar Defender no apaga el WAF separado del host.
Por lo tanto, dos sitios web pueden comportarse de manera diferente incluso con los mismos plugins WordPress y la configuración SitePublisher AI. Compruebe la configuración de firewall de alojamiento de cada destino en lugar de suponer que los ajustes son idénticos en sus sitios web.
Encontrar la petición bloqueada exacta
En WPMU DEV, abra el destino en The Hub y compruebe Hosting → Registros → WAF. La configuración del cortafuegos está bajo Hosting → Herramientas → Aplicación Web Firewall; las etiquetas pueden variar.
Coincidir con el tiempo de prueba y zona horaria, ruta de solicitud, IP de origen e ID de regla. La ruta de verificación es /wp-json/wp/v2/users/mecon context=edit y los campos de usuario solicitados. Su agente de usuario es “SitePublisher AI verificación de credenciales”.
Pida al anfitrión una corrección dirigida
Enviar soporte de alojamiento de la regla de coincidencia ID, tiempo de solicitud, destino, ruta y fuente IP. Pídales que revisen la solicitud autenticada legítima y aplicar la excepción más estrecha adecuada para ese destino, regla y solicitud. WordPress autenticación y verificación de permisos deben permanecer activos.
Si la lista de permisos IP es apropiada, la dirección relevante es la IP del servidor saliente de la instalación central de SitePublisher AI. Un botón “Allowlist my IP” puede en su lugar seleccionar la dirección de Internet de su navegador. El host debe confirmar la IP de origen real y si se comparte o cambia.
Guardar una entrada en la lista de permisos IP no es una prueba de que la solicitud esté permitida. Si sigue fallando, pida soporte para comprobar por qué no se aplicó la excepción. No siga borrando y recreando la conexión del sitio web guardado.
Conocida regla WPMU DEV: 225170
En un caso confirmado de soporte, la regla 225170 bloqueó la solicitud de verificación del usuario e informó de “Vulnerabilidad de revelación de información sensible en WordPress 4.7 (CVE-2017-5487)”. Ese texto identifica la regla; no establece que el sitio web ejecute WordPress 4.7 o haya sido comprometido.
En ese caso, agregar la IP de origen no restauró la recuperación de categoría, mientras que temporalmente apagar el alojamiento WAF lo hizo. Esto aisló el firewall de alojamiento como la capa de bloqueo. Por qué la excepción de IP no se aplicó quedó sin resolver; otros sitios web sin que WAF habilitado no se vieron afectados.
Después de la corrección del host, asegúrese de que el WAF está activado y se ejecuta Actualizar todas las categorías de nuevo. La recuperación de categorías no prueba que la creación de post o medios funciona: compruebe un borrador revisado y su imagen antes de iniciar una ejecución masiva.
Referencias: WPMU Guía DEV sobre solicitudes REST bloqueadas y registros WAF · WordPress Application Passwords y resolución de problemas de autenticación.
Importante antes de volver a publicar
WordPress puede que ya contenga el artículo o los medios.
Una solicitud remota puede tener éxito antes de que falle una actualización posterior de estado local, informe o registro de enlaces. Busque el sitio web de destino por el título exacto e inspeccione Published, Programada, Borrador y Basura antes de enviar el artículo de nuevo.
Fiabilidad de la programación
Comprender lo que la recuperación automática cambiará y no cambiará
SitePublisher AI Pro verifica los horarios automáticos de WordPress aprobados después del tiempo previsto. Protege los cambios deliberados realizados directamente en el destino.
La recuperación automática puede
- Compruebe el puesto remoto después del horario más diez minutos
- Reconocer un post que se publica normalmente
- Publicar un post que todavía está genuinamente marcado como futuro
- Mostrar estado recuperado, pendiente o fallido de recuperación en la cola
Recuperación automática no lo hará
- Publicar antes del tiempo aprobado y el período de gracia
- Anular una publicación movida a Borrador, privada o basura
- Deshacer una fecha de publicación posterior establecida en WordPress
- Recuperar un post sin un identificador de post remoto grabado válido
Preparar una solicitud de soporte
Enviar suficiente contexto para reproducir el problema, sin enviar acceso
Un informe enfocado es más rápido de investigar que una exportación completa de registro. Incluye un problema, un intento controlado y el más pequeño conjunto útil de detalles técnicos.
Incluir estos detalles
SitePublisher AI Free o Pro, número de construcción, versión WordPress y versión PHP.
La página, el botón y el destino involucrados, además de lo que esperaba que sucediera.
El error desinfectado completo, el tiempo exacto y la zona horaria, y si un puesto remoto o imagen ya existe.
Una captura de pantalla relevante y un evento de registro correspondiente. Incluya un identificador de cola o artículo sólo cuando sea útil.
Nunca incluyas estos secretos
El soporte puede diagnosticar la autenticación sin ver el valor secreto.
No pegue credenciales de WordPress, alojamiento, base de datos o correo electrónico.
Redacte tokens al portador, cookies de sesión, códigos de recuperación y cabeceras de solicitud.
Nunca envíe los datos de la tarjeta o datos personales del cliente no relacionados en una solicitud de diagnóstico.
¿Todavía bloqueado?
Envíe el informe preparado a través de la página de contacto.
Elija un tema claro, describa un problema reproducible y mencione las comprobaciones que ya ha completado.
Preguntas frecuentes sobre la solución de problemas
Respuestas seguras antes de cambiar nada
Mantenga intactas las partes exitosas de un flujo de trabajo y cambie sólo la capa que realmente falló.
¿Debo reinstalar el complemento primero?
No. Comience con las comprobaciones y registros Health. Reinstale sólo cuando el autocargador o los archivos de paquete estén incompletos, y utilice el mismo paquete oficial después de hacer una copia de seguridad.
¿Debo seguir presionando Retry?
No. Lea el error de nivel de fila y primero corrija su causa. Los intentos repetidos pueden gastar créditos API adicionales o crear contenido remoto duplicado.
¿Y si el artículo existe en el destino?
No lo vuelva a publicar. Guarde la URL de la publicación e informe el error local posterior para que el problema restante de estado o de contabilidad pueda investigarse por separado.
¿Puedo enviar una clave o contraseña para que el soporte pueda probar?
No. El soporte SitePublisher AI no debe necesitar sus valores secretos. Reemplace una credencial comprometida inmediatamente con el proveedor que la emitió.
¿Qué pasa si todo el sitio web de WordPress no está disponible?
Póngase en contacto con el proveedor de alojamiento primero. Una interrupción completa, la extensión PHP falta, fallo del permiso del sistema de archivos o problema de cron del servidor requiere acceso a nivel de alojamiento.
¿Por qué se dejó intacto un artículo programado?
El servicio de recuperación respeta los cambios deliberados en WordPress. Un puesto alejado del estado futuro o reprogramado para más adelante no es forzado en vivo.
Continuar con la documentación
Siguiente: actualización y gestión de una licencia
Descubra cómo la edición comercial, el estado de la licencia y las actualizaciones seguras del producto encajan en su instalación SitePublisher AI.