Ir al contenido principal
Guías de plataformas DeepAgent

Gestor de contactos: cómo utilizarlo correctamente

Guía paso a paso para la sección «Contactos» de DeepAgent: cómo crear, importar, organizar y analizar los contactos a los que tus agentes de voz llamarán o de los que recibirán llamadas.

Escrito por Product

Última actualización Hace 3 meses

1. Introducción

La sección «Contactos» es el CRM integrado de DeepAgent: contiene todos los números de teléfono y las personas con las que interactúan tus agentes de voz, tanto en llamadas entrantes como salientes.

Desde aquí puedes:

  • Mantener un registro único y ordenado de todos tus contactos.

  • Importar de forma masiva tus clientes potenciales desde un archivo CSV.

  • Organizar los contactos mediante etapas, etiquetas y listas.

  • Ver el historial completo de llamadas de cada persona.

  • Decidir qué agente puede (o no puede) llamar a un contacto concreto.


2. Acceso a la sección «Contactos»

  1. Inicia sesión en DeepAgent con tus credenciales.

  2. En el menú lateral de la izquierda, haz clic en «Contactos».

  3. Se te redirigirá a la URL /dashboard/contacts.

⚠️ Esta sección está disponible en las cuentas con el módulo CRM activo. Si no ves esta opción en el menú, ponte en contacto con el servicio de asistencia.


3. Descripción general de la interfaz

Al abrir la página, encontrarás:

  • Encabezado con el título «Contactos» y la ruta de navegación.

  • Pestañas «Contactos» y «Listas» en la parte superior.

  • Barra de búsqueda para buscar por nombre, teléfono, correo electrónico o empresa.

  • Botón «Filtros» que abre el panel lateral.

  • Alternar vista: Tabla ↔︎ Kanban.

  • Botón «Importar» (CSV).

  • Botón «+ Añadir contacto».


4. Crear un contacto

  1. Haz clic en el botón «+ Añadir contacto» situado en la parte superior derecha.

  2. Se abrirá un cuadro de diálogo con los siguientes campos:

Campo obligatorio Notas

Nombre

No

Apellidos

No

Teléfono

✅ Sí

Selector de país (por defecto, Italia 🇮🇹), formato E.164

Correo electrónico

No

Validado

Empresa

No

Prácticas

No

Por defecto: Nuevo

Etiquetas

No

Múltiples, se pueden crear sobre la marcha

Campos personalizados

No

Editor de clave-valor

  1. Haz clic en «Guardar»: el contacto aparecerá inmediatamente en la tabla.

💡 Consejo: el número de teléfono se normaliza automáticamente al formato internacional (p. ej., +39...). Si introduces un número sin prefijo, se utilizará el país seleccionado.


5. Importar contactos desde un archivo CSV

La importación desde CSV es la forma más rápida de cargar grandes cantidades de clientes potenciales.

Paso 1 — Abrir el asistente

  1. Haz clic en «Importar» en la barra superior.

  2. Se abrirá un panel lateral (hoja) a la derecha.

Paso 2 — Subir el archivo

  1. Arrastra el archivo CSV a la zona de depósito o haz clic para seleccionarlo.

  2. Elige el separador: coma , (por defecto) o punto y coma ;.

  3. Se muestra una vista previa de las primeras filas.

Paso 3 — Asignación de columnas

Asigna cada columna del CSV a un campo de DeepAgent:

  • firstName (obligatorio)

  • lastName

  • phone (obligatorio)

  • email

  • company

  • customField (para datos adicionales que se convertirán en campos personalizados)

  • Omitir (para las columnas que no quieras importar)

Paso 4 — Configuración general

Establece para todos los contactos importados:

  • Fase (por defecto: Nuevo).

  • Etiquetas comunes (p. ej., «import-gennaio-2026»).

Paso 5 — Importación y resultados

  1. Haz clic en «Iniciar importación».

  2. Una barra de progreso muestra el avance en tiempo real.

  3. Una vez finalizado, verás:

    • ✅ Importados

    • ⚠️ Duplicados omitidos (contactos con el mismo número de teléfono o correo electrónico ya existentes)

    • ❌ Errores (con línea y motivo)

💡 Puedes cancelar una importación en curso con el botón «Cancelar».


6. Modificar un contacto

Hay dos formas de modificar un contacto:

A) Edición rápida desde la tabla

  1. En la tabla, haz clic en el icono ✏️ (lápiz) de la columna «Acciones».

  2. Se abrirá un cuadro de diálogo con los campos ya rellenados.

  3. Realiza los cambios y haz clic en Guardar.

B) Edición completa desde la ficha de detalle

  1. Haz clic en la fila del contacto para abrir su página de detalles.

  2. En el panel de la izquierda, haz clic en «Editar».

  3. Todos los campos se pueden editar directamente en la página.


7. Eliminar contactos

