Sincronización Automática

Tokko Plugins automatiza la sincronización de propiedades mediante un sistema de programación confiable basado en Action Scheduler, una librería de WordPress que ejecuta tareas en horarios específicos sin depender de cron jobs externos.

Cómo Funciona la Sincronización Automática

Sistema de Programación

El plugin utiliza Action Scheduler para crear y ejecutar tareas programadas:

┌─────────────────────────────────────┐
│  Sincronización Automática Activada │
└──────────────┬──────────────────────┘
               │
               ├─→ Action Scheduler crea la tarea
               │
               ├─→ Verifica si es momento de ejecutar
               │
               ├─→ Ejecuta sincronización
               │   (Detect → Execute → Archive → Finalize)
               │
               └─→ Registra resultado y reprograma

Detección de Cambios

Antes de sincronizar, el sistema verifica:

Conexión a Tokko Broker - ¿El servidor de Tokko responde?
Salud del servidor - ¿Hay recursos suficientes?
Cambios pendientes - ¿Hay propiedades modificadas desde la última sincronización?

Si todo es correcto, procede con la sincronización inteligente.

Configurar la Frecuencia de Sincronización

Opciones Disponibles

Tokko Plugins ofrece múltiples opciones de frecuencia programada:

Frecuencias Predefinidas
Intervalo Personalizado

Opción	Intervalo	Caso de Uso
Deshabilitada	N/A	Solo sincronización manual
Cada hora	60 minutos	Propiedades con cambios frecuentes
Cada 6 horas	360 minutos	Actualizaciones moderadas
Cada 12 horas	720 minutos	Actualizaciones diarias parciales
Diaria	1,440 minutos	Estándar recomendado (se ejecuta 1x al día)
Semanal	10,080 minutos	Pocos cambios en propiedades
Quincenal	20,160 minutos	Catálogo muy estable
Mensual	43,200 minutos	Catálogo prácticamente estático

Cambiar la Frecuencia

Accede a Configuración

Ve a Tokko Plugins → Configuración General

Busca Frecuencia de Sincronización

En la sección Sincronización, encontrarás Frecuencia de Sincronización

Selecciona nueva frecuencia

Elige de la lista desplegable o selecciona “Personalizada”

Si es personalizada, ingresa minutos

En el campo Intervalo Personalizado, ingresa el número de minutos

Guarda los cambios

Haz clic en Guardar Configuración

Verifica la programación

El sistema re-programará la próxima ejecución automáticamente

Los cambios de frecuencia entran en efecto inmediatamente. La próxima ejecución se programará según la nueva configuración.

Action Scheduler: La Tecnología Detrás

¿Qué es Action Scheduler?

Action Scheduler es una librería de WordPress que:

No requiere cron externo - Funciona dentro de WordPress
Es altamente confiable - Reintenta tareas fallidas automáticamente
Es escalable - Maneja miles de tareas sin problemas
Se integra nativamente - Usa bases de datos estándar de WordPress

Ventajas de Action Scheduler

Fiabilidad
Flexibilidad
Visibilidad

Reintentos automáticos en caso de fallos
Registro completo de cada ejecución
Manejo de transacciones para evitar pérdida de datos
Recuperación automática si se interrumpe

Monitorear Tareas Programadas

Acceder al Monitor de Tareas

Abre Tokko Plugins

Ve a Tokko Plugins en el menú lateral de WordPress

Selecciona Sincronización

Haz clic en Sincronización → Monitor de Tareas

Revisa el estado

Verás una lista de todas las tareas programadas

Información Mostrada

Para cada tarea programada, verás:

Información	Significado
Nombre de tarea	Identificador único de la tarea
Estado	Pendiente, En ejecución, Completada, Fallida
Próxima ejecución	Fecha y hora de la próxima sincronización
Última ejecución	Cuándo se ejecutó por última vez
Frecuencia	Intervalo de repetición
Acciones	Botones para ejecutar, editar o eliminar

