Sincronización de Propiedades

Tokko Plugins utiliza un motor de sincronización inteligente que detecta cambios en Tokko Broker y los actualiza automáticamente en tu sitio WordPress. Este sistema está optimizado para minimizar el uso de recursos y maximizar la velocidad de procesamiento.

Cómo Funciona la Sincronización

Motor de Sincronización Unificado

El motor utiliza un sistema de procesamiento por lotes (batch processing) basado en AJAX con detección inteligente de cambios:

Detección (Detect)

El sistema compara timestamps y verifica qué propiedades han cambiado en Tokko Broker desde la última sincronización

Ejecución de Lotes (Execute Batches)

Procesa múltiples propiedades en paralelo, agrupándolas en lotes para optimizar el uso de recursos del servidor

Archivo (Archive)

Archiva las propiedades que han sido eliminadas o marcadas como inactivas en Tokko Broker

Finalización (Finalize)

Registra timestamps, genera reportes y limpia recursos temporales

Detección Inteligente de Cambios

En lugar de sincronizar todas las propiedades cada vez, el sistema utiliza timestamps basados en cambios para sincronizar solo lo que ha sido modificado:

Se comparan marcas de tiempo de creación y modificación
Solo se procesan propiedades con cambios recientes
Se reduce significativamente el ancho de banda y tiempo de procesamiento
Los datos de timestamp se almacenan en una tabla personalizada (wp_thi_property_timestamps)

Esta estrategia inteligente puede reducir el tiempo de sincronización entre un 70-90% comparado con sincronizaciones completas.

Mecanismos de Protección (Circuit Breakers)

El plugin incluye limitadores automáticos para proteger tu servidor:

Limitador	Límite	Acción
Errores API consecutivos	5 errores	Pausa sincronización
Errores de imagen consecutivos	10 errores	Continúa sin imágenes
Memoria disponible	256 MB mínimo	Frena procesamiento
CPU disponible	80% máximo	Reduce velocidad
Espacio en disco	500 MB mínimo	Pausa sincronización

Si el sistema detecta condiciones críticas de servidor, pausará la sincronización automáticamente para evitar caídas. Verás una notificación en el panel.

Qué Se Sincroniza

Campos de Meta de Propiedades

Tokko Plugins sincroniza automáticamente estos campos de propiedades desde Tokko Broker a Houzez:

Información Básica
Ubicación y Contacto
Información Comercial
Características

Dormitorios (bedrooms)
Baños (bathrooms)
Ambientes/Cuartos (rooms)
Garajes (garage)
Tamaño Construido (size) - en metros cuadrados
Tamaño de Terreno (land) - en metros cuadrados

Taxonomías Sincronizadas

Las siguientes categorías y etiquetas se importan automáticamente:

Taxonomía	Descripción	Ejemplo
`property_type`	Tipo de propiedad	Departamento, Casa, Local, Terreno
`property_status`	Estado operacional	Venta, Alquiler, Alquiler Temporal, Emprendimiento
`property_feature`	Características	Piscina, Gym, Seguridad 24/7, Parque
`property_label`	Etiquetas personalizadas	Destacado, Nuevo, Oportunidad
`property_country`	País	Argentina, México, etc.
`property_state`	Provincia/Estado	Buenos Aires, CDMX, etc.
`property_city`	Ciudad	CABA, Monterrey, etc.
`property_area`	Barrio/Zona	Recoleta, Condesa, etc.

Contenido Multimedia

Imágenes

Se descargan y almacenan automáticamente en tu servidor
Se generan miniaturas optimizadas para mejorar velocidad (si está habilitado)
Se respeta el orden de imágenes de Tokko Broker
Las imágenes eliminadas en Tokko Broker se archivan en WordPress

Videos

Se sincronizan enlaces a videos de YouTube o Vimeo
Se incrustan automáticamente en la galería de la propiedad
El plugin genera vistas previas y miniaturas

Tours Virtuales

Tokko Plugins soporta más de 28 proveedores de tours virtuales:

Principales Proveedores
Otros Soportados

Matterport - Tours 3D profesionales
3Dprop - Recorridos 3D
Visita360 - Tours 360°
Roundme - Tours interactivos
Zillow 3D - Recorridos 3D de Zillow

Planos

Se sincronizan planos en PDF o imagen
Se almacenan con la información de la propiedad
Se muestran en una sección dedicada en el detalle de la propiedad

Mapeo de Campos: Tokko → Houzez

Tokko Plugins realiza un mapeo automático entre los campos de Tokko Broker y los campos estándar de Houzez:

{
  "tokko_field": "houzez_field",
  "bedrooms": "property_bedrooms",
  "bathrooms": "property_bathrooms",
  "rooms": "property_rooms",
  "size": "property_size",
  "land": "property_land_area",
  "price": "property_price",
  "currency": "property_currency",
  "year": "property_year_built",
  "condition": "property_condition",
  "reference_code": "property_reference",
  "address": "property_address",
  "latitude": "property_latitude",
  "longitude": "property_longitude"
}