⚠️ Atención: la eliminación es definitiva e irreversible.

  1. En la tabla, haz clic en los tres puntos (⋯) de la columna Acciones → Eliminar.

  2. Confirma en el cuadro de diálogo que muestra el nombre y el teléfono del contacto.

Para eliminar varios contactos a la vez, consulta «Acciones múltiples (en bloque)».


8. Búsqueda y filtros

Búsqueda de texto

La barra de búsqueda de la parte superior busca simultáneamente en: Nombre, Apellidos, Teléfono, Correo electrónico y Empresa.

Panel de filtros

Haz clic en «Filtros» para abrir el panel lateral y combinar los siguientes criterios:

Filtro Tipo Notas

Prácticas

Casillas de selección múltiples

Nuevo, Sin respuesta, Inalcanzable, Éxito, Fallido

Etiquetas

Casillas de selección múltiples con búsqueda

Listas

Selección múltiple

Máximo 5 listas a la vez

Último contacto

Intervalo de fechas

Preajustes: Hoy, 7 días, 30 días, 90 días

Fecha de creación

Intervalo de fechas

Preajuste: Hoy, 7 días, 30 días, 90 días

Fuente

Menú desplegable

Importación CSV, Entrantes, Salientes, Manual, Campaña, Relleno

Los filtros se pueden combinar (operador «AND»). Haz clic en «Borrar» para restablecerlos.


9. Vista de tabla frente a vista Kanban

En la esquina superior derecha encontrarás un botón con dos iconos:

Vista de tabla (predeterminada)

Muestra las columnas: Nombre | Teléfono | Correo electrónico | Empresa | Fase | Etiquetas | Último contacto | Acciones.

Vista Kanban (tablero)

Muestra 5 columnas, una por cada etapa. Cada contacto es una tarjeta.

  • Arrastra y suelta una tarjeta entre columnas para cambiar de etapa al instante.

  • La ficha muestra el nombre, el teléfono y las etiquetas principales.


10. Etapas de los contactos

La etapa representa el estado del contacto en el embudo:

Fase Color Cuándo utilizarla

🟦 Nuevo

Azul

Predeterminada para los nuevos contactos a los que aún no se ha llamado

🟨 Sin respuesta

Amarillo

Se ha intentado contactar, pero el contacto no ha respondido

🟧 Ilocalizable

Naranja

Número no válido / fuera de servicio

🟩 Éxito

Verde

Resultado positivo (cliente potencial cualificado, venta, cita)

🟥 Fallido

Rojo

Resultado negativo (rechazo explícito)

La fase se actualiza automáticamente en función de los resultados de las llamadas, o bien de forma manual:

  • Desde la vista Kanban con la función de arrastrar y soltar.

  • Desde el detalle del contacto, mediante el menú desplegable «Fase».


11. Etiquetas

Las etiquetas son etiquetas personalizadas para segmentar los contactos (p. ej., vip, roma, non-richiamare).

Añadir una etiqueta

  1. Abre el detalle del contacto.

  2. En la sección «Etiquetas», haz clic en «+».

  3. Busca una etiqueta existente o escribe un nombre nuevo → la etiqueta se crea al instante.

Eliminar una etiqueta

Haz clic en la X de la ficha de la etiqueta.


12. Notas

En el panel izquierdo de los detalles del contacto encontrarás un campo de texto «Notas»:

  • Longitud máxima: 5000 caracteres.

  • Guardado automático (retardo de 2 segundos).

  • Indicador de estado: «Guardando…», «Guardado ✓», «Error».

  • El contador de caracteres aparece a partir de los 4.500.


13. Campos personalizados

DeepAgent gestiona dos tipos de campos personalizados:

Campos fijos (editables)

Definidos por ti (p. ej., partita_iva, codice_cliente). Se pueden editar desde:

  • Formulario de creación de contacto.

  • Formulario de modificación de contacto.

  • Mapeo CSV (columna mapeada como customField).

Campos recopilados por los agentes (solo lectura)

La información recopilada automáticamente por los bots durante las llamadas (p. ej., horarios de disponibilidad, preferencias de producto). Se agrupan por agente y se marcan con el icono 🤖.


14. Listas de contactos (estáticas e inteligentes)

Las listas son conjuntos de contactos que puedes utilizar en campañas salientes.

Accede desde la pestaña «Listas» en la página «Contactos», o desde /dashboard/contacts → activa «Listas».

Listas estáticas

Contactos añadidos manualmente; la lista permanece fija.

Crear una lista estática:

  1. Pestaña «Listas» → «+ Nueva lista».

  2. Introduce el nombre y la descripción.

  3. Selecciona el tipo «Estática».

  4. Añade contactos con el selector.

Listas inteligentes

Se rellenan dinámicamente según filtros (etapa, etiqueta, fuente, etc.): cada nuevo contacto que cumpla los criterios se añade automáticamente.