Interpretación del Estado

Pendiente (Pending) - Esperando ser ejecutada
En Ejecución (Running) - Se está ejecutando en este momento
Completada (Completed) - Se ejecutó exitosamente
Fallida (Failed) - Hubo un error durante la ejecución
Cancelada (Cancelled) - La tarea fue cancelada manualmente

Las tareas fallidas no se eliminan automáticamente. Puedes revisar el error y reintentarlas.

Controlar Tareas Programadas

Ejecutar Tarea Inmediatamente

Si necesitas sincronizar sin esperar a la próxima ejecución programada:

Abre el Monitor de Tareas

Ve a Tokko Plugins → Sincronización → Monitor de Tareas

Encuentra la tarea

Busca la tarea de sincronización de propiedades

Haz clic en Ejecutar Ahora

Se iniciará la sincronización inmediatamente

Espera a que complete

Monitorea el progreso en el panel

Pausar Tareas Automáticas

Para detener temporalmente todas las sincronizaciones automáticas:

Abre Configuración

Ve a Tokko Plugins → Configuración

Cambia Frecuencia a Deshabilitada

Selecciona Deshabilitada en “Frecuencia de Sincronización”

Guarda los cambios

Todas las tareas automáticas se pausarán

Cuando pausas las tareas automáticas, las propiedades no se actualizarán hasta que habilites la sincronización nuevamente.

Reanudar Tareas

Para reactivar la sincronización automática:

Abre Configuración

Ve a Tokko Plugins → Configuración

Selecciona una frecuencia

Elige cualquier opción excepto “Deshabilitada”

Guarda los cambios

Las tareas se reprogramarán automáticamente

Reintentar Tarea Fallida

Si una sincronización falló, puedes intentarla nuevamente:

Abre el Monitor

Ve a Tokko Plugins → Sincronización → Monitor de Tareas

Encuentra la tarea fallida

Busca el estado “Fallida”

Haz clic en Reintentar

Se ejecutará nuevamente

Revisa el resultado

Si falla de nuevo, consulta los logs para el mensaje de error

Expresiones Cron Avanzadas

Si eres desarrollador y necesitas un control más granular, puedes usar expresiones cron estándar:

Formato de Cron

┌───────────── minuto (0 - 59)
│ ┌───────────── hora (0 - 23)
│ │ ┌───────────── día del mes (1 - 31)
│ │ │ ┌───────────── mes (1 - 12)
│ │ │ │ ┌───────────── día de la semana (0 - 6) (domingo a sábado)
│ │ │ │ │
│ │ │ │ │
* * * * *

Ejemplos Útiles

# Todos los días a las 9:00 AM (hora local)
0 9 * * *

# Todos los días a las 6:00 PM (18:00)
0 18 * * *

# Sincroniza cada 6 horas (0:00, 6:00, 12:00, 18:00)
0 0,6,12,18 * * *

# Sincroniza cada 3 horas
0 0,3,6,9,12,15,18,21 * * *

# Solo lunes y viernes
0 9 * * 1,5

# Lunes a viernes (días de semana)
0 9 * * 1-5

# Solo el primer día de cada mes
0 0 1 * *

# Cada 2 horas entre 9 AM y 5 PM
0 9-17/2 * * *

# Cada 30 minutos
*/30 * * * *

Para usar expresiones cron personalizadas, necesitarás acceso al archivo de configuración de Tokko Plugins o código personalizado. Contacta a soporte si necesitas ayuda.

Optimizar la Programación

Elegir la Mejor Frecuencia

Considera estos factores:

Poco Cambio (Semanal o Mensual)
Cambio Moderado (Diaria)
Cambio Frecuente (Cada 6 horas o menos)

Mejor para:

Catálogo inmobiliario estable
Pocos cambios de precios
Propiedades alquiladas a largo plazo

Ventajas:

