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

# Attio

> Sincroniza personas en ambos sentidos con Attio, registra las conversaciones en el timeline de Attio y envía plantillas de WhatsApp desde los workflows y los registros de Attio.

La integración con Attio mantiene tus contactos al día entre Attio y Ciarem. Las personas (People) de Attio se convierten en contactos de Ciarem que las plantillas, la IA y la Bandeja de entrada pueden usar. Las conversaciones y los envíos de plantillas aparecen en el timeline de la persona en Attio, y tu equipo puede enviar plantillas de WhatsApp desde los workflows de Attio y desde el registro de una persona. Los administradores la configuran en **Configuración > Integraciones > Attio**.

Ciarem funciona con un solo CRM a la vez: puedes conectar HubSpot, Attio o [RD Station CRM](https://help.ciarem.ai/es/integrations/rdstation.md), solo uno de ellos. Para cambiar, primero desconecta el que tienes.

## Planes

Attio está incluido en **Growth** y **Scale**, y durante la prueba gratuita. No está incluido en **Solo**. No puedes elegir Solo mientras Attio siga conectado: desconéctalo primero, o elige Growth o Scale. Consulta [Planes y facturación](https://help.ciarem.ai/es/billing/plans-and-billing.md).

Si tu prueba termina o tu suscripción se detiene, Attio sigue conectado pero no se sincroniza nada en ningún sentido. Cuando te suscribes a Growth o Scale, la sincronización se reanuda sola. Un contacto que editaste en Ciarem mientras la sincronización estaba detenida llega a Attio la próxima vez que cambie.

## Conectar Attio

**1. Abre la integración con Attio**

Ve a **Configuración**, luego a **Integraciones**, y haz clic en **Conectar** en la tarjeta de Attio.

**2. Aprueba el acceso en Attio**

Inicia sesión en Attio, elige tu workspace y aprueba el acceso de Ciarem. Esto también instala la app de Ciarem en tu workspace de Attio. Hasta que la app de Ciarem esté en la App Store de Attio, Attio muestra un aviso de que la app no ha sido aprobada. Haz clic en **Allow** para continuar.

**3. Termina de configurar Attio**

De vuelta en Ciarem, una configuración de tres pasos te pide tus etapas del funnel, tu mapeo de atributos y el propietario del contacto, y tus filtros de importación. Haz clic en **Finalizar** para guardarla y empezar la sincronización. No se sincroniza nada hasta que la termines, así tus elecciones aplican desde la primera persona.

Si cierras la configuración, la integración muestra **Configuración parcial**. Haz clic en **Terminar configuración** para volver a ella. Después de la configuración, puedes cambiar cualquier cosa en las pestañas **Etapas del funnel**, **Mapeo de atributos**, **Filtros de importación** y **Tareas** (y **Empresas**, cuando aparece), y luego hacer clic en **Guardar cambios**.

### Qué agrega Ciarem a Attio

Al conectar se agrega un atributo de texto a People en Attio, **Ciarem contact ID**. Al activar [Empresas](#empresas) se agrega otro a Companies, **Ciarem company ID**. Ciarem escribe ahí su propio ID para mantener cada registro de Attio vinculado a su contacto o empresa en Ciarem, así que no edites ni elimines estos atributos. Ciarem no crea, edita ni elimina ningún otro atributo de People o Companies, ni ningún estado.

## Mientras Attio está conectado

Los contactos se gestionan en Attio. La sección **Contactos** se oculta en Ciarem, y las variables de plantilla usan los datos sincronizados desde Attio. En la Bandeja de entrada, el panel de detalles de una conversación muestra la **Última sincronización con Attio** y un enlace **Ver en Attio**.

## Qué se sincroniza

* **Personas, en ambos sentidos.** Aquí se sincronizan las personas (People), y también las [empresas](#empresas) cuando el complemento está activo. Los negocios no se sincronizan. Una persona de Attio se importa cuando tiene un número de teléfono válido con su código de país. Un contacto creado o editado en Ciarem se escribe en Attio (nombre, correo, teléfono e Instagram) cuando Ciarem conoce su nombre o su correo. Un contacto que solo tiene un número de teléfono no se envía. Si ya existe en Attio una persona con el mismo correo, Ciarem se vincula a esa persona en lugar de crear una nueva. Cuando Ciarem escribe un correo, Attio puede crear o vincular por su cuenta una empresa a partir del dominio del correo. Cuando una persona tiene varios correos o teléfonos, Ciarem usa el primer correo y el primer teléfono válido. Cuando Ciarem escribe un correo o un teléfono en Attio, lo agrega a la lista de la persona y nunca quita los demás.
* **Se sincronizan automáticamente.** Nombre, correo, teléfono, ciudad e Instagram se sincronizan en cada persona sin necesidad de mapeo.
* **Mapeo de atributos.** En la pestaña **Mapeo de atributos**, elige atributos de Attio para traerlos a propiedades de contacto de Ciarem, así las plantillas y la IA pueden usarlos. Elige una propiedad de Ciarem para cada uno, o **Crear desde Attio** para crear una igual. Los atributos mapeados se sincronizan de Attio a Ciarem. Cada propiedad mapeada necesita una **Descripción para la IA**: de ella la IA aprende qué significa la propiedad y cuándo usarla, así que escríbela como una instrucción.
* **Filtros de importación.** En la pestaña **Filtros de importación**, agrega condiciones para elegir qué personas se importan. Solo se agregan las personas que cumplen todas las condiciones. Sin filtros, se importa a todos los que tienen un teléfono válido. Las personas que ya están en Ciarem se siguen sincronizando.
* **Propietario del contacto.** En **Propietario del contacto**, elige el atributo de Attio que indica el propietario. Desde ese momento el propietario se sincroniza en ambos sentidos, para los compañeros cuyo correo es miembro de tu workspace de Attio. Elige **No sincronizar propietarios** para dejarlos fuera.
* **Etapas del funnel.** En la pestaña **Etapas del funnel**, elige un atributo de estado de People en Attio. Sus estados pasan a ser tus etapas en Ciarem. Attio es dueño de los estados y de su orden, así que se agregan, renombran o reordenan en Attio. Describe cada etapa para que la IA sepa cuándo un contacto pertenece ahí. Para que la IA pueda mover contactos a una etapa, haz clic en el botón **IA apagada** junto a ella (todas las etapas menos la primera) y elige qué agentes pueden mover contactos ahí y cuándo. Cuando la IA mueve un contacto en una conversación real, Ciarem escribe el nuevo estado en la persona en Attio. El Playground solo muestra el movimiento; no lo escribe. Hasta que elijas un atributo, las etapas del funnel están apagadas.
* **Tareas, en ambos sentidos.** **Sincronizar tareas** (pestaña **Tareas**) está activo salvo que lo apagues. Mientras está activo, las [tareas](https://help.ciarem.ai/es/using-ciarem/tasks.md) de un contacto y las tareas de la persona en Attio se mantienen iguales: título y nota, fecha de vencimiento y si están completadas. Las tareas que Ciarem crea en Attio no tienen responsable, y la prioridad y el tipo no se sincronizan. Attio no permite editar el texto de una tarea, así que cambiar el título o la nota de una tarea en Ciarem reemplaza la tarea en Attio. Las tareas de Attio se importan solo cuando están vinculadas a una persona sincronizada con Ciarem.
* **Conversaciones en el historial.** Las conversaciones abiertas y resueltas, y las plantillas de WhatsApp enviadas, aparecen en la pestaña Activity de la persona en Attio, con un enlace de vuelta a Ciarem. Attio las agrupa en **automation events** en la pestaña Activity: haz clic para verlas.

> [!NOTE]
>
> Las entradas en la línea de tiempo necesitan las actividades personalizadas de Attio. Si tu workspace no las tiene, la página de Attio en Ciarem muestra **Las entradas en la línea de tiempo están apagadas**, y las entradas aparecen cuando tu workspace las tenga. Todo lo demás se sincroniza con normalidad.

### ¿Todavía no tienes un atributo de estado?

Las personas de Attio no traen un atributo de estado. Si no tienes uno, la pestaña **Etapas del funnel** te lo indica. En Attio, abre People, agrega un atributo de tipo Status (por ejemplo Etapa del lead) con tus etapas y vuelve para elegirlo.

Si más adelante cambias a otro atributo, tus etapas se reemplazan por sus estados, los contactos se vuelven a ubicar según su estado en Attio y se pierden los ajustes de IA de las etapas actuales.

## Empresas

Las empresas también se sincronizan con Attio, cuando se cumplen dos cosas:

1. **Activa el complemento Empresas** en **Ajustes > Complementos**. Consulta [Empresas](https://help.ciarem.ai/es/using-ciarem/companies.md).
2. **Termina la configuración de Attio.** No hay nada que reconectar: si Attio ya estaba conectado, las empresas empiezan a sincronizarse solas en pocos minutos después de activar el complemento (la pestaña **Empresas** lo indica).

Attio es donde se gestionan tus empresas. La página **Empresas** sigue oculta en Ciarem, igual que con HubSpot, pero las empresas aparecen en el panel de detalles de un contacto en la Bandeja de entrada, y la IA y las variables de los mensajes las usan.

* **Empresas y sus campos.** Cada empresa de Attio se importa con su nombre y su dominio. El dominio se sincroniza en ambos sentidos: una empresa que creas en Ciarem se agrega a Attio, o se vincula a la empresa de Attio que ya tiene ese dominio.
* **Mapeo de atributos de empresa.** En la pestaña **Empresas**, en **Mapeo de atributos de empresa**, elige atributos de empresa de Attio para traerlos a propiedades de empresa de Ciarem, así las plantillas y la IA pueden usarlos. Elige una propiedad de Ciarem para cada uno, o **Crear desde Attio** para crear una igual. Los atributos mapeados se sincronizan de Attio a Ciarem.
* **Propietario de la empresa.** En **Propietario de la empresa**, elige el atributo de empresa de Attio que indica el propietario. Attio no tiene un atributo de propietario estándar para las empresas, así que al principio no hay ninguno elegido y los propietarios quedan fuera hasta que elijas uno. El propietario se sincroniza entonces en ambos sentidos, para los compañeros cuyo correo es miembro de tu workspace de Attio.
* **La empresa de una persona.** La Company (empresa) de una persona en Attio es la **empresa principal** de ese contacto en Ciarem, y al revés: cuando haces principal a otra empresa en Ciarem, pasa a ser la Company de la persona en Attio. Attio guarda una sola empresa por persona, así que las demás empresas que vincules a un contacto se quedan solo en Ciarem y nunca se envían a Attio. Una empresa vinculada por la IA llega a Attio solo cuando una persona confirma el vínculo.
* **Empresas a partir de dominios de correo.** Attio crea empresas por su cuenta a partir del dominio del correo de una persona, y vincula a la persona con una cuando no tiene ninguna. Esas empresas se importan a Ciarem como cualquier otra. Es un ajuste propio de Attio; para desactivarlo, ve en Attio a **Settings > Workspace > Email and calendar > Record creation**. Desactivarlo no elimina nada de lo que ya existe.
* **Sin vinculación automática por dominio.** Mientras Attio esté conectado, Ciarem no vincula contactos con empresas por el dominio del correo, porque lo hace Attio.
* **Eliminar una empresa en Attio.** La empresa se queda en Ciarem, con sus contactos y sus campos, y deja de estar vinculada a Attio. Una empresa que sigue vinculada a Attio no se puede eliminar en Ciarem: elimínala en Attio.

Si el dominio de una empresa ya pertenece a otra empresa en Ciarem, el dominio se deja como estaba.

## Contactos no importados

Algunas personas de Attio no se pueden crear en Ciarem. Una vez terminada la configuración, la página de Attio en Ciarem las lista en **Contactos no importados**, cada una con el motivo y un enlace **Abrir en Attio** para que la corrijas ahí:

* **Teléfono ya usado**: otro contacto en Ciarem ya tiene este número de teléfono.
* **Correo ya usado**: otro contacto en Ciarem ya tiene este correo.
* **Instagram ya usado**: otro contacto en Ciarem ya tiene este usuario de Instagram.
* **Teléfono inválido**: la persona no tiene un número de teléfono que Ciarem pueda usar. Agrega uno con su código de país, por ejemplo +52.

Corrige a la persona en Attio, por ejemplo fusionando los duplicados o corrigiendo el valor, y se sincroniza sola.

## Enviar WhatsApp desde Attio

La app de Ciarem en tu workspace de Attio agrega dos formas de enviar una plantilla de WhatsApp aprobada. Las dos envían a través de Ciarem, así que la persona ya debe estar sincronizada con un contacto de Ciarem. Attio las muestra en inglés.

* **Paso de workflow.** En un workflow de Attio, agrega el paso **Send WhatsApp template**. Elige la persona en **Person** (normalmente la que inició el workflow), la línea en **WhatsApp line** y la plantilla en **Template**. Solo aparecen las plantillas aprobadas que Ciarem puede completar. En **Variable values (JSON)**, da un valor por cada variable de la plantilla, como texto o como una referencia `{{contact.…}}` que Ciarem completa, por ejemplo `{"1": "{{contact.first_name}}"}`. Si las variables de la plantilla tienen nombre, usa el nombre como clave, por ejemplo `{"contact_first_name": "{{contact.first_name}}"}`. El paso termina como **Sent**, o con un error que explica qué falló.
* **Desde el registro de una persona.** En una persona de Attio, abre el menú **More** (⋯), busca la app de Ciarem y elige **Send WhatsApp template**. También está en el menú de comandos de Attio (CMD+K). Elige una línea y una plantilla, completa los valores de las variables y haz clic en **Send**.

## Fusionar personas en Attio

Cuando fusionas dos personas en Attio, la persona fusionada sigue vinculada a Ciarem. Si las dos estaban vinculadas a contactos distintos de Ciarem, el segundo contacto se desvincula y conserva sus conversaciones; se vuelve a vincular si más adelante coincide con una persona.

## Eliminar una persona en Attio

Eliminar una persona en Attio la desvincula de Ciarem. El contacto de Ciarem y sus conversaciones se conservan.

## Reconectar

Si la app de Ciarem se elimina en Attio, la integración muestra **Necesita reconexión**. Haz clic en **Reconectar** y aprueba el acceso de nuevo. Elige el mismo workspace para conservar tu configuración de sincronización. Si eliges otro workspace, se eliminan la configuración y sus vínculos con contactos.

## Desconectar

**Desconectar** detiene la sincronización y vuelve a mostrar la sección Contactos en Ciarem. Tus contactos, sus conversaciones y tus etapas del funnel se quedan en Ciarem. Tu configuración de sincronización se borra, así que al conectar de nuevo se repite la configuración; si eliges el mismo workspace, los contactos siguen vinculados a sus personas. Tus datos en Attio no se ven afectados. La app de Ciarem sigue en tu workspace de Attio; para quitarla también, desinstálala en la configuración de Attio.


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