> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Attio Tu recepcionista puede reconocer a quienes llaman si ya están en Attio, añadir a nuevos contactos como personas con su nombre y número de teléfono, y dejar una nota con lo que querían para que tu equipo pueda hacer seguimiento. Hay dos formas de conectarlo: * Las **[herramientas de webhook](#option-1-webhook-tools-recommended)** llaman directamente a la API de Attio, sin necesidad de una cuenta de Zapier ni de usar tareas de Zapier. * Las acciones de **[Zapier](#option-2-zapier)** inician sesión en Attio por ti, pero cada acción usa tareas de tu plan de Zapier. Usa las herramientas de webhook a menos que no puedas conseguir que un administrador de Attio cree un token de acceso. ## Opción 1: Herramientas de webhook (recomendada) ### Crea un token de acceso Debes ser administrador de Attio. Selecciona el menú desplegable junto al nombre de tu espacio de trabajo, abre **Workspace settings**, ve a la pestaña **Developers** y selecciona **New access token**. Asígnale un nombre, por ejemplo `Reception.ai`, y dale solo los permisos que necesitan estas herramientas: lectura de configuración de objetos (`object_configuration:read`), lectura y escritura de registros (`record_permission:read-write`) y lectura y escritura de notas (`note:read-write`). Las etiquetas en Attio pueden diferir ligeramente de estos nombres. El token no caduca y puede ver a todas las personas de tu espacio de trabajo. Elimínalo en Attio si se filtra. ### Crea las herramientas de webhook Para cada [herramienta de abajo](#find-the-caller), ve a **Integrations**, selecciona **Add integration** y elige **Webhook Tool**. Todas las herramientas envían la misma cabecera: `Authorization` (Secret), configurada como `Bearer ` seguido de tu token. ### Añade una regla Añade una [regla](/docs/es/reception-ai/receptionist/rules-and-procedures) que indique a tu recepcionista que use Attio solo para reconocer a quienes llaman y nunca les lea registros ni notas. ### Busca a quien llama | Campo | Valor | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nombre** | `find_attio_person` | | **Descripción** | "Busca a quien llama entre nuestras personas en Attio por número de teléfono. Úsalo al inicio de una llamada. Pasa el record_id de la persona a la herramienta de notas." | | **Método** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records/query` | | **Cabeceras de la solicitud** | `Authorization` (Secret): `Bearer ` seguido de tu token | | **Parámetros del cuerpo** | `filter` (objeto, obligatorio), con el campo de abajo `limit` (entero, valor fijo): `5` | | **Asignar a agentes** | **Receptionist** | Selecciona **Add field** en `filter` y añade: * `phone_numbers` (cadena, obligatorio, de la conversación): "El número de teléfono de quien llama en formato internacional, por ejemplo +14155550123." Attio solo devuelve personas cuyo número guardado coincide exactamente, así que guarda los números con su código de país. ### Añade a quien llama | Campo | Valor | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nombre** | `create_attio_person` | | **Descripción** | "Añade a quien llama como persona, solo cuando `find_attio_person` no la haya encontrado. Pasa el record_id de la nueva persona a la herramienta de notas." | | **Método** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records` | | **Cabeceras de la solicitud** | `Authorization` (Secret): `Bearer ` seguido de tu token | | **Parámetros del cuerpo** | `data` (objeto, obligatorio), con los campos de abajo | | **Asignar a agentes** | **Receptionist** | Selecciona **Add field** en `data` y añade `values` (objeto, obligatorio). En `values`, añade: * `name` (objeto, obligatorio), con tres campos: * `first_name` (cadena, obligatorio, de la conversación): "El nombre de quien llama." * `last_name` (cadena, obligatorio, de la conversación): "El apellido de quien llama, o una cadena vacía si no lo ha indicado." * `full_name` (cadena, obligatorio, de la conversación): "El nombre y el apellido de quien llama." * `phone_numbers` (matriz, obligatorio, de la conversación): "Exactamente un elemento para el número de teléfono de quien llama." En **Each item**, elige `string`, descrito como "El número de teléfono de quien llama en formato internacional, por ejemplo +14155550123." * `email_addresses` (matriz, de la conversación): "Exactamente un elemento para la dirección de correo electrónico de quien llama. Omítelo si no ha dado ninguna." En **Each item**, elige `string`, descrito como "La dirección de correo electrónico de quien llama." ### Registra una nota | Campo | Valor | | ----------------------------- | -------------------------------------------------------------------------------------------- | | **Nombre** | `add_attio_note` | | **Descripción** | "Anota lo que quería quien llama en su registro de persona antes de que termine la llamada." | | **Método** | POST | | **URL** | `https://api.attio.com/v2/notes` | | **Cabeceras de la solicitud** | `Authorization` (Secret): `Bearer ` seguido de tu token | | **Parámetros del cuerpo** | `data` (objeto, obligatorio), con los campos de abajo | | **Asignar a agentes** | **Receptionist** | Selecciona **Add field** en `data` para cada uno de estos elementos: * `parent_object` (cadena, valor fijo): `people` * `parent_record_id` (cadena, obligatorio, de la conversación): "El record_id de la persona de `find_attio_person` o `create_attio_person`." * `title` (cadena, obligatorio, de la conversación): "Un título breve, por ejemplo: Llamada de Jane Doe sobre un presupuesto." * `format` (cadena, valor fijo): `plaintext` * `content` (cadena, obligatorio, de la conversación): "Lo que quería quien llama, en unas pocas frases." El objeto principal y el formato son valores fijos, por lo que las notas siempre se añaden a una persona, aunque la IA envíe otros valores. > **Warning** > > `find_attio_person` devuelve todo lo que esté guardado en la persona. Mantén la regla para que tu > recepcionista use Attio solo para reconocer a quien llama y quienes llaman nunca escuchen datos de otra persona. Selecciona **Enable** en cada herramienta y, después, [prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) con una llamada desde un número guardado en una persona de Attio y luego como una persona nueva que solicita que le devuelvan la llamada. La nueva persona y una nota aparecerán en Attio. ## Opción 2: Zapier ### Conecta Zapier Si aún no lo has hecho, conecta [Zapier](/docs/es/reception-ai/integrations/zapier) en Reception.ai. ### Añade las acciones de Attio En tu servidor MCP de Zapier en [mcp.zapier.com](https://mcp.zapier.com), añade las [acciones de abajo](#zapier-actions) de la aplicación **Attio** y conecta tu espacio de trabajo de Attio. Para cada campo, configura un valor fijo o deja que la IA lo complete, según se indique. ### Asigna las herramientas En Reception.ai, abre la pestaña **Tools** de la integración de Zapier, selecciona **Refresh tools** y asigna cada acción según se indica. ### Añade una regla Añade una [regla](/docs/es/reception-ai/receptionist/rules-and-procedures) que indique a tu recepcionista que use Attio solo para reconocer a quienes llaman y nunca les lea registros ni notas. > **Warning** > > Zapier actúa como el usuario de Attio que conectó el espacio de trabajo y puede ver todo lo que ese usuario puede ver. > Conéctate con un miembro cuyo acceso esté limitado a los registros que necesita tu recepcionista y mantén la > regla para que quienes llaman nunca escuchen datos de otra persona. ### Pruébalo [Prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) con una llamada desde un número guardado en una persona de Attio y luego como una persona nueva que solicita que le devuelvan la llamada. La nueva persona y una nota aparecerán en Attio. ### Acciones de Zapier #### Busca a quien llama | Campo | Valor | | ---------------------------- | --------------------------------------------------------------------- | | **Acción de Zapier** | **Find Records** | | **Configurar en Zapier** | El objeto: People. El atributo por el que buscar: número de teléfono. | | **Dejar que la IA complete** | El valor que buscar: el número de teléfono de quien llama. | | **Asignar a** | **Client** | #### Añade a quien llama | Campo | Valor | | ---------------------------- | ----------------------------------------------------------------------------- | | **Acción de Zapier** | **Create Record** | | **Configurar en Zapier** | El objeto: People. Cualquier atributo que deba ser siempre igual, si lo usas. | | **Dejar que la IA complete** | Nombre, apellido, número de teléfono y dirección de correo electrónico. | | **Asignar a** | **Client** | #### Registra una nota | Campo | Valor | | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | **Acción de Zapier** | **Create Note** | | **Configurar en Zapier** | El objeto principal: People. | | **Dejar que la IA complete** | El ID del registro principal (de las acciones anteriores), un título y el texto de la nota con lo que necesita quien llama. | | **Asignar a** | **Client** | > **Tip** > > Independientemente de la opción que uses, añade un [procedimiento](/docs/es/reception-ai/receptionist/rules-and-procedures) > para que tu recepcionista busque primero a quien llama, cree una persona solo si no encuentra ninguna coincidencia > y después registre una nota. ## Limitaciones * Attio comprueba que los números de teléfono sean válidos. Indica a tu recepcionista, en la descripción de la herramienta o acción, que envíe los números en formato internacional, como `+14155550123`. * La creación de una persona falla cuando otra ya tiene el mismo valor único, como una dirección de correo electrónico. Tu recepcionista debe buscar primero. * Las tareas creadas mediante Zapier no se pueden vincular a un registro de Attio, así que usa la nota para los detalles de la llamada. * Con Zapier, cada acción que ejecuta tu recepcionista usa tareas de tu plan de Zapier. Actualmente, Zapier cuenta dos tareas por cada llamada correcta; las llamadas fallidas no se contabilizan. Cuando se agota el plan, las acciones se detienen hasta que se restablece. ## Solución de problemas | Problema | Qué comprobar | | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 o 403 de Attio | Empieza el valor de la cabecera con `Bearer ` y un espacio, y comprueba que el token tenga los permisos anteriores y no se haya eliminado. | | Una acción de Attio no aparece en Reception.ai | Selecciona **Refresh tools** en la integración de Zapier después de añadir acciones en Zapier. | | Una acción muestra **Changed** y no se usa | La editaste en Zapier. Selecciona **Update** en la pestaña **Tools**. | | No se encuentra a quienes ya conocemos | Comprueba que los números estén guardados con su código de país. Con Zapier, comprueba que **Find Records** busque en el objeto People por número de teléfono. | | Falla la creación de una persona | Puede que el número de teléfono no esté en formato internacional o que la dirección de correo electrónico de quien llama ya esté guardada. | | Las notas no están vinculadas a quien llama | Tu recepcionista necesita el ID de registro de la herramienta de búsqueda o creación, o de **Find Records** o **Create Record** en Zapier. |