Bajo uso de recursos
Servidor más rápido
Facturas de hosting más bajas

Horarios Óptimos

Para minimizar impacto en el rendimiento del sitio:

Sincroniza en horas de bajo tráfico

Si tu sitio es más activo entre 9 AM - 6 PM, sincroniza en madrugada

Evita picos de tráfico

No programes durante tus horarios de mayor actividad

Considera zonas horarias

Si sirves múltiples zonas horarias, elige una que minimice impacto

Monitorea el rendimiento

Revisa la salud del servidor después de cambiar frecuencia

Solucionar Problemas de Programación

”Las tareas no se ejecutan”

Posibles causas:

Action Scheduler deshabilitado
Problemas con el loopback HTTP (localhost)
Firewall bloqueando peticiones internas
Plugin en conflicto

Soluciones:

Verifica que Action Scheduler esté activo en tu WordPress
Intenta ejecutar una tarea manualmente
Revisa los logs de PHP para errores
Desactiva plugins de seguridad temporalmente
Contacta a tu proveedor de hosting

”Las tareas se ejecutan pero no funcionan”

Posibles causas:

API Key inválida
Permisos insuficientes
Timeout durante ejecución

Soluciones:

Verifica que la API Key sea válida (intenta sincronizar manualmente)
Aumenta el timeout de PHP (max_execution_time)
Revisa los logs de sincronización
Reduce la cantidad de propiedades a sincronizar

”Las tareas se ejecutan a horarios erráticos”

Posibles causas:

Reloj del servidor desincronizado
Zona horaria incorrecta
Action Scheduler tiene tareas pendientes

Soluciones:

Verifica que la zona horaria de WordPress sea correcta
Sincroniza el reloj del servidor con ntpdate
Intenta ejecutar la tarea manualmente para limpiar la cola
Revisa la base de datos (wp_actionscheduler_actions)

“Recibo errores de timeout frecuentemente”

Posibles causas:

Sincronización de demasiadas propiedades
Servidor lento
Imágenes de muy alta resolución

Soluciones:

Aumenta max_execution_time en php.ini
Incrementa el intervalo de sincronización
Optimiza tamaño de imágenes en Tokko Broker
Considera un hosting más potente

Si cambias max_execution_time, hazlo con cuidado. Un valor muy alto podría causar problemas de memoria.

Diferencias: Plan Gratis vs Premium

Plan Gratis

Función	Disponible
Sincronización diaria	✓
Sincronización cada 6 horas	✗
Sincronización cada hora	✗
Intervalo personalizado	Limitado (mínimo 24 horas)
Monitor de tareas	Básico
Reintentos automáticos	✓

Plan Premium

Función	Disponible
Sincronización diaria	✓
Sincronización cada 6 horas	✓
Sincronización cada hora	✓
Intervalo personalizado	Ilimitado (5 minutos - 30 días)
Monitor de tareas	Completo
Reintentos automáticos	✓
Soporte prioritario	✓

Consulta planes y precios para detalles sobre cómo actualizar.

Logs de Sincronización

Acceder a los Logs

Abre Sincronización

Ve a Tokko Plugins → Sincronización

Selecciona Logs

Haz clic en la pestaña Logs de Sincronización

Filtra por fecha

Selecciona el rango de fechas que deseas revisar

Busca errores

Filtra por “Error” para ver solo problemas

Interpretar Logs

Cada entrada de log incluye:

Timestamp - Fecha y hora exacta
Nivel - INFO, WARNING, ERROR
Mensaje - Descripción de qué ocurrió
Propiedades afectadas - Cuáles propiedades se vieron impactadas

Errores Comunes en Logs

Error	Significado	Acción
`API_TIMEOUT`	Tokko Broker respondió lentamente	Reintentar más tarde
`INVALID_API_KEY`	API Key incorrecta	Verificar configuración
`DISK_FULL`	Sin espacio en disco	Liberar espacio
`MEMORY_EXHAUSTED`	Sin memoria disponible	Aumentar límite PHP
`IMAGE_DOWNLOAD_FAILED`	Error descargando imagen	Verificar URL, reintentar

