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

# onOffice

> Deja que tu asistente encuentre inmuebles, reserve visitas y registre llamadas en onOffice enterprise.

Tu asistente encuentra inmuebles, responde preguntas sobre ellos, ofrece horarios de visita libres y reserva visitas en tu cuenta de onOffice enterprise. También guarda a los nuevos interesados con su perfil de búsqueda y puede registrar las llamadas terminadas en el registro del agente (Maklerbuch).

> [!NOTE]
>
> El módulo de API de onOffice es un complemento de pago. Pide a tu contacto en onOffice que lo active antes de conectar y consulta cuánto cobra onOffice por el uso de la API.

## Conectar tu cuenta

1. En onOffice enterprise, abre **Extras → Ajustes → Usuario** y crea un **usuario de API** solo para el asistente.
2. Dale al usuario de API estos permisos:

   * Direcciones: lectura y escritura.
   * Inmuebles: lectura.
   * Calendario: escritura.
   * Registro del agente (Maklerbuch): escritura.

   Configura los permisos de lectura para todos los registros, no para «solo propios». Con «solo propios», onOffice responde a las búsquedas con listas vacías.
3. Copia el **token de API** (32 caracteres) y el **secreto de API** (64 caracteres). onOffice muestra el secreto una sola vez. Si la conexión indica que el token y el secreto parecen intercambiados, introdúcelos al revés.
4. Abre **Agent Tools → Marketplace → onOffice**, introduce el token y el secreto y ajusta los valores de abajo si los tuyos difieren de los predeterminados. Elige **Agregar**. La conexión se comprueba antes de guardarla. Después asígnala a tu asistente.

La comprobación al guardar no puede probar los permisos de escritura del calendario y del registro del agente sin escribir algo. Si falta un permiso, la primera reserva o nota falla con un mensaje que lo nombra.

## Qué puede hacer el asistente

Activado por defecto:

* **Buscar inmuebles** por calle, localidad, compra o alquiler, tipo de inmueble, habitaciones, presupuesto o el número del inmueble de un anuncio.
* **Detalles del inmueble**: precio, habitaciones, superficies, planta, año, estado, calefacción, costes, mascotas, descripción y disponibilidad.
* **Horarios de visita libres** en el calendario del agente responsable.
* **Reservar visitas** cuando quien llama lo confirma.
* **Crear interesados** con un perfil de búsqueda cuando quien llama está de acuerdo.
* **Reconocer a quien llama** por su número de teléfono.

Opcional, se elige en **Editar**:

* **Notas de llamada**: escribir una nota sobre una llamada terminada en el registro del agente. Está pensado para automatizaciones, mira más abajo.

## Qué inmuebles ve el asistente

El ajuste **Inmuebles de los que puede hablar el asistente** decide:

* **Publicados en tu sitio web** (predeterminado): inmuebles activos publicados en tu sitio web.
* **Estado de comercialización abierto**: inmuebles activos que no están vendidos ni alquilados ni reservados, publicados o no.

Omite la calle y el código postal cuando «Objektadresse freigeben» está desactivado para el inmueble en onOffice. El asistente nunca lee inmuebles inactivos ni archivados. Indica la disponibilidad: disponible, reservado, vendido o alquilado. Nunca lee en voz alta los números de registro internos. El número externo del inmueble de tus anuncios no supone problema.

## Visitas

El asistente reserva una visita en el calendario del agente responsable del inmueble. Un inmueble sin agente responsable usa el **Agente predeterminado** de los ajustes. Sin ninguno de los dos, el inmueble no se puede reservar y el asistente ofrece una llamada de vuelta del equipo.

* **Horarios:** desde mañana, todos los días, también fines de semana, dentro del **Horario de visitas** (predeterminado 08:00–18:00) en tu zona horaria. Los horarios siguen una cuadrícula de 30 minutos y duran lo que indique la **Duración de la visita** (predeterminado 30 minutos).
* **Horas ocupadas:** cualquier entrada del calendario de ese agente cuenta como ocupada. Las entradas de todo el día bloquean el día entero. Las entradas canceladas no cuentan.
* **Reserva:** el asistente pide nombre y apellido, repite el inmueble, el día y la hora y espera un sí claro. Vuelve a comprobar que el horario sigue libre y crea la cita, vinculada al inmueble y al contacto. Dice «reservado» solo después de que onOffice lo haya confirmado.
* **Contactos:** se reutiliza un contacto con el número de quien llama. Varios contactos con un mismo número se distinguen por el apellido. Si no, se crea un contacto nuevo, con correo electrónico solo si quien llama dio uno.
* **Números ocultos:** quienes ocultan su número no pueden reservar. El asistente ofrece una llamada de vuelta.

