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

# Cómo traer a Contactos una lista de personas de tu sistema

> Indica en la conexión de API propia dónde está una lista de personas de tu sistema, como las ventas de un evento, para importarla a Contactos con una etiqueta.

Eva puede leer una lista de personas de tu sistema, por ejemplo las ventas de un evento, e
importarla a **Contactos** con una etiqueta. En **Contactos desde tu sistema** indicas dónde
está esa lista y qué filtros pide.

## Lo que vas a lograr

Vas a guardar, en la conexión de **API propia**, dónde entrega tu sistema una lista de personas,
sin escribir JSON. Después, quien tenga acceso a **Contactos** la importa desde **Más acciones**.

## Requisitos

* Rol de propietario o administrador en la cuenta de Eva.
* Una conexión de **API propia** ya creada en **Configuración** > **Integraciones**.
* Un ejemplo de la respuesta de tu sistema para esa lista. Pídeselo a quien administra ese sistema.

## Indica dónde está la lista

**1. Abre la conexión**

En **Configuración** > **Integraciones**, abre **API propia**. En tu conexión, abre
**Contactos desde tu sistema** y selecciona **Agregar lista**.

**2. Ponle nombre**

En **Nombre de la lista**, escribe cómo la verá tu equipo, por ejemplo `Ventas`.

**3. Escribe la ruta**

En **Ruta**, escribe la dirección de la lista en tu servidor, por ejemplo `/v1/ventas`. En
**Lista en la respuesta**, escribe el nombre del dato que trae las personas, por ejemplo `ventas`.

**4. Indica los datos de cada persona**

En **Datos de cada persona**, **Nombre** y **Teléfono** son obligatorios y **Correo** es
opcional. Usa puntos para un dato dentro de otro, por ejemplo `cliente.nombre`.

**5. Agrega los filtros**

Selecciona **Agregar filtro** por cada dato que tu sistema pide, como las fechas. En
**Nombre en tu sistema** va el nombre que espera tu sistema, y en **Cómo se ve en Eva**, el
que leerá tu equipo. Elige el **Tipo**: **Fecha**, **Texto** u **Opciones**. Con
**Opciones**, agrega cada valor con **Agregar opción**.

**6. Si la lista viene en partes**

Abre **Varias páginas**. Escribe **Siguiente página en la respuesta** y
**Parámetro de la página**, el nombre con el que tu sistema pide la siguiente.

**7. Guarda**

Selecciona **Guardar**.

Para quitar una lista, selecciona **Quitar lista** en ella y luego **Guardar**.

## Cómo saber que funcionó

Con el bloque cerrado, **Contactos desde tu sistema** resume cada lista en una línea, por
ejemplo «Ventas · /v1/ventas · 3 filtros». En **Contactos**, **Más acciones** muestra
**Desde** con el nombre de tu conexión.

## Si algo sale mal

* Un campo dice «Usa letras, números, guiones y puntos». Escribe solo el nombre del dato, con
  puntos entre niveles y cuatro niveles como máximo.
* **Ruta** dice «Escribe una ruta que empiece con /». Escribe solo la ruta, sin el dominio ni
  lo que va después de `?`. Eva agrega los filtros por su cuenta.
* El bloque dice «Eva no pudo guardar estas listas». Revisa que cada filtro tenga nombre y que
  cada filtro de **Opciones** tenga al menos una opción.
* La vista previa en **Contactos** dice que tu sistema no trae la lista configurada. Revisa que
  **Lista en la respuesta** coincida con la respuesta de tu sistema.

## Siguientes pasos

> [card] [Importa contactos desde tu sistema](https://docs.goeva.ai/es/crm/contactos.md)

> [card] [Indica dónde están las compras de un cliente](https://docs.goeva.ai/es/automatizaciones/compras-del-cliente-en-tu-sistema.md)


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