Mejores Prácticas

Monitorea regularmente

Revisa el Monitor de Tareas al menos semanalmente

Mantén logs limpios

Archiva logs antiguos mensualmente para mejor rendimiento

Documenta cambios

Registra cuándo cambias la frecuencia y por qué

Prueba cambios

Realiza pruebas en staging antes de cambios importantes

Recibe alertas

Habilita notificaciones por correo para errores

Contactar al Soporte

Si necesitas ayuda configurando o solucionando problemas de programación:

Prepara información

Ten lista tu configuración actual, logs recientes, y descripción del problema

Contacta a soporte

Ve a soporte.tokkoplugins.com

Proporciona detalles

Incluye capturas del Monitor de Tareas y cualquier mensaje de error

Aguarda respuesta

El equipo de soporte te ayudará a optimizar tu configuración

La sincronización automática bien configurada es la clave para mantener tu catálogo de propiedades siempre actualizado. Tómate tiempo para encontrar la frecuencia correcta para tu negocio.

​Sincronización Automática

​Cómo Funciona la Sincronización Automática

​Sistema de Programación

​Detección de Cambios

​Configurar la Frecuencia de Sincronización

​Opciones Disponibles

​Cambiar la Frecuencia

​Action Scheduler: La Tecnología Detrás

​¿Qué es Action Scheduler?

​Ventajas de Action Scheduler

​Monitorear Tareas Programadas

​Acceder al Monitor de Tareas

​Información Mostrada

​Interpretación del Estado

​Controlar Tareas Programadas

​Ejecutar Tarea Inmediatamente

​Pausar Tareas Automáticas

​Reanudar Tareas

​Reintentar Tarea Fallida

​Expresiones Cron Avanzadas

​Formato de Cron

​Ejemplos Útiles

​Optimizar la Programación

​Elegir la Mejor Frecuencia

​Horarios Óptimos

​Solucionar Problemas de Programación

​”Las tareas no se ejecutan”

​”Las tareas se ejecutan pero no funcionan”

​”Las tareas se ejecutan a horarios erráticos”

​“Recibo errores de timeout frecuentemente”

​Diferencias: Plan Gratis vs Premium

​Plan Gratis

​Plan Premium

​Logs de Sincronización

​Acceder a los Logs

​Interpretar Logs

​Errores Comunes en Logs

​Mejores Prácticas

​Contactar al Soporte

Sincronización Automática

Cómo Funciona la Sincronización Automática

Sistema de Programación

Detección de Cambios

Configurar la Frecuencia de Sincronización

Opciones Disponibles

Cambiar la Frecuencia

Action Scheduler: La Tecnología Detrás

¿Qué es Action Scheduler?

Ventajas de Action Scheduler

Monitorear Tareas Programadas

Acceder al Monitor de Tareas

Información Mostrada

Interpretación del Estado

Controlar Tareas Programadas

Ejecutar Tarea Inmediatamente

Pausar Tareas Automáticas

Reanudar Tareas

Reintentar Tarea Fallida

Expresiones Cron Avanzadas

Formato de Cron

Ejemplos Útiles

Optimizar la Programación

Elegir la Mejor Frecuencia

Horarios Óptimos

Solucionar Problemas de Programación

”Las tareas no se ejecutan”

”Las tareas se ejecutan pero no funcionan”

”Las tareas se ejecutan a horarios erráticos”

“Recibo errores de timeout frecuentemente”

Diferencias: Plan Gratis vs Premium

Plan Gratis

Plan Premium

Logs de Sincronización

Acceder a los Logs

Interpretar Logs

Errores Comunes en Logs

Mejores Prácticas

Contactar al Soporte