La cita usa el **Tipo de cita para las visitas** de los ajustes (predeterminado `Besichtigung`). Su nota indica quién la reservó, con tu marca.

Un tiempo de espera agotado no demuestra que una reserva haya fallado. Las solicitudes repetidas están protegidas contra reservas duplicadas. Si el asistente informa de un resultado desconocido, revisa el calendario del agente antes de volver a reservar.

## Interesados

Cuando alguien busca un inmueble, el asistente recoge nombre y apellido, compra o alquiler y todo lo que la persona indique: localidad, tipo de inmueble, habitaciones y presupuesto. Tras un sí claro, guarda a quien llama como contacto y añade un perfil de búsqueda con esos deseos.

* Se reutiliza un contacto con el mismo número en lugar de duplicarlo.
* No se escribe ningún correo electrónico salvo que quien llama haya dado uno. No hay una dirección de relleno.
* El perfil solo contiene criterios que tu cuenta de onOffice ofrece como criterios de búsqueda.
* Si onOffice rechaza el perfil, el contacto se conserva y el asistente dice que el equipo añadirá los deseos.

## Notas de llamada en el Maklerbuch

Las notas de llamada están desactivadas para los asistentes. Usa la plantilla de automatización **Registrar llamadas en onOffice** (**New → Start from template**, categoría CRM): después de cada llamada entrante con resumen, se buscan en onOffice los contactos con el número de quien llamó, hasta tres, y se escribe una nota en su registro del agente. La nota empieza con «Call with» y tu marca, seguidos del resumen y la duración de la llamada.

* Activa las **Notas de llamada** para la conexión en **Automatizaciones → Conexiones**: están desactivadas por defecto, y la plantilla falla hasta que lo hagas. Usa una conexión creada allí, no una importada desde la herramienta del agente, para que el asistente no reciba las notas de llamada.
* La **Clase de acción** y el **Tipo de acción** de las notas de llamada (predeterminados `Telefonat` y `Eingang`) deben existir en onOffice. Si no existen, la conexión se guarda igualmente, pero las notas de llamada se rechazan con una indicación.
* Quienes llaman y no están en onOffice no reciben nota.
* El enlace de la llamada no se escribe.
* Las plantillas no aparecen en los espacios de trabajo de clientes de un revendedor. Crea la misma automatización con la acción **onOffice · Notas de llamada**; el número de teléfono no se introduce, sale de la llamada.

La plantilla cubre las llamadas entrantes. Para las salientes, crea tú la automatización con la misma acción; se usa el número marcado.

## Reconocer a quien llama

Cuando el número de quien llama coincide exactamente con un contacto activo, el asistente le saluda por su nombre. Si varios contactos comparten el número, pregunta el apellido. Si el número está oculto o es desconocido, trata a quien llama como una persona nueva. Los inmuebles son datos públicos y no necesitan comprobación. El asistente nunca lee en voz alta correos electrónicos, números de teléfono o direcciones de tus contactos.

## Ajustes

Cámbialos en **Automatizaciones → Conexiones**, o elimina la herramienta y vuelve a conectarla. La reserva, los interesados y las notas de llamada se activan en **Editar** en la herramienta.

| Ajuste | Predeterminado | Significado |
| - | - | - |
| Inmuebles de los que puede hablar el asistente | Publicados en tu sitio web | Qué inmuebles ve el asistente. |
| Agente predeterminado | vacío | Nombre de usuario o ID. Recibe las visitas de los inmuebles sin agente responsable. |
| Tipo de cita para las visitas | `Besichtigung` | Debe coincidir con un tipo de acción para citas en onOffice. |
| Duración de la visita | 30 min | 15, 30, 45, 60 o 90 minutos. |
| Horario de visitas | 08:00–18:00 | Las horas del día que se ofrecen. |
| Clase de acción para las notas de llamada | `Telefonat` | Clase de acción en el registro del agente. |
| Tipo de acción para las notas de llamada | `Eingang` | Tipo de acción en el registro del agente. |
| Zona horaria | `Europe/Berlin` | Se usa para el horario de visitas y las horas de las citas. |

