Contactos

Almacena y administra a las personas identificadas que chatean con tu agente. Los contactos se crean automáticamente a partir de la verificación de identidad, o se agregan manualmente y mediante importación de CSV.

Reserved integration fields remain read-only: instagram_username, stripe_customer_id, and source.

Un Contacto es una persona identificada que ha chateado con tu agente, a diferencia de un visitante anónimo. Cada Contacto se identifica mediante un ID externo inmutable que proviene de tu propio sistema, de modo que la misma persona se mantiene como un único Contacto en todas las sesiones y dispositivos.

Encuentra tus contactos en la pestaña Contactos de tu agente.

Qué almacena un contacto

Campo	Descripción
ID externo	El id inmutable de tu sistema (el `sub` del JWT). Único por agente.
Correo electrónico	La dirección de correo electrónico del contacto.
Nombre	El nombre visible del contacto.
Teléfono	El número de teléfono del contacto.
Atributos personalizados	Cualquier dato adicional que adjuntes (plan, empresa, ids de Stripe, …).
Visto por última vez	Se actualiza automáticamente cada vez que el contacto chatea.

Los datos de contacto se almacenan para que puedas verlos y segmentarlos. Por privacidad, nunca se inyectan en las respuestas del agente — consulta Verificación de identidad → Privacidad.

Cómo se crean los contactos

Automáticamente, desde la verificación de identidad (recomendado)

Cuando activas la verificación de identidad, tu backend firma un JWT para cada usuario que inicia sesión. La primera vez que un usuario verificado chatea, Agentkit crea un Contacto a partir de los claims del token y vincula la conversación a él. Los chats posteriores actualizan el mismo Contacto y refrescan Visto por última vez. No se necesita ninguna llamada a la API por separado.

Manualmente

Haz clic en Agregar contacto, luego ingresa un ID externo (obligatorio) más nombre, correo electrónico y teléfono opcionales. El ID externo debe ser único para el agente.

Mediante importación de CSV

Usa Importar para crear o actualizar contactos en bloque desde una hoja de cálculo — consulta más abajo.

Importar contactos mediante CSV

Haz clic en Importar y sube un archivo .csv. La primera fila debe ser una fila de encabezado. Columnas admitidas:

Columna	Obligatoria	Notas
`external_id`	Sí	ID único por contacto. Las filas que no lo tengan se omiten.
`name`	No	Hasta 255 caracteres.
`email`	No	Hasta 320 caracteres.
`phone`	No	Hasta 50 caracteres.

external_id,name,email,phone
import-001,Alice Imported,[email protected],+1 555 000 0001
import-002,Bob Imported,[email protected],+1 555 000 0002

Usa el enlace Descargar plantilla CSV en el cuadro de diálogo de importación para obtener un archivo de partida.

Límites y comportamiento:

Tamaño máximo de archivo 5 MB; hasta 10,000 filas por importación.
Si un external_id ya existe, la fila actualiza ese contacto en lugar de crear un duplicado.
Después de la importación verás cuántos contactos se procesaron y cuántos se omitieron.

Buscar contactos

La tabla de Contactos admite:

Búsqueda por ID externo, correo electrónico, nombre y teléfono.
Paginación para listas de contactos extensas.
Un interruptor de Columnas para mostrar u ocultar columnas.