Skip to main content

​
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:
  1. Conexión a Tokko Broker - ¿El servidor de Tokko responde?
  2. Salud del servidor - ¿Hay recursos suficientes?
  3. 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:
OpciónIntervaloCaso de Uso
DeshabilitadaN/ASolo sincronización manual
Cada hora60 minutosPropiedades con cambios frecuentes
Cada 6 horas360 minutosActualizaciones moderadas
Cada 12 horas720 minutosActualizaciones diarias parciales
Diaria1,440 minutosEstándar recomendado (se ejecuta 1x al día)
Semanal10,080 minutosPocos cambios en propiedades
Quincenal20,160 minutosCatálogo muy estable
Mensual43,200 minutosCatálogo prácticamente estático

​
Cambiar la Frecuencia

1

Accede a Configuración

Ve a Tokko Plugins → Configuración General
2

Busca Frecuencia de Sincronización

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

Selecciona nueva frecuencia

Elige de la lista desplegable o selecciona “Personalizada”
4

Si es personalizada, ingresa minutos

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

Guarda los cambios

Haz clic en Guardar Configuración
6

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

  • 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

1

Abre Tokko Plugins

Ve a Tokko Plugins en el menú lateral de WordPress
2

Selecciona Sincronización

Haz clic en Sincronización → Monitor de Tareas
3

Revisa el estado

Verás una lista de todas las tareas programadas

​
Información Mostrada

Para cada tarea programada, verás:
InformaciónSignificado
Nombre de tareaIdentificador único de la tarea
EstadoPendiente, En ejecución, Completada, Fallida
Próxima ejecuciónFecha y hora de la próxima sincronización
Última ejecuciónCuándo se ejecutó por última vez
FrecuenciaIntervalo de repetición
AccionesBotones 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:
1

Abre el Monitor de Tareas

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

Encuentra la tarea

Busca la tarea de sincronización de propiedades
3

Haz clic en Ejecutar Ahora

Se iniciará la sincronización inmediatamente
4

Espera a que complete

Monitorea el progreso en el panel

​
Pausar Tareas Automáticas

Para detener temporalmente todas las sincronizaciones automáticas:
1

Abre Configuración

Ve a Tokko Plugins → Configuración
2

Cambia Frecuencia a Deshabilitada

Selecciona Deshabilitada en “Frecuencia de Sincronización”
3

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:
1

Abre Configuración

Ve a Tokko Plugins → Configuración
2

Selecciona una frecuencia

Elige cualquier opción excepto “Deshabilitada”
3

Guarda los cambios

Las tareas se reprogramarán automáticamente

​
Reintentar Tarea Fallida

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

Abre el Monitor

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

Encuentra la tarea fallida

Busca el estado “Fallida”
3

Haz clic en Reintentar

Se ejecutará nuevamente
4

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 * * *
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:
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:
1

Sincroniza en horas de bajo tráfico

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

Evita picos de tráfico

No programes durante tus horarios de mayor actividad
3

Considera zonas horarias

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

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:
  1. Verifica que Action Scheduler esté activo en tu WordPress
  2. Intenta ejecutar una tarea manualmente
  3. Revisa los logs de PHP para errores
  4. Desactiva plugins de seguridad temporalmente
  5. 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:
  1. Verifica que la API Key sea válida (intenta sincronizar manualmente)
  2. Aumenta el timeout de PHP (max_execution_time)
  3. Revisa los logs de sincronización
  4. 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:
  1. Verifica que la zona horaria de WordPress sea correcta
  2. Sincroniza el reloj del servidor con ntpdate
  3. Intenta ejecutar la tarea manualmente para limpiar la cola
  4. 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:
  1. Aumenta max_execution_time en php.ini
  2. Incrementa el intervalo de sincronización
  3. Optimiza tamaño de imágenes en Tokko Broker
  4. 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ónDisponible
Sincronización diaria✓
Sincronización cada 6 horas✗
Sincronización cada hora✗
Intervalo personalizadoLimitado (mínimo 24 horas)
Monitor de tareasBásico
Reintentos automáticos✓

​
Plan Premium

FunciónDisponible
Sincronización diaria✓
Sincronización cada 6 horas✓
Sincronización cada hora✓
Intervalo personalizadoIlimitado (5 minutos - 30 días)
Monitor de tareasCompleto
Reintentos automáticos✓
Soporte prioritario✓
Consulta planes y precios para detalles sobre cómo actualizar.

​
Logs de Sincronización

​
Acceder a los Logs

1

Abre Sincronización

Ve a Tokko Plugins → Sincronización
2

Selecciona Logs

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

Filtra por fecha

Selecciona el rango de fechas que deseas revisar
4

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

ErrorSignificadoAcción
API_TIMEOUTTokko Broker respondió lentamenteReintentar más tarde
INVALID_API_KEYAPI Key incorrectaVerificar configuración
DISK_FULLSin espacio en discoLiberar espacio
MEMORY_EXHAUSTEDSin memoria disponibleAumentar límite PHP
IMAGE_DOWNLOAD_FAILEDError descargando imagenVerificar URL, reintentar

​
Mejores Prácticas

1

Monitorea regularmente

Revisa el Monitor de Tareas al menos semanalmente
2

Mantén logs limpios

Archiva logs antiguos mensualmente para mejor rendimiento
3

Documenta cambios

Registra cuándo cambias la frecuencia y por qué
4

Prueba cambios

Realiza pruebas en staging antes de cambios importantes
5

Recibe alertas

Habilita notificaciones por correo para errores

​
Contactar al Soporte

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

Prepara información

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

Contacta a soporte

Ve a soporte.tokkoplugins.com
3

Proporciona detalles

Incluye capturas del Monitor de Tareas y cualquier mensaje de error
4

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.