Conexión con Tokko Broker
La API Key es la credencial que permite que Tokko Plugins se comunique de forma segura con tu CRM de Tokko Broker. Sin ella, el plugin no puede sincronizar propiedades, agentes ni contactos.Obtener tu API Key
Paso 1: Accede a Tokko Broker
Abre tu navegador
Ve a la URL de tu cuenta de Tokko Broker (normalmente algo como
https://tuempresa.tokkobroker.com)Paso 2: Navega a la Sección de Integraciones
Paso 3: Copia tu API Key
Localiza tu clave activa
Busca la clave que deseas usar (puede haber múltiples claves para diferentes propósitos)
Configurar la API Key en WordPress
Ingresa tu API Key
Busca el campo API Key
En la sección Configuración General, encontrarás el campo API Key de Tokko Broker
Probar la Conexión
Después de ingresar tu API Key, es importante verificar que la conexión funciona correctamente.Ejecutar Prueba de Conexión
Ubica el botón de prueba
En la sección de API Key, encontrarás un botón Probar Conexión o Test Connection
Resultado Exitoso
Si la conexión es exitosa, verás un mensaje verde similar a:Este mensaje confirma que:
- Tu API Key es válida
- El plugin puede comunicarse con Tokko Broker
- Tu cuenta está activa y tiene permiso para acceder a los datos
Errores Comunes de Conexión
Error: “API Key inválida”
Causa: La clave ingresada no es reconocida por Tokko Broker. Solución:- Verifica que hayas copiado la clave completa sin espacios
- Asegúrate de no haber agregado espacios al principio o al final
- Vuelve a copiar la clave desde Tokko Broker
- Intenta pegar en un editor de texto primero para verificar
Error: “No autorizado (401)”
Causa: La API Key existe pero no tiene permisos suficientes. Solución:- Verifica en Tokko Broker que la clave tenga permisos de lectura y escritura
- Algunos permisos pueden estar deshabilitados (ej: solo lectura)
- Contacta a tu administrador de Tokko Broker para aumentar los permisos
- Crea una nueva clave con todos los permisos necesarios
Error: “Servidor no encontrado”
Causa: No se puede alcanzar el servidor de Tokko Broker. Solución:- Verifica tu conexión a internet
- Asegúrate de que Tokko Broker no está en mantenimiento
- Comprueba que no haya restricciones de firewall
- Espera unos minutos e intenta de nuevo
- Si persiste, contacta al soporte de Tokko Broker
Error: “Límite de solicitudes excedido (429)”
Causa: Has excedido el número de llamadas a la API permitidas. Solución:- Espera entre 5-15 minutos antes de intentar de nuevo
- Reduce la frecuencia de sincronización automática
- Evita hacer múltiples pruebas de conexión consecutivas
- Consulta tus límites de API en Tokko Broker
Error: “Conexión expirada (timeout)”
Causa: La solicitud tardó demasiado en completarse. Solución:- Intenta más tarde (el servidor de Tokko Broker podría estar congestionado)
- Verifica tu ancho de banda disponible
- Revisa la salud de tu servidor WordPress
- Si el problema persiste, aumenta el tiempo de espera en configuración
Renovar o Cambiar tu API Key
Cuándo Renovar tu API Key
Deberías renovar tu API Key en estos casos:- Cambio de personal: Si alguien que tenía acceso ya no trabaja contigo
- Suspicaz seguridad: Si sospechas que la clave ha sido comprometida
- Política de seguridad: Si tu empresa requiere rotación periódica de credenciales
- Migración de sistemas: Cuando cambias de hosting o servidor
Pasos para Renovar
Genera una nueva clave en Tokko Broker
En la sección de Integraciones de Tokko Broker, crea una nueva API Key
Permisos Necesarios de la API Key
Tu API Key debe tener estos permisos habilitados en Tokko Broker:| Permiso | Descripción | Obligatorio |
|---|---|---|
| Lectura de Propiedades | Ver y sincronizar propiedades | Sí |
| Lectura de Imágenes | Descargar fotos de propiedades | Sí |
| Lectura de Agentes | Sincronizar información de agentes | No* |
| Escritura de Contactos | Crear contactos desde el sitio | No* |
| Lectura de Desarrollos | Sincronizar proyectos inmobiliarios | No* |
Si planeas usar funciones adicionales (agentes, contactos, desarrollos), asegúrate de que tu API Key tenga los permisos correspondientes.
Seguridad y Mejores Prácticas
Protege tu API Key
Guarda en lugar seguro
No almacenes la clave en archivos de texto sin encriptar o en correos electrónicos
Usa variables de entorno
Para instalaciones avanzadas, considera usar archivo
.env con variables de entornoAuditoría de API
Tokko Broker mantiene un registro de todas las llamadas realizadas con tu API Key. Puedes revisar:- Número de solicitudes realizadas
- Datos accedidos
- Errores o intentos fallidos
- Horarios de acceso
Solucionar Problemas Avanzados
Conexión funciona pero la sincronización falla
Si la prueba de conexión es exitosa pero las propiedades no se sincronizan:- Verifica que tu API Key tenga permisos de lectura de propiedades
- Comprueba que existan propiedades activas en Tokko Broker
- Revisa el log de sincronización para más detalles
- Intenta sincronizar manualmente desde el panel
Múltiples API Keys
Si tienes varias API Keys en Tokko Broker:- Solo puedes usar una por vez en el plugin
- Elige la que tenga todos los permisos necesarios
- Si necesitas cambiar, actualiza en configuración e intenta de nuevo
Contactar al Soporte
Si después de seguir estos pasos aún tienes problemas:Reúne información
Ten lista tu API Key (sin compartirla), el mensaje de error exacto y capturas de pantalla
Contacta a Tokko
Dirígete a soporte.tokkobroker.com