Crear una lista inteligente:

  1. Pestaña Listas → + Nueva lista.

  2. Selecciona el tipo «Inteligente».

  3. Define los filtros en el generador de condiciones.

  4. Guarda: la lista se actualiza en tiempo real.

Detalles de la lista

Haz clic en una lista para abrir sus detalles:

  • Tabla/Kanban de los contactos incluidos.

  • Pestaña «Readiness»: muestra qué variables de la campaña se han asignado a los contactos.

  • Botón «Añadir contactos» (solo listas estáticas).


15. Acciones múltiples (en bloque)

  1. En la tabla, marca las casillas de selección de las filas de los contactos.

  2. En la parte inferior aparecerá la barra de herramientas de acciones masivas con el número seleccionado.

  3. Acciones disponibles:

    • 📁 Crear lista (estática) con los contactos seleccionados.

    • 🏷️ Añade etiquetas a todos los seleccionados.

    • 📤 Exportar a CSV o JSON.

    • 🗑️ Eliminar en bloque (con confirmación).


16. Exportar contactos

Hay dos formas de exportar:

A) Exportar todos los contactos

Desde el menú superior → Exportar → elige CSV o JSON.

B) Exportar solo los seleccionados

Utiliza la barra de herramientas de acciones masivas (consulta «Acciones múltiples»).

El archivo descargado contiene: nombre, apellidos, teléfono, correo electrónico, empresa, etapa, etiquetas (encadenadas), fecha de creación y campos personalizados.


17. Detalles del contacto e historial de llamadas

Haz clic en una fila de la tabla para abrir la página /dashboard/contacts/[id].

Panel izquierdo: información

  • Datos personales (nombre, teléfono, correo electrónico, empresa).

  • Etapa actual (modificable).

  • Etiquetas (añadir/eliminar).

  • Notas (guardado automático).

  • Campos personalizados y grupos de campos.

  • Lista de agentes que han llamado (con posibilidad de bloquear).

Panel derecho: cronología de llamadas

Para cada llamada:

  • 📅 Fecha y hora.

  • 📞 Dirección (entrante / saliente).

  • 🎯 Resultado: Éxito / Fallo / Sin respuesta / Inalcanzable.

  • 🤖 Nombre del agente que gestionó la llamada.

  • ⏱️ DuraciónMM:SSo.

  • 📝 Resumen (resumen de la transcripción), si está disponible.

Haz clic en una ficha → se abrirá la ventana modal con la transcripción completa.

El botón «Cargar más» de la parte inferior carga las llamadas más antiguas (paginación).


18. Bloquear a un agente para un contacto

Para impedir que un agente vuelva a llamar a un contacto, abre los detalles del contacto y bloquea al agente desde la sección «Agentes». Procedimiento completo en las Preguntas frecuentes sobre contactos: Excluir o bloquear un contacto de las llamadas.

20. Preguntas frecuentes y resolución de problemas

❓ ¿Puedo recuperar un contacto eliminado? No. La eliminación es definitiva. Por seguridad, exporta siempre los contactos antes de realizar operaciones de eliminación masiva.

❓ ¿Cuántos contactos puedo importar en un único archivo CSV? No hay un límite estricto, pero en el caso de archivos muy grandes (>10 000 filas), la importación podría tardar unos minutos. La barra de progreso te muestra el estado.

❓ ¿Puedo buscar o filtrar por varias etiquetas a la vez? Sí, desde el panel «Filtros» puedes seleccionar varias etiquetas (operador «OR» dentro de la misma categoría, «AND» entre categorías diferentes).

❓ ¿Qué ocurre si cambio la etapa manualmente? La etapa permanece fijada en ese valor hasta que un evento (por ejemplo, una nueva llamada) la actualice de nuevo automáticamente.

❓ ¿Las listas inteligentes se actualizan en tiempo real? Sí, cada vez que un contacto nuevo o modificado cumple los criterios de la lista, entra (o sale) automáticamente.

21. Glosario

  • Contacto: una persona o un número de teléfono en el CRM.

  • Etapa: estado del contacto en el embudo (Nuevo, Sin respuesta, Ilocalizable, Éxito, Fallido).

  • Etiqueta: etiqueta libre para segmentar los contactos.

  • Lista estática: conjunto fijo de contactos, seleccionados manualmente.

  • Lista inteligente: conjunto dinámico de contactos, definido mediante filtros.

  • Fuente: de dónde procede el contacto (CSV, manual, entrante, saliente, campaña, backfill).

  • Campo fijo: dato personal de identificación que se puede editar manualmente.

  • Campo recopilado: dato extraído automáticamente por los agentes durante una llamada.

  • Exclusión de agente: regla que impide que un agente concreto llame a un contacto específico.

  • Integración: conexión con una fuente externa (p. ej., Google Sheets) para sincronizar contactos.