Integración Affinity n8nAutomatiza Affinity con n8n.

Devuelve una lista de Affinity con sus datos, que es como un flujo comprueba que apunta a la lista correcta antes de escribir nada dentro.

• List ID: el identificador único de la lista que se quiere recuperar. Déjalo fijo si siempre es la misma, o pasa {{ $json.listId }} cuando un nodo anterior haya decidido cuál.

Recupera las listas de la cuenta, un elemento por lista, y con eso el flujo obtiene la correspondencia entre el nombre de una lista y su identificador.

• Return All: activado, n8n pide las páginas siguientes hasta la última lista. Desactivado, Limit decide cuántas listas devuelve el nodo.

Añade una persona, una organización o una oportunidad que ya existen a una lista. Es la operación que mete de verdad una ficha en un embudo.

• List Name or ID: elige la lista en el desplegable que n8n carga desde la cuenta, o pasa un identificador con una expresión.
• Entity ID: el identificador único de la entidad (persona, organización u oportunidad) que se añade, normalmente {{ $json.id }} del nodo que acaba de crearla.
• Creator ID: una persona con acceso a Affinity, registrada como autora del alta. Vacío, queda el propietario de la clave API.

Quita una entrada de una lista. La persona o la organización siguen en Affinity, lo único que desaparece es su pertenencia a esa lista.

• List Name or ID: la lista que contiene la entrada, elegida en el desplegable o pasada como identificador.
• List Entry ID: el identificador único de la entrada que se va a borrar, que no es el de la empresa ni el de la persona.

Consulta una entrada concreta y devuelve lo que Affinity guarda de ella, en lugar de recorrer la lista entera para encontrarla.

• List Name or ID: la lista que contiene la entrada buscada.
• List Entry ID: el identificador único de la entrada que se quiere recuperar.

Recorre una lista y devuelve sus entradas como elementos separados, uno por entrada, listos para un bucle o una escritura en bloque.

• List Name or ID: la lista cuyas entradas se quieren recuperar.
• Return All: activado para un export completo. Desactivado, Limit pone techo al número de entradas devueltas, que es lo que conviene mientras pruebas.

Crea una empresa en Affinity y la devuelve con su identificador, el valor que necesitarán todas las operaciones posteriores sobre esa empresa.

• Name: el nombre de la organización.
• Domain: su nombre de dominio, el campo que conviene normalizar antes, porque un prefijo de más crea un duplicado en vez de un enlace.
• Person Names or IDs: las personas asociadas a la nueva organización, elegidas en la lista o pasadas por identificador.

Borra la ficha de una empresa en Affinity. Todo lo que el equipo había colgado de ella se va con la ficha, así que esta operación va detrás de una condición y no suelta en medio del flujo.

• Organization ID: el identificador único de la organización, ni su nombre ni su dominio.

Lee una empresa por su identificador y devuelve su ficha, con una opción que cambia cuánto contexto viene de vuelta.

• Organization ID: el identificador único de la organización.
• With Interaction Dates: activado, las fechas de interacción vienen en el recurso devuelto, y eso es lo que permite al flujo razonar sobre cuánto tiempo lleva callada la cuenta.

Busca en el lado de empresas de la agenda y devuelve un elemento por organización encontrada.

• Term: una cadena que busca en todas las organizaciones de la agenda del equipo, por ejemplo una dirección de correo, un nombre o un apellido.
• Return All: activado para traerlo todo, desactivado para pararse en Limit.
• With Interaction Dates: añade las fechas de interacción a cada organización devuelta.

Actualiza una empresa que ya está en Affinity. Solo se envían los campos que rellenas, así que el flujo corrige un dato sin tocar el resto de la ficha.

• Organization ID: el identificador único de la organización que se modifica.
• Name y Domain: el nombre y el dominio nuevos cuando cambia alguno de los dos.
• Person Names or IDs: las personas asociadas a la organización.

Registra un contacto nuevo en Affinity y devuelve la ficha creada, lista para engancharla a una lista o a una empresa.

• First Name y Last Name: los dos son obligatorios y los dos bloquean, porque un campo obligatorio vacío impide que el nodo se ejecute.
• Emails: las direcciones de correo de la persona, con el formato info@example.com.
• Organization Names or IDs: las organizaciones a las que se asocia la persona.

Elimina un contacto de Affinity a partir de su identificador. Operación corta, efecto definitivo: va al final de una rama que ya ha comprobado algo.

• Person ID: el identificador único de la persona, el valor que devuelve una lectura o que trae un evento del trigger.

Trae un contacto y lo que Affinity sabe de él, en un solo elemento que el nodo siguiente lee campo por campo.

• Person ID: el identificador único de la persona.
• With Interaction Dates: activado, las fechas de interacción vuelven con la ficha, que es la diferencia entre saber que el contacto existe y saber si alguien ha hablado con él.

Barre el lado de contactos de la agenda y devuelve un elemento por persona, punto de partida de cualquier export o auditoría.

• Term: una cadena que busca en todas las personas de la agenda del equipo, por ejemplo una dirección de correo, un nombre o un apellido.
• Return All: activado para encadenar páginas hasta el final, desactivado para pararse en Limit.
• With Interaction Dates: añade las fechas de interacción a cada persona devuelta.

Ajusta un contacto existente. Lo que dejas vacío se queda como está en Affinity, y eso hace que la operación sea segura para ejecutarla de forma periódica contra una fuente de referencia.

• Person ID: el identificador único de la persona que se modifica.
• Emails: las direcciones de correo de la persona, útiles cuando cambia de empresa.
• First Name, Last Name y Organization Names or IDs: los campos de identidad y de vínculo, actualizados solo si los rellenas.