Saltar a la navegación

Attio

Reconoce a quien llama, añade personas nuevas y registra notas de llamadas en Attio durante las llamadas.

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 llaman directamente a la API de Attio, sin necesidad de una cuenta de Zapier ni de usar tareas de Zapier.
  • Las acciones de 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)

1

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.

2

Crea las herramientas de webhook

Para cada herramienta de abajo, 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.

3

Añade una regla

Añade una regla 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

CampoValor
Nombrefind_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étodoPOST
URLhttps://api.attio.com/v2/objects/people/records/query
Cabeceras de la solicitudAuthorization (Secret): Bearer seguido de tu token
Parámetros del cuerpofilter (objeto, obligatorio), con el campo de abajo
limit (entero, valor fijo): 5
Asignar a agentesReceptionist

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

CampoValor
Nombrecreate_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étodoPOST
URLhttps://api.attio.com/v2/objects/people/records
Cabeceras de la solicitudAuthorization (Secret): Bearer seguido de tu token
Parámetros del cuerpodata (objeto, obligatorio), con los campos de abajo
Asignar a agentesReceptionist

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

CampoValor
Nombreadd_attio_note
Descripción”Anota lo que quería quien llama en su registro de persona antes de que termine la llamada.”
MétodoPOST
URLhttps://api.attio.com/v2/notes
Cabeceras de la solicitudAuthorization (Secret): Bearer seguido de tu token
Parámetros del cuerpodata (objeto, obligatorio), con los campos de abajo
Asignar a agentesReceptionist

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.

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 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

1

Conecta Zapier

Si aún no lo has hecho, conecta Zapier en Reception.ai.

2

Añade las acciones de Attio

En tu servidor MCP de Zapier en mcp.zapier.com, añade las acciones de abajo 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.

3

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.

4

Añade una regla

Añade una regla que indique a tu recepcionista que use Attio solo para reconocer a quienes llaman y nunca les lea registros ni notas.

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.

5

Pruébalo

Prueba tu recepcionista 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

CampoValor
Acción de ZapierFind Records
Configurar en ZapierEl objeto: People. El atributo por el que buscar: número de teléfono.
Dejar que la IA completeEl valor que buscar: el número de teléfono de quien llama.
Asignar aClient

Añade a quien llama

CampoValor
Acción de ZapierCreate Record
Configurar en ZapierEl objeto: People. Cualquier atributo que deba ser siempre igual, si lo usas.
Dejar que la IA completeNombre, apellido, número de teléfono y dirección de correo electrónico.
Asignar aClient

Registra una nota

CampoValor
Acción de ZapierCreate Note
Configurar en ZapierEl objeto principal: People.
Dejar que la IA completeEl ID del registro principal (de las acciones anteriores), un título y el texto de la nota con lo que necesita quien llama.
Asignar aClient

Independientemente de la opción que uses, añade un procedimiento 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

ProblemaQué comprobar
401 o 403 de AttioEmpieza 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.aiSelecciona Refresh tools en la integración de Zapier después de añadir acciones en Zapier.
Una acción muestra Changed y no se usaLa editaste en Zapier. Selecciona Update en la pestaña Tools.
No se encuentra a quienes ya conocemosComprueba 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 personaPuede 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 llamaTu recepcionista necesita el ID de registro de la herramienta de búsqueda o creación, o de Find Records o Create Record en Zapier.