El mapeo es automático. No necesitas configurar manualmente estos campos. El plugin maneja la compatibilidad entre sistemas.

Sincronización Manual

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

Sincronizar Todas las Propiedades

Abre el panel de Tokko Plugins

Ve a Tokko Plugins → Sincronización en tu WordPress

Busca el botón de sincronización

Encontrarás un botón Sincronizar Ahora o Sync Now

Haz clic para iniciar

La sincronización comenzará inmediatamente en segundo plano

Espera a que finalice

Verás una barra de progreso indicando el estado

Sincronizar Propiedad Específica

Para sincronizar una propiedad individual:

Ve a Propiedades

En el menú de WordPress, abre Propiedades

Selecciona la propiedad

Encuentra la propiedad que deseas sincronizar

Busca el botón de sincronización

Debajo del editor, verás Sincronizar con Tokko

Haz clic para sincronizar

Los datos se actualizarán desde Tokko Broker

Controles de Sincronización

Pausar Sincronización

Si necesitas pausar la sincronización automática temporalmente:

Abre Configuración

Ve a Tokko Plugins → Configuración

Cambia la frecuencia

Selecciona Deshabilitado en “Frecuencia de Sincronización”

Guarda los cambios

La sincronización se detendrá

Reanudar Sincronización

Para reanudar después de pausar:

Abre Configuración

Ve a Tokko Plugins → Configuración

Selecciona frecuencia

Elige una frecuencia como “Diaria” o “Cada 6 horas”

Guarda los cambios

La sincronización automática se reanudará

Cancelar Sincronización en Curso

Si una sincronización está en progreso y deseas detenerla:

Abre Sincronización

Ve a Tokko Plugins → Sincronización

Busca el botón Cancelar

Si hay una sincronización activa, verás Cancelar Sincronización

Haz clic para cancelar

El proceso se detendrá (puede tomar unos segundos)

Cancelar una sincronización en curso podría dejar la base de datos en estado inconsistente. Solo hace esto si es absolutamente necesario.

Comportamiento de Archivo

Cuando una propiedad es eliminada o desactivada en Tokko Broker:

No se borra inmediatamente - La propiedad permanece visible en WordPress
Se marca como archivada - El estado de la propiedad cambia a “Archivada”
Se oculta en listados - Por defecto, las propiedades archivadas no aparecen en búsquedas
Es recuperable - Si reactivas la propiedad en Tokko Broker, se sincroniza nuevamente

Las propiedades archivadas no se eliminan permanentemente. Pueden ser recuperadas en cualquier momento.

Reportes de Sincronización

Después de cada sincronización, Tokko Plugins genera un reporte detallado:

Acceder a Reportes

Abre Tokko Plugins

Ve a Tokko Plugins → Sincronización → Reportes

Revisa el reporte más reciente

Verás el reporte de la última sincronización

Expande detalles

Haz clic para ver información detallada de cada propiedad

Información en el Reporte

Cada reporte incluye:

Métrica	Descripción
Propiedades sincronizadas	Cantidad de propiedades procesadas exitosamente
Imágenes descargadas	Total de imágenes importadas
Errores detectados	Cantidad de errores durante la sincronización
Tiempo total	Duración de la sincronización
Timestamp	Fecha y hora de ejecución
Detalles por propiedad	Estado individual de cada una

Detalles de Propiedades

Para cada propiedad sincronizada, verás:

✓ Exitosa - Sincronización completada sin problemas
⚠ Con advertencias - Se sincronizó pero con algunos datos parciales (ej: imágenes faltantes)
✗ Fallida - No se pudo sincronizar (revisa los logs para detalles)

Sincronización de Desarrollos

Los desarrollos (emprendimientos) se sincronizan si está habilitada la opción Sincronizar Emprendimientos:

Abre Configuración

Ve a Tokko Plugins → Configuración → Sincronización

Habilita Desarrollos

Marca la casilla Sincronizar Emprendimientos

Guarda los cambios

Los desarrollos se sincronizarán en la próxima ejecución

Los desarrollos incluyen información del proyecto, etapas, planos y propiedades incluidas. Se sincronizan como un tipo especial de propiedad.

Sincronización de Agentes

Si habilitaste Sincronizar Información de Agentes:

Los datos del agente asignado a cada propiedad se sincronizan automáticamente
Se crea un perfil de agente en WordPress (si no existe)
Las imágenes de agentes se descargan si está habilitada esa opción
Los contactos de WhatsApp se formatan automáticamente

Asegúrate de que tu API Key tenga permisos de lectura de agentes antes de habilitar esta opción.

