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

# Objetos personalizados

> Crea los objetos propios de tu negocio (pólizas, vehículos, inmuebles, citas…) y úsalos como cualquier parte del CRM.

Cada negocio maneja cosas distintas: una aseguradora tiene **pólizas**, un concesionario **vehículos**, una clínica **citas**. Con los **objetos personalizados** creas esos objetos en tu CRM, con sus propios datos y etapas, y los conectas con tus contactos, empresas, negocios y tickets.

<CardGroup cols={2}>
  <Card title="Tus propios datos" icon="table-list">
    Defines las propiedades que necesitas: texto, números, dinero, fechas, opciones, personas del equipo, referencias a otros registros y más.
  </Card>

  <Card title="Etapas y tablero" icon="table-columns">
    Si el objeto avanza por etapas (cotizada, vigente, por renovar…), lo ves en un tablero y lo mueves arrastrando.
  </Card>

  <Card title="Conectado a todo" icon="link">
    Relaciona cada registro con contactos, empresas, negocios, tickets u otros objetos.
  </Card>

  <Card title="Automatízalo" icon="bolt">
    Úsalos en bots, automatizaciones, segmentos, campañas, reportes, Mia y la API.
  </Card>
</CardGroup>

## Crear un objeto

Ve a **Ajustes → Objetos personalizados**. Puedes empezar de dos formas:

* **Desde una plantilla:** hay plantillas para más de 20 tipos de negocio (seguros, créditos, salud, concesionarios, talleres, inmobiliarias, educación, turismo, hoteles, gimnasios, logística, e-commerce, legal, SaaS, recursos humanos y más). Cada una trae sus objetos con propiedades, etapas y relaciones listas, y puedes agregar solo los objetos que te sirvan.
* **En blanco:** le das nombre (singular y plural), ícono y color, y eliges si tendrá etapas.

Después, en la configuración del objeto, ajustas:

* **Propiedades:** agrégalas, ordénalas, márcalas como obligatorias o únicas (por ejemplo, el número de póliza) y elige cuáles se ven en la lista y en las tarjetas del tablero.
* **Etapas:** su nombre, color y si son abiertas, de éxito o de pérdida.
* **Relaciones:** con qué se conecta cada registro (contactos, empresas, negocios, tickets u otro objeto) y si es uno o varios.
* **Acceso:** qué puede hacer cada rol (ver más abajo).

<Note>
  Solo los administradores (quienes pueden cambiar los ajustes) crean y configuran objetos. La cantidad de objetos y registros depende de tu plan.
</Note>

## Trabajar con los registros

Cada objeto aparece en el menú del **CRM** con su ícono. Allí puedes:

* Ver los registros en **tabla** o **tablero**, buscar, filtrar por cualquier propiedad, elegir columnas y ordenar.
* **Crear y editar** registros desde un panel lateral, y abrir la **ficha** de cada uno con sus datos, relaciones, notas e historial de cambios.
* Hacer **cambios masivos**: mover de etapa, asignar responsable o borrar varios a la vez.
* **Importar** desde CSV o Excel (y actualizar los que ya existen por una propiedad única) y **exportar** a CSV.
* Recuperar lo borrado desde la **papelera** durante 30 días.

Los registros también aparecen donde trabajas a diario:

* En la ficha del **contacto, la empresa, el negocio y el ticket**, con los registros relacionados y un botón para crear uno nuevo ya vinculado.
* En la **bandeja**, como una pestaña con el ícono del objeto en el panel derecho de la conversación.
* En la **búsqueda global** (Ctrl + K) y en las menciones con @ de **Mia**, que además puede buscar, leer, crear y editar registros (los cambios siempre pasan por tu aprobación).

## Automatizar

* **Automatizaciones:** inícialas cuando **se crea un registro**, **cambia de etapa**, **cambia una propiedad**, **llega una fecha** (X días antes o después de un vencimiento, una cita o una renovación) o un registro **lleva X días estancado** en la misma etapa. Usa los datos del registro y de su contacto en tus mensajes, por ejemplo `{{record_vencimiento}}`.
* **Pasos en bots y automatizaciones:** **Crear registro** (con los datos que recogió el bot, vinculado al contacto), **Actualizar registro** y **Buscar registro**: el cliente escribe, por ejemplo, su número de póliza y el bot la encuentra y responde con sus datos (`{{record.name}}`, `{{record.vencimiento}}`…), o sigue por «No encontrado».
* **Segmentos y campañas:** crea segmentos como «contactos con una póliza que vence este mes» o «contactos sin ninguna póliza» y úsalos en tus campañas. Ver [Segmentos](/es/crm/segmentos).

## Quién puede ver y editar

En la pestaña **Acceso** de cada objeto eliges el nivel de cada rol:

| Nivel | Qué puede hacer |
| - | - |
| **Sin acceso** | No ve el objeto en ninguna parte (menú, búsqueda, fichas, bandeja, Mia ni reportes). |
| **Solo ver** | Ve todos los registros, pero no los cambia. |
| **Solo sus registros** | Ve y edita solo los registros de los que es responsable; lo que crea queda a su nombre. |
| **Ver y editar** | Ve, crea, edita y borra registros. |

Si no configuras un rol, sigue sus permisos del CRM. Los administradores siempre tienen acceso total.

## Reportes

En **Analítica → Objetos** eliges un objeto y un periodo y ves cuántos registros hay abiertos, cuántos se crearon y cerraron (con éxito o perdidos), el tiempo promedio hasta cerrar, la suma de una propiedad de dinero (por ejemplo, el total en primas), el embudo por etapa, los abiertos por responsable y los creados según una propiedad de opciones.

## Objetos que agregan las integraciones

Algunas integraciones agregan su propio objeto a tu CRM. Por ejemplo, [Become Digital](/es/integraciones/become) agrega **Verificaciones de identidad**: un registro por cada verificación, con su estado como etapa. La integración mantiene esos registros al día; tú puedes sumarles tus propias propiedades, notas, relaciones y responsable. Si pausas la integración, el objeto se oculta y sus datos se conservan.

## API y webhooks

Lee y escribe registros desde tus sistemas con la API (`/v1/objects`) y recibe los eventos `record.created`, `record.updated`, `record.stage_changed` y `record.deleted` en tus webhooks. Ver [Webhooks](/es/api/webhooks).


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