> For the complete documentation index, see [llms.txt](https://prometheo.gitbook.io/prometheo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prometheo.gitbook.io/prometheo/integraciones/tokko.md).

# Tokko

## 🏠 Integración con **Tokko** (Inmobiliarias / Real Estate)

La integración con Tokko está pensada específicamente para **inmobiliarias** y permite que tu asistente de Prometheo responda consultas usando información **real y actualizada** de tus propiedades.

***

### 1) ¿Qué es la integración con Tokko?

Es una integración que conecta Prometheo con tu cuenta de Tokko para que el asistente pueda:

* Leer en tiempo real la información de tus propiedades.
* Usar datos como precio, moneda, tipo de operación, ubicación, cantidad de ambientes, superficie, estado, amenities y disponibilidad.
* Responder consultas de interesados con información concreta y confiable.
* Recomendar propiedades según lo que el cliente esté buscando.

Una vez conectada, Prometheo:

* “Aprende” todo tu inventario de propiedades.
* Sincroniza la información **automáticamente cada 2 horas**, para mantenerla siempre actualizada.

***

### 2) Qué necesitás de Tokko: la API Key

Tokko expone los datos de tu cuenta a través de una **API Key**, que es una clave única.

Para obtenerla:

1. Ingresá a tu panel de **Tokko**.
2. Andá a la sección **Mi Empresa**.
3. Entrá en **Permisos**.
4. Buscá la sección **API Key**.
5. Copiá el código completo que aparece ahí.

Esa API Key es la que vas a usar en Prometheo.

Si no la encontrás:

* Revisá bien las secciones de ajustes y permisos en Tokko.
* O pedile ayuda a tu agente de Tokko para que te indique dónde verla o te la comparta.

***

### 3) Cómo conectar Tokko dentro de Prometheo

Con la API Key lista, seguí estos pasos en Prometheo:

1. Entrá a **Conexiones → Integraciones**.
2. Buscá **Tokko**.
3. Hacé clic en Tokko.
4. Pegá la **API Key** de Tokko.
5. Hacé clic en **Conectar**.

Cuando hacés esto:

* Prometheo se comunica con Tokko usando esa clave.
* Descarga la información de todas tus propiedades activas.
* A partir de ahí, la sincronización se hace sola cada 2 horas.

Desde ese momento, tu asistente ya tiene acceso a todo tu inventario.

***

### 4) Configurar el asistente para que use Tokko (prompt)

La integración por sí sola no alcanza: es clave indicarle al asistente **cómo** debe usar Tokko.

Pasos:

1. Andá a **Asistentes**.
2. Editá tu asistente principal (o creá uno nuevo).
3. En el campo de **Instrucciones / Prompt**, agregá algo como:

> “Eres el asistente comercial de nuestra inmobiliaria.\
> Usa SIEMPRE la información de las propiedades integradas desde Tokko para responder consultas.\
> Cuando un usuario pregunte por compra, venta o alquiler, consultá Tokko (ubicación, tipo de propiedad, ambientes, superficie, precio, moneda, amenities, estado y disponibilidad).\
> Respondé con un resumen claro de las mejores opciones, indicando zona, precio, ambientes y características relevantes.\
> Si el usuario no brinda suficiente información, primero hacé preguntas calificadoras (presupuesto, zona, tipo de propiedad, cantidad de ambientes).\
> Nunca inventes propiedades ni datos: si no hay opciones que coincidan, explicalo y ofrecé alternativas cercanas.”

4. Guardá los cambios.

Cuanto más claro y específico sea este texto, mejor va a responder el asistente.

***

### 5) Cómo va a responder el asistente usando Tokko

Con Tokko conectado y el prompt bien configurado, el flujo real es el siguiente:

* Un usuario escribe algo como:\
  “Busco un 3 ambientes en Palermo para comprar, hasta 150.000 dólares.”
* El asistente:
  * Interpreta intención, zona, tipo de operación, ambientes y presupuesto.
  * Consulta Tokko para buscar propiedades que coincidan o se acerquen.
  * Responde con 2 o 3 opciones reales, usando datos reales del sistema.

Si faltan datos, el asistente puede:

* Hacer preguntas adicionales (cochera, tipo de financiación, barrio específico, etc.).
* Ajustar las recomendaciones según el inventario disponible.

***

### 6) Buenas prácticas para que funcione bien

Para sacarle el máximo provecho:

En Tokko:

* Tener las propiedades bien cargadas.
* Completar correctamente barrios, precios, tipo de operación y ambientes.
* Mantener actualizado el estado (disponible, reservada, vendida).

En el prompt del asistente:

* Aclarar qué operaciones manejás (venta, alquiler, temporario).
* Indicar prioridades, por ejemplo:
  * “Mostrá solo las 3 mejores opciones.”
  * “Si el presupuesto no alcanza, ofrecé alternativas cercanas y acláralo.”
* Definir el siguiente paso:
  * pedir datos de contacto
  * proponer agendar una visita

***

### 7) Cómo probar que la integración esté funcionando

Una vez conectado Tokko y configurado el asistente:

1. Andá a la solapa **Testing** en Prometheo.
2. Simulá consultas típicas de clientes.
3. Verificá que las respuestas coincidan con tu inventario real.
4. Luego probalo con una o dos consultas reales en producción.

Si notás que:

* No aparecen propiedades que sabés que existen, o
* Las respuestas son incoherentes,

revisá primero:

* Que la API Key esté bien cargada.
* Que las propiedades estén activas y bien completas en Tokko.
* Que el prompt sea claro (muchas veces el problema está ahí, no en la integración).

### 8) Creación automática de leads en Tokko desde Prometheo

Además de usar Tokko para **consultar propiedades y responder preguntas**, Prometheo ahora también puede **crear leads directamente en Tokko** de forma automática.

#### ¿Cómo funciona esta lógica?

La creación de leads **no se hace para todas las conversaciones**, sino únicamente cuando se cumple una condición clara:

> **Cuando una conversación recibe ciertos Smart Tags que vos definís, Prometheo crea automáticamente el lead en Tokko.**

Esto permite que:

* El asistente primero **converse y califique** al interesado.
* Solo cuando el lead está realmente calificado, se cree en Tokko.
* Evitar cargar leads fríos o irrelevantes en tu CRM inmobiliario.

***

#### Dónde se configura

Dentro de Prometheo:

1. Andá a **Conexiones → Integraciones → Tokko**.
2. En el modal de configuración de Tokko, vas a ver una sección para **seleccionar Smart Tags**.
3. Elegí uno o varios Smart Tags que, al aplicarse a una conversación, deben **disparar la creación del lead en Tokko**.
4. Guardá la configuración.

Desde ese momento, la integración queda activa.

***

#### Qué pasa cuando se aplica el Smart Tag

Cuando una conversación recibe uno de los Smart Tags configurados:

* Prometheo crea automáticamente un **lead nuevo en Tokko**.
* El lead se crea con **todos los datos disponibles** del contacto en ese momento.

Si el lead ya existía en Tokko, la integración puede **actualizar la información** en lugar de crear un duplicado, según los criterios de Tokko.