## Probar con seguridad

Las reservas, los interesados y las notas son reales. Prueba con un inmueble de prueba, un calendario que puedas limpiar y tu propio número de teléfono, y después elimina la cita de prueba y el contacto de prueba en onOffice. Las simulaciones de texto no llaman a onOffice.

## Canales

La búsqueda y los detalles de inmuebles funcionan en todos los canales. El reconocimiento, las visitas y los interesados usan el número de teléfono que trae la conversación: el teléfono, WhatsApp y los SMS lo tienen. El chat web y el correo electrónico no, así que el asistente ofrece una llamada de vuelta en lugar de reservar.

## Automatizaciones

Cada operación está disponible como acción bajo **onOffice · …**. Conecta **onOffice** en **Automatizaciones → Conexiones**, o importa su conexión de Agent Tools. Una automatización iniciada por una llamada o una conversación de texto conoce el número de la otra persona por esa propia llamada, nunca por los datos del disparador ni por una entrada del paso. Por eso **Notas de llamada** no tiene campo para el teléfono. Las ejecuciones iniciadas de otra forma (webhook, programación) no tienen número: la reserva y los interesados responden que no está disponible, y las notas de llamada no escriben nada. Una ejecución manual solo tiene número si sus datos indican una llamada o una conversación de tu espacio de trabajo. Los disparadores para inmuebles o contactos nuevos aún no están disponibles.

## API, MCP, CLI & SDK

`POST /api/v1/tools/integrations/onoffice` · MCP `connect_integration` · CLI `famulor connect-integration onoffice`.

La herramienta empieza con la búsqueda de inmuebles, las visitas y los interesados activados. `client.api.connectIntegration` necesita `famulor-sdk` 0.2.12 o posterior. Actualiza la CLI con `npm install --global famulor` antes de usar `connect-integration`.

```bash theme={null}
famulor connect-integration onoffice --name onoffice --fields "{\"api_token\":\"$OO_TOKEN\",\"api_secret\":\"$OO_SECRET\"}"
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: tool } = await client.api.connectIntegration({
  path: { provider: 'onoffice' },
  body: {
    name: 'onoffice',
    fields: { api_token: process.env.OO_TOKEN, api_secret: process.env.OO_SECRET },
  },
});
console.log(tool.id);
```

Los campos opcionales son `estate_rule` (`published` o `open`), `default_agent`, `viewing_type`, `viewing_minutes`, `viewing_hours`, `log_action_kind`, `log_action_type` y `timezone`.

## Solución de problemas

* **«onOffice did not accept the API token, secret or rights.»** Revisa ambos valores, comprueba que el usuario de API esté activo y tenga los permisos de arriba, e introduce el nuevo token y el nuevo secreto si los regeneraste en onOffice.
* **«onOffice rejected the signature.»** El token y el secreto están intercambiados o el secreto se copió incompleto. El token tiene 32 caracteres y el secreto 64.
* **«The server clock is out of sync with onOffice.»** Es algo temporal. Inténtalo de nuevo más tarde.
* **Las búsquedas no encuentran nada aunque los inmuebles existen.** Comprueba que los permisos de lectura abarquen todos los registros y no «solo propios», y que el inmueble encaje con **Inmuebles de los que puede hablar el asistente**.
* **«Check the appointment type.»** Introduce el **Tipo de cita para las visitas** exactamente como se llama el tipo de acción para citas en onOffice.
* **«The action kind or type for call notes does not exist.»** Introduce la **Clase de acción** y el **Tipo de acción** como se llaman en onOffice.
* **«The default agent was not found.»** Introduce el nombre de usuario o el ID de un usuario que onOffice liste para el usuario de API.

[Documentación de la API de onOffice](https://apidoc.onoffice.de/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.