Límites por Plan

Plan Gratis

Máximo 100 propiedades que se pueden sincronizar
Máximo 2 desarrollos
Sincronización automática limitada a frecuencia diaria
Integraciones de contactos limitadas

Plan Premium

Propiedades ilimitadas
Desarrollos ilimitados
Sincronización automática cada hora
Integraciones de contactos ilimitadas
Soporte prioritario para sincronización

Consulta precios y planes para más información sobre las diferencias entre planes.

Solucionar Problemas de Sincronización

”Sincronización no inicia”

Causas posibles:

API Key inválida o sin permisos
No hay propiedades en Tokko Broker
Problemas de conexión al servidor

Soluciones:

Verifica que la conexión con Tokko Broker funcione
Revisa que existan propiedades activas
Intenta sincronizar manualmente
Revisa los logs de error

”La sincronización es muy lenta”

Causas posibles:

Servidor con recursos limitados
Cantidad muy grande de propiedades
Muchas imágenes de alta resolución
Otros procesos consumiendo recursos

Soluciones:

Aumenta el intervalo de sincronización
Reduce el tamaño de imágenes en Tokko Broker
Optimiza tu servidor WordPress
Contacta a tu proveedor de hosting para aumentar recursos

”Las imágenes no se descargan”

Causas posibles:

Opción “Generar Miniaturas” causando error
Permiso de escritura insuficiente en carpeta de uploads
Servidor sin espacio en disco

Soluciones:

Verifica permisos de carpeta wp-content/uploads
Deshabilita “Generar Miniaturas” temporalmente
Libera espacio en disco
Aumenta límite de memoria de PHP

”Errores de timeout”

Causas posibles:

Sincronización de demasiadas propiedades en paralelo
Servidor lento o sobrecargado
Problemas de conexión de red

Soluciones:

Reduce el número de propiedades procesadas en paralelo
Incrementa el tiempo de timeout en configuración avanzada
Intenta sincronizar en horarios de menor actividad
Contacta a tu proveedor de hosting

Contactar al Soporte

Si experimentas problemas de sincronización que no puedes resolver:

Reúne información

Ten listo el reporte de sincronización más reciente y los logs de error

Accede al soporte

Ve a soporte.tokkoplugins.com

Describe el problema

Proporciona detalles de qué pasó y qué intentaste

Comparte recursos

Adjunta el reporte de sincronización y cualquier captura de pantalla relevante

La sincronización es el corazón de Tokko Plugins. Si está funcionando correctamente, tu sitio siempre tendrá datos actualizados de Tokko Broker.

​Sincronización de Propiedades

​Cómo Funciona la Sincronización

​Motor de Sincronización Unificado

​Detección Inteligente de Cambios

​Mecanismos de Protección (Circuit Breakers)

​Qué Se Sincroniza

​Campos de Meta de Propiedades

​Taxonomías Sincronizadas

​Contenido Multimedia

​Imágenes

​Videos

​Tours Virtuales

​Planos

​Mapeo de Campos: Tokko → Houzez

​Sincronización Manual

​Sincronizar Todas las Propiedades

​Sincronizar Propiedad Específica

​Controles de Sincronización

​Pausar Sincronización

​Reanudar Sincronización

​Cancelar Sincronización en Curso

​Comportamiento de Archivo

​Reportes de Sincronización

​Acceder a Reportes

​Información en el Reporte

​Detalles de Propiedades

​Sincronización de Desarrollos

​Sincronización de Agentes

​Límites por Plan

​Plan Gratis

​Plan Premium

​Solucionar Problemas de Sincronización

​”Sincronización no inicia”

​”La sincronización es muy lenta”

​”Las imágenes no se descargan”

​”Errores de timeout”

​Contactar al Soporte

Sincronización de Propiedades

Cómo Funciona la Sincronización

Motor de Sincronización Unificado

Detección Inteligente de Cambios

Mecanismos de Protección (Circuit Breakers)

Qué Se Sincroniza

Campos de Meta de Propiedades

Taxonomías Sincronizadas

Contenido Multimedia

Imágenes

Videos

Tours Virtuales

Planos

Mapeo de Campos: Tokko → Houzez

Sincronización Manual

Sincronizar Todas las Propiedades

Sincronizar Propiedad Específica

Controles de Sincronización

Pausar Sincronización

Reanudar Sincronización

Cancelar Sincronización en Curso

Comportamiento de Archivo

Reportes de Sincronización

Acceder a Reportes

Información en el Reporte

Detalles de Propiedades

Sincronización de Desarrollos

Sincronización de Agentes

Límites por Plan

Plan Gratis

Plan Premium

Solucionar Problemas de Sincronización

”Sincronización no inicia”

”La sincronización es muy lenta”

”Las imágenes no se descargan”

”Errores de timeout”

Contactar al Soporte