> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokkoplugins.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio Rápido

> Configura el plugin en 5 minutos y sincroniza tus primeras propiedades

# Inicio Rápido — 5 Minutos

¿Quieres empezar a sincronizar propiedades de inmediato? Sigue estos pasos sencillos para tener Tokko Plugins funcionando en tu sitio WordPress.

<Steps>
  <Step title="Instala y activa el plugin">
    Tokko Plugins se distribuye como archivo ZIP a través de Freemius. **No está disponible en el directorio oficial de WordPress.**

    1. Ve a [Freemius Dashboard](https://freemius.com) y descarga el ZIP de Tokko Plugins.
    2. En WordPress, ve a **Plugins** → **Añadir nuevo** → **Subir plugin**.
    3. Carga el archivo ZIP y haz clic en **Instalar ahora**.
    4. Cuando termine, haz clic en **Activar plugin**.

    <Tip>
      Si prefieres la instrucción completa con capturas, revisa la guía de [Instalación](/instalacion).
    </Tip>
  </Step>

  <Step title="Verifica que Houzez esté activo">
    El plugin funciona **solo con el tema Houzez**. Compruébalo:

    1. Ve a **Apariencia** → **Temas**
    2. Busca **Houzez** en la lista
    3. Si no está activo, haz clic en **Activar**

    <Warning>
      Si no tienes instalado el tema Houzez, el plugin mostrará una advertencia. Instala y activa Houzez primero, luego vuelve a Tokko Plugins.
    </Warning>
  </Step>

  <Step title="Accede a la configuración del plugin">
    1. En el menú de WordPress, ve a **Tokko Plugins**
    2. Selecciona **Configuración** (o **Settings**)
    3. Verás la sección **Conexión con Tokko Broker**
  </Step>

  <Step title="Obtén tu API Key de Tokko Broker">
    Tu **API Key** es la credencial que conecta WordPress con tu CRM. Para obtenerla necesitas tener rol **Administrador** en tu cuenta de Tokko Broker.

    1. Inicia sesión en [tokkobroker.com](https://www.tokkobroker.com/) con tu usuario Administrador.
    2. Entra a **Mi Empresa** → [tokkobroker.com/company](https://www.tokkobroker.com/company/).
    3. Haz clic en la pestaña **Permisos** → [tokkobroker.com/company/permissions](https://www.tokkobroker.com/company/permissions).
    4. En el apartado **Api Key**, selecciona el código y cópialo.

    <Info>
      **Guía oficial de Tokko Broker:** [¿Cómo saber cuál es la API KEY de mi cuenta?](https://dudas.tokkobroker.com/es/articles/432304-como-saber-cual-es-la-api-key-de-mi-cuenta) — incluye el video explicativo paso a paso.
    </Info>

    <Warning>
      Si no ves la sección **Permisos** o el campo **Api Key**, tu usuario no tiene rol de Administrador. Pide la clave a alguien con ese rol o que te asignen los permisos correspondientes.
    </Warning>
  </Step>

  <Step title="Ingresa el API Key en Tokko Plugins">
    1. En **Tokko Plugins → Configuration**, localiza la tarjeta **API Connection**.
    2. Pega la clave completa que copiaste desde Mi Empresa → Permisos.
    3. Haz clic en **Test Connection** para validar la conexión en vivo.
    4. El badge de la tarjeta pasará a **Connected** (verde) si todo es correcto.

    <Tip>
      Si ves un error, verifica que:

      * La clave esté completa, sin espacios al inicio o final.
      * Tu servidor WordPress tenga cURL habilitado.
      * La cuenta de Tokko Broker esté activa y no haya sido regenerada recientemente (al regenerarla, la clave anterior deja de funcionar inmediatamente).
    </Tip>
  </Step>

  <Step title="Ejecuta la primera sincronización">
    Ahora es el momento de traer tus propiedades a WordPress:

    1. En **Tokko Plugins** → **Sincronización** (o **Sync**)
    2. Haz clic en el botón **Sincronizar Ahora** (o **Sync Now**)
    3. Verás un indicador de progreso: "Descargando propiedades..."

    <Warning>
      **La primera sincronización puede tardar bastante.** Antes de empezar, el dashboard muestra una **estimación de tiempo** basada en la cantidad de propiedades que Tokko Broker te reporta. En la práctica hemos visto que catálogos de \~100 propiedades tardan aproximadamente una hora, y catálogos de 500 o más pueden tardar varias horas, dependiendo del tamaño y cantidad de imágenes, tu hosting y la red.

      Recomendaciones:

      * Deja la sincronización correr en segundo plano; no necesitas mantener el navegador abierto (Tokko Plugins usa Action Scheduler / WP-Cron).
      * Revisa el avance desde **Tokko Plugins → Dashboard**.
      * Las sincronizaciones siguientes solo descargan cambios, así que son mucho más rápidas.
    </Warning>
  </Step>

  <Step title="Verifica que las propiedades se sincronizaron">
    Cuando termine la sincronización:

    1. Ve a **WordPress** → **Propiedades** (o **Properties**)
    2. Deberías ver una lista con tus propiedades de Tokko Broker
    3. Abre una propiedad para verificar que contenga:
       * ✓ Título y descripción
       * ✓ Imágenes/galería
       * ✓ Precio y detalles
       * ✓ Ubicación en mapa

    Si ves tus propiedades, **¡felicitaciones!** Tokko Plugins está funcionando correctamente.

    <Tip>
      Si no ves propiedades:

      * Asegúrate de que Tokko Broker tenga propiedades activas
      * Verifica que el API Key sea válido (paso 5)
      * Mira la sección **Troubleshooting** si necesitas ayuda
    </Tip>
  </Step>
</Steps>

## Próximos pasos

Ahora que tu sitio sincroniza propiedades, considera:

<CardGroup cols={2}>
  <Card title="Personaliza la configuración" icon="palette" href="/configuracion" description="Ajusta URLs, imágenes, campos adicionales y más" />

  <Card title="Configura sincronización automática" icon="clock" href="/configuracion#sincronizacion-automatica" description="Haz que se actualice cada hora, día, etc." />

  <Card title="Mapea campos personalizados" icon="list" href="/configuracion#campos-personalizados" description="Sincroniza campos específicos de tu Tokko" />

  <Card title="Soluciona problemas" icon="bug" href="/troubleshooting" description="Si encuentras errores, mira aquí" />
</CardGroup>

## ¿Tienes dudas?

* 📖 Lee la **[Instalación detallada](/instalacion)** para información técnica
* 🔧 Consulta **[Troubleshooting](/troubleshooting)** para errores comunes
* 📧 Envía un email a **[support@tokkoplugins.com](mailto:support@tokkoplugins.com)**

***

**¡Listo!** Tu catálogo inmobiliario está vivo y sincronizado. 🎉