Importación de contactos
Incorpore a su audiencia actual a Kagibag. Importe contactos de archivos CSV, exportaciones HubSpot o API, y el sistema manejará automáticamente el mapeo de campos, la deduplicación y la resolución de identidad.
Importar fuentes
| Fuente | como funciona | Lo mejor para |
|---|---|---|
| CSV subir | Cargue cualquier archivo CSV y asigne columnas a los campos de contacto en el navegador. | Importaciones únicas |
| HubSpot exportar | Cargue un CSV exportado desde HubSpot. Los encabezados de columna se detectan y asignan automáticamente. | Migrando desde HubSpot |
| API importar | Envíe contactos como JSON a través del servidor MCP o REST API. | Importaciones automatizadas o recurrentes |
Iniciar una importación CSV
Navegue hasta Administrador, luego Contactos y luego Importar. Sube tu archivo CSV. El sistema lee los encabezados de los archivos y muestra una pantalla de mapeo de columnas. Cada columna se puede asignar a un campo de contacto estándar o se puede omitir. Haga clic en Importar para comenzar a procesar.
Mapeo de campo
Campos estándar disponibles para mapeo. Los alias de columna (como "Dirección de correo electrónico" o "Nombre") se reconocen automáticamente.
| campo | Requerido | Descripción |
|---|---|---|
| correo electrónico | si | La dirección de correo electrónico del contacto. |
| first_name | No | Nombre o nombre de pila |
| last_name | No | Apellido o apellido |
| empresa | No | Nombre de la organización o empresa |
| título | No | Título de trabajo o función |
| telefono | No | Número de teléfono |
Procesamiento de importación
Las importaciones se ejecutan de forma asincrónica en segundo plano. Cada fila se procesa individualmente para que una sola fila incorrecta no bloquee el resto.
| Estado | Descripción |
|---|---|
| subido | Archivo recibido, esperando para comenzar. |
| Analizando | El sistema está leyendo y validando filas. |
| Procesamiento | Las filas se emparejan, deduplican y enriquecen. |
| Procesado | Todas las filas se manejaron correctamente. |
| error | Error en una o más filas: revise los detalles del error. |
Resolución de identidad
Cada correo electrónico importado se normaliza (en minúsculas, sin espacios en blanco) y se compara con los contactos existentes. Si se encuentra una coincidencia, el perfil de contacto existente se actualiza con cualquier información nueva. Si no existe ninguna coincidencia, se crea un nuevo perfil de contacto. Esto evita duplicados al importar la misma lista varias veces.
Revisando resultados
Una vez que se completa el procesamiento, el resumen de importación muestra el total de filas procesadas, cuántos contactos existentes coinciden, cuántos contactos nuevos creados y cuántos tuvieron errores. Haga clic en filas individuales para ver los detalles del error o el perfil de contacto resuelto.
Usar contactos importados
Una vez importados, los contactos están disponibles en todo Kagibag. Úsalos para:
- Enviar invitaciones para eventos solo por invitación
- Incluirlos en campañas de marketing automáticas
- Segmentarlos en audiencias específicas
Los contactos se enriquecen con el tiempo con datos adicionales de sus interacciones.
API importaciones
Utilice el servidor MCP import_contacts herramienta para importar contactos mediante programación. Envíe una matriz JSON de objetos de contacto con campos de correo electrónico, nombre, apellido, empresa y título. El API devuelve una respuesta 202 con un ID de importación. Encuesta check_import_status con esa identificación para seguir el progreso.
[
{ "email": "[email protected]", "first_name": "Jane", "last_name": "Doe", "company": "Acme" },
{ "email": "[email protected]", "first_name": "John", "last_name": "